canonical: https://jentic.com/apis/apidirect.io/apidirect # API Direct The API Direct API returns real-time public data from LinkedIn, Twitter/X, Reddit, YouTube, Instagram, TikTok, Facebook, Threads, Bluesky, and Truth Social, plus Google Search, Google Maps places, news sites, forums, Amazon, and Trustpilot, all behind one REST interface and one API key. It exposes search endpoints for posts, users, and companies on each platform alongside detail endpoints for individual profiles, posts, comments, and reviews. A single batch endpoint groups several lookups into one request. ## For AI agents Fetch public social, search, places, and marketplace data across more than a dozen platforms from one key: search posts and profiles, read user and post details, and pull reviews and comments. Reads are GET with query parameters authenticated by an X-API-Key header. ## Scope Does not post content, run ads, or manage social accounts. Use for reading public social, search, places, and marketplace data only. ## Capabilities - Search public posts across Twitter, LinkedIn, Reddit, Instagram, TikTok, and Bluesky from one key - Pull a person's or company's LinkedIn profile along with their recent posts and jobs - Read Instagram, YouTube, and TikTok user profiles, posts, followers, and comments - Run Google web search and AI Mode queries and read the results - Look up Google Places details, reviews, and photos for a business - Search Amazon products and read seller profiles, best sellers, and reviews - Read Trustpilot company reviews and browse category rankings ## Use cases ### Cross-Platform Brand Monitoring An agent watches how a brand is discussed in public by searching posts across Twitter, Reddit, Instagram, and TikTok, then pulling the Trustpilot reviews for the company. API Direct returns each platform's results through one key, so the agent gathers mentions from many sources without wiring a separate scraper for each. Example prompt: Call GET `/v1/twitter/posts` and GET `/v1/reddit/posts` for a brand term, then GET `/v1/trustpilot/company/reviews` to pull its review sentiment ### Lead and Company Research A research workflow enriches a target account by reading its LinkedIn company profile and recent posts, then searching for the people who work there. Because API Direct covers LinkedIn person and company endpoints behind the same key, the agent builds a company snapshot in a single pass. Example prompt: Call GET `/v1/linkedin/company` for a company, then GET `/v1/linkedin/company/posts` to read its recent activity ### Local Business Intelligence An agent assembles a profile of a local business by searching Google Places, reading its place details and reviews, and pulling its Facebook page reviews. API Direct returns places and social data from the same interface, so the agent compiles ratings and recent feedback without stitching together multiple vendors. Example prompt: Call GET `/v1/places/search` for a business, then GET `/v1/places/reviews` to read its recent ratings ### AI Agent Integration via Jentic An AI agent reaches API Direct through Jentic without holding the API key itself. It searches by intent, receives the matching platform operation with its input schema, and executes the call with the credential injected at run time, so public-data lookups slot into a larger agent workflow. Example prompt: Search Jentic for 'search twitter posts', load the GET `/v1/twitter/posts` schema, and execute it with Jentic-managed credentials ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/v1/twitter/posts` | Search Twitter posts | | GET | `/v1/linkedin/person` | LinkedIn person profile | | GET | `/v1/instagram/user/posts` | Instagram user posts | | GET | `/v1/reddit/posts` | Search Reddit posts | | GET | `/v1/web/search` | Google web search | | GET | `/v1/places/search` | Search Google Places | | GET | `/v1/amazon/products` | Search Amazon products | | GET | `/v1/trustpilot/company/reviews` | Trustpilot company reviews | ## Key resources - **Social Platforms** — Search and read posts, users, and comments on Twitter, LinkedIn, Reddit, Instagram, TikTok, Facebook, Threads, and Bluesky - **Web and Places** — Run Google web search and AI Mode queries and read Google Places details, reviews, and photos via `/v1/web/search` and `/v1/places/search` - **Marketplaces** — Search Amazon products and sellers and read Trustpilot company reviews via `/v1/amazon/products` and `/v1/trustpilot/company/reviews` ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 64 / 100 - **Maturity:** AI-Aware - **Dimensions:** - Foundational Compliance: 92 / 100 - Developer Experience & Jentic Compatibility: 70 / 100 - AI-Readiness & Agent Experience: 45 / 100 - Agent Usability: 83 / 100 - Security: 50 / 100 - AI Discoverability: 90 / 100 - **View full report:** https://jentic.com/apis/apidirect.io/apidirect/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring API Direct by hand means managing one X-API-Key across more than a dozen platform namespaces and handling per-endpoint pricing yourself. Through Jentic you install once, import API Direct from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** API Direct carries the platform, handle, and search term inside each request, so a rule bounds which operations your agent may call rather than which account it reads. You choose the operations it may use, such as the Twitter and Reddit search endpoints, so marketplace or places lookups are not included unless you add them. - **Credential handling:** Your API Direct key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'search twitter posts' or 'read a linkedin company profile', and Jentic returns the matching API Direct operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Bright Data** — Web scraping and data-collection platform with proxy infrastructure - **ScraperAPI** — Proxy and rendering layer for scraping any web page - **SerpApi** — Structured search-engine results across Google, Bing, and others ## FAQ ### What authentication does the API Direct API use? The API Direct API authenticates with an API key sent in the X-API-Key header on every request, per its OpenAPI spec. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at execution time, so it never reaches the agent. ### Can I search posts across multiple social platforms with the API Direct API? Yes. Each platform has its own search endpoint, such as GET `/v1/twitter/posts`, GET `/v1/reddit/posts`, and GET `/v1/instagram/posts`, and they all use the same key. A batch endpoint groups several lookups into one request when you need results from more than one platform at once. ### What are the rate limits for the API Direct API? API Direct is priced per request with a monthly free tier on every endpoint rather than a fixed rate ceiling, and the OpenAPI spec does not state request limits. Watch for HTTP 429 responses and check the API Direct pricing documentation for the per-endpoint allowances that apply to your plan. ### How do I search Twitter posts with the API Direct API through Jentic? Search Jentic for 'search twitter posts', and it returns the API Direct operation with its input schema. Load the schema and execute GET `/v1/twitter/posts` with the credential injected at run time. To run it on your own infrastructure, install Jentic One from its GitHub repo. ### Is there an API Direct MCP server? You don't need an MCP server to give your agent API Direct. Jentic connects it directly from the API Directory: import it, store your key once, and your agent calls the platform operations it needs. Operations are discovered on demand, so no extra server's tool definitions sit in the agent's context. ### Can I limit what my agent is allowed to do with the API Direct API? Yes. API Direct carries the platform and query inside the request, so a rule bounds which operations your agent may call rather than which handle it reads. Allow only the lookups the task needs, such as the Twitter and Reddit search operations, and every call runs through your own instance where it is logged for review.