canonical: https://jentic.com/apis/konbiniapi.com/konbiniapi # KonbiniAPI The KonbiniAPI reads public social media data from Instagram, TikTok, X, Reddit, and LinkedIn and returns it in one consistent ActivityStreams 2.0 format. It fetches user profiles, posts, reels, videos, comments and replies, followers, communities, subreddits, and company pages, searches content and users on each network, and lists trending TikTok videos and Instagram reels. It also returns TikTok and LinkedIn video transcripts and TikTok download URLs, and every successful request costs one credit, reported in the X-Credits-Remaining and X-Credits-Used headers. ## For AI agents Read public profiles, posts, comments, and trends from Instagram, TikTok, X, Reddit, and LinkedIn in one ActivityStreams 2.0 format, and search content and users on each network. ## Scope Does not publish posts, send messages, or manage social accounts. Use for reading public Instagram, TikTok, X, Reddit, and LinkedIn data only. ## Capabilities - Read a user's profile and posts on Instagram, TikTok, X, Reddit, or LinkedIn by username - Search TikTok, Instagram, and Reddit content and users by query, with order and published filters on TikTok - Pull comments and comment replies on TikTok videos, Instagram posts, and Reddit posts - Get the transcript of a TikTok video in a chosen language or of a LinkedIn post video - List trending TikTok videos by region and trending Instagram reels - Read subreddit posts, comments, rules, and sticky posts, and fetch Reddit posts, comments, or subreddits in batch by entityIds - Read LinkedIn company pages and their posts, and X communities with their posts and media ## Use cases ### AI agent social listening through Jentic A brand-monitoring agent searches Jentic for 'search Reddit posts', loads the KonbiniAPI Reddit search operation with its input schema, and queries for the brand name over a chosen time window. Because every network returns the same ActivityStreams 2.0 shape, the agent can run the same query on TikTok and Instagram and merge the results. Your own Jentic One instance injects the API key at call time. Example prompt: Call GET `/v1/reddit/search/posts` with q 'acme widgets' and time 'week', then GET `/v1/tiktok/search/videos` with query 'acme widgets', and summarise the top results ### Creator research across platforms A marketing team vetting creators reads each candidate's profile and recent posts on TikTok and Instagram, checks follower lists, and reads comments to gauge audience reaction, with all results normalised so they can be compared side by side. Example prompt: Call GET `/v1/tiktok/users/{username}` and GET `/v1/tiktok/users/{username}/videos` with count 20, then GET `/v1/instagram/users/{username}/posts` for the same creator ### Video transcripts for content analysis A research workflow pulls the spoken content from short videos. KonbiniAPI returns the transcript of a TikTok video for a given language and the transcript of a LinkedIn post video, so an agent can summarise or classify videos without downloading and transcribing them itself. Example prompt: Call GET `/v1/tiktok/videos/{videoId}/transcripts/{language}` with language 'en-US' and summarise the transcript ### Community and subreddit tracking A community manager tracks discussion in a set of subreddits: subreddit posts and comments over a time window, sticky posts and rules, and batch lookups of known posts or comments by their entityIds. Example prompt: Call GET `/v1/reddit/subreddits/{subreddit}/posts` with order 'top' and time 'day', then POST `/v1/reddit/posts/batch` with the entityIds of posts to refresh ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/v1/tiktok/users/{username}/videos` | Get TikTok user videos | | GET | `/v1/tiktok/videos/{videoId}/transcripts/{language}` | Get TikTok video transcript | | GET | `/v1/tiktok/trending/videos` | Get trending TikTok videos | | GET | `/v1/instagram/users/{username}/posts` | Get Instagram user posts | | GET | `/v1/instagram/posts/{postId}/comments` | Get Instagram post comments | | GET | `/v1/reddit/search/posts` | Search Reddit posts | | GET | `/v1/x/users/{username}/posts` | Get X user posts | | GET | `/v1/linkedin/companies/{company}/posts` | Get LinkedIn company posts | ## Key resources - **TikTok** — Users, videos, comments, transcripts, tags, audios, collections, search, and trending videos - **Instagram** — Users, posts, reels, tagged posts, highlights, comments, locations, search, and trending reels - **Reddit** — Users, subreddits, posts, comments, feeds, search, and batch lookups - **X** — Users, posts, highlights, and communities - **LinkedIn** — User profiles, articles, posts, company pages, and post video transcripts ## 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:** 68 / 100 - **Maturity:** AI-Aware - **Dimensions:** - Foundational Compliance: 62 / 100 - Developer Experience & Jentic Compatibility: 74 / 100 - AI-Readiness & Agent Experience: 55 / 100 - Agent Usability: 91 / 100 - Security: 60 / 100 - AI Discoverability: 84 / 100 - **View full report:** https://jentic.com/apis/konbiniapi.com/konbiniapi/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 KonbiniAPI by hand means sending the bearer key, following cursor pagination on each network, and watching the X-Credits-Remaining header as you go. Through Jentic you install once, import KonbiniAPI from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** KonbiniAPI puts the network and the target in the URL path (`/v1/reddit/subreddits/{subreddit}`, `/v1/tiktok/users/{username}`), so a rule can pin your agent to one subreddit or one creator and the operations you pick. You choose the operations it may call, so networks and searches you have not picked are not included unless you add them. - **Credential handling:** Your KonbiniAPI 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 'get a TikTok creator's videos' or 'search Reddit posts', and Jentic returns the matching KonbiniAPI operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Reddit API** — Reddit's own API for reading and posting - **TikTok API** — TikTok's official developer API - **Apify API** — Platform for running web scrapers and automation actors ## FAQ ### What authentication does the KonbiniAPI use? The KonbiniAPI authenticates with a bearer token per its OpenAPI spec: send your API key in the Authorization header as Bearer . Through Jentic the key is stored encrypted by your own Jentic One instance and injected at execution time. ### How does KonbiniAPI billing work? Each successful request costs one credit, and every authenticated response carries X-Credits-Remaining and X-Credits-Used headers. Requests that fail with a bad request, a server error, or an upstream error are refunded and report X-Credits-Used as 0. ### What are the rate limits for the KonbiniAPI? The OpenAPI spec does not specify rate limits; usage is metered in credits instead. Check the KonbiniAPI documentation at https://docs.konbiniapi.com for current limits. ### Is there a KonbiniAPI MCP server? You don't need an MCP server to give your agent the KonbiniAPI. Jentic connects it directly from the API Directory: import it, store your credential once, and your agent calls the TikTok, Instagram, X, Reddit, and LinkedIn operations on demand without loading another server's tool definitions into its context. ### Can I limit what my agent is allowed to do with the KonbiniAPI? Yes. For example, write a rule that allows only the Reddit operations under `/v1/reddit/subreddits/{subreddit}` for r/yourproduct, so the agent can read that community and nothing else, which also caps the credits it can spend. Every call it makes through your instance is logged. ### How do I get a TikTok video transcript through Jentic? Search Jentic for 'get a TikTok transcript', load the KonbiniAPI transcript operation, and call GET `/v1/tiktok/videos/{videoId}/transcripts/{language}` with the video id and a language. To run it on your own infrastructure, install Jentic One from its GitHub repo. ### Can the KonbiniAPI post or reply on social networks? No. Every operation reads public data; the only POST operations are Reddit batch lookups of subreddits, posts, and comments by entityIds.