# KonbiniAPI Docs

> KonbiniAPI documentation — a REST API that normalizes Instagram and TikTok data into clean, consistent JSON using the ActivityStreams 2.0 standard.

## Docs

- [Changelog](https://docs.konbiniapi.com/changelog.md): KonbiniAPI changelog — product updates, new endpoints, and platform announcements. Stay up to date with the latest changes to the API.
- [Authentication](https://docs.konbiniapi.com/getting-started/authentication.md): Learn how to authenticate with KonbiniAPI using Bearer tokens. Get your API key from the dashboard and include it in the Authorization header.
- [Credits](https://docs.konbiniapi.com/getting-started/credits.md): Learn how KonbiniAPI credits and billing work. One request equals one credit, no multipliers. Failed requests are automatically refunded.
- [Errors](https://docs.konbiniapi.com/getting-started/errors.md): KonbiniAPI error codes and response format. Machine-readable error codes with human-readable messages for every failure scenario.
- [Pagination](https://docs.konbiniapi.com/getting-started/pagination.md): Navigate through large result sets with cursor-based pagination. Learn how to use next page tokens to retrieve all results from KonbiniAPI endpoints.
- [Quickstart](https://docs.konbiniapi.com/getting-started/quickstart.md): Get started with KonbiniAPI in under a minute. Create an account, grab your API key, and make your first request to fetch social media data.
- [Response format](https://docs.konbiniapi.com/getting-started/response-format.md): Understand how KonbiniAPI responses are structured using the W3C ActivityStreams 2.0 standard. Consistent JSON shape across Instagram and TikTok.
- [What is KonbiniAPI?](https://docs.konbiniapi.com/index.md): KonbiniAPI gives you unified access to Instagram and TikTok data — via a REST API for developers, or MCP for AI agents and automation tools without any code.
- [Instagram API](https://docs.konbiniapi.com/reference/api/instagram.md): Use the Instagram API to fetch users, posts, reels, comments, highlights, locations, and search results in a consistent format.
- [Get highlight stories](https://docs.konbiniapi.com/reference/api/instagram/get-highlight-stories.md): Returns all story items within a highlight reel, including images and videos. The highlight ID comes from the highlights list endpoint.
- [Get post comments](https://docs.konbiniapi.com/reference/api/instagram/get-post-comments.md): Returns top-level comments on an Instagram post. Fixed page size of 15 (platform limit). Includes comment text, author info, like counts, and timestamps.
- [Get post details](https://docs.konbiniapi.com/reference/api/instagram/get-post-details.md): Returns details for a single post by its shortcode, including media, captions, and engagement counts. Supports photos, videos, and carousels.
- [Get posts by location](https://docs.konbiniapi.com/reference/api/instagram/get-posts-by-location.md): Returns recent posts tagged at a location. Fixed page size of 21 (platform limit). The location ID is a numeric Facebook Places ID.
- [Get user posts](https://docs.konbiniapi.com/reference/api/instagram/get-user-posts.md): Returns a paginated list of posts from an Instagram user's profile feed. Maximum 12 posts per page. Includes photos, videos, carousels, and engagement counts.
- [Get user profile](https://docs.konbiniapi.com/reference/api/instagram/get-user-profile.md): Returns profile information for an Instagram user including bio, follower counts, profile picture, and account metadata. Look up any public Instagram account by username.
- [Get user reels](https://docs.konbiniapi.com/reference/api/instagram/get-user-reels.md): Returns a paginated list of reels from an Instagram user's profile. Maximum 12 reels per page. Includes video URLs, captions, and engagement counts.
- [Get user story highlights](https://docs.konbiniapi.com/reference/api/instagram/get-user-story-highlights.md): Returns the list of story highlight reels on a user's profile. Use the highlight endpoint to get individual stories within a highlight.
- [Get user tagged posts](https://docs.konbiniapi.com/reference/api/instagram/get-user-tagged-posts.md): Returns Instagram posts where the user has been tagged by other accounts. Maximum 12 posts per page. Includes full post details and engagement counts.
- [Search media](https://docs.konbiniapi.com/reference/api/instagram/search-media.md): Searches Instagram for reels and videos matching a keyword. Maximum 24 results per page. Returns video details including captions and engagement counts.
- [API overview](https://docs.konbiniapi.com/reference/api/overview.md): KonbiniAPI normalizes Instagram and TikTok data into a consistent ActivityStreams 2.0 format. 30 endpoints for profiles, posts, comments, search, and more.
- [TikTok API](https://docs.konbiniapi.com/reference/api/tiktok.md): Use the TikTok API to fetch users, videos, comments, audios, tags, collections, search results, live streams, and transcripts in a consistent format.
- [Get audio details](https://docs.konbiniapi.com/reference/api/tiktok/get-audio-details.md): Returns metadata for a TikTok audio track including title, artist, duration, usage count, and cover image. Look up any sound by its audio ID.
- [Get collection videos](https://docs.konbiniapi.com/reference/api/tiktok/get-collection-videos.md): Returns a paginated list of videos in a TikTok collection (playlist or mix). Maximum 35 per page. Includes full video details and engagement counts.
- [Get comment replies](https://docs.konbiniapi.com/reference/api/tiktok/get-comment-replies.md): Returns a paginated list of replies to a TikTok comment. Maximum 50 per page. Includes author info, like counts, and reply timestamps.
- [Get user collections](https://docs.konbiniapi.com/reference/api/tiktok/get-user-collections.md): Returns a paginated list of video collections (playlists and mixes) on a TikTok user's profile. Includes collection name, cover image, and video count.
- [Get user followers list](https://docs.konbiniapi.com/reference/api/tiktok/get-user-followers-list.md): Returns a paginated list of accounts following a TikTok user. Maximum 30 per page. Includes profile details for each follower account.
- [Get user following list](https://docs.konbiniapi.com/reference/api/tiktok/get-user-following-list.md): Returns a paginated list of accounts a TikTok user follows. Maximum 30 per page. Includes profile details for each followed account.
- [Get user liked videos](https://docs.konbiniapi.com/reference/api/tiktok/get-user-liked-videos.md): Returns a paginated list of videos liked by a TikTok user. Note: Users may have their likes set to private, in which case an empty list will be returned.
- [Get user live stream](https://docs.konbiniapi.com/reference/api/tiktok/get-user-live-stream.md): Returns the current live stream for a user, including stream URLs and viewer count. Returns 404 if the user is not currently live.
- [Get user profile](https://docs.konbiniapi.com/reference/api/tiktok/get-user-profile.md): Returns profile information for a TikTok user including bio, follower counts, verification status, and profile picture. Look up any public TikTok account by username.
- [Get user reposts](https://docs.konbiniapi.com/reference/api/tiktok/get-user-reposts.md): Returns a paginated list of videos reposted by a TikTok user. Note: Users may have their reposts set to private, in which case an empty list will be returned.
- [Get user stories](https://docs.konbiniapi.com/reference/api/tiktok/get-user-stories.md): Returns a paginated list of active stories for a TikTok user. Stories expire after 24 hours and include both images and videos with engagement data.
- [Get user videos](https://docs.konbiniapi.com/reference/api/tiktok/get-user-videos.md): Returns a paginated list of videos from a user's profile. Supports sorting by newest, popular, or oldest. Maximum 35 videos per page.
- [Get video comments](https://docs.konbiniapi.com/reference/api/tiktok/get-video-comments.md): Returns a paginated list of top-level comments on a video. Maximum 50 per page. Use the replies endpoint to fetch threaded replies.
- [Get video details](https://docs.konbiniapi.com/reference/api/tiktok/get-video-details.md): Returns details for a single TikTok video including engagement counts, media files in multiple qualities, audio track, author info, and hashtags.
- [Get video transcript](https://docs.konbiniapi.com/reference/api/tiktok/get-video-transcript.md): Returns the transcript for a video in a specific language. Supports both auto-generated (ASR) and machine-translated subtitles. Returns WebVTT format.
- [Get videos with audio](https://docs.konbiniapi.com/reference/api/tiktok/get-videos-with-audio.md): Returns a paginated list of TikTok videos using a specific audio track. Maximum 30 per page. Discover trending content by sound or music.
- [Get videos with tag](https://docs.konbiniapi.com/reference/api/tiktok/get-videos-with-tag.md): Returns TikTok videos associated with a hashtag or challenge. The tag name is resolved to an internal ID automatically. Includes video details and engagement counts.
- [Search content](https://docs.konbiniapi.com/reference/api/tiktok/search-content.md): General search that returns mixed results including videos and user profiles. Supports sorting and publish-time filters.
- [Search users](https://docs.konbiniapi.com/reference/api/tiktok/search-users.md): Searches TikTok for user profiles matching a query. Fixed page size of 10 (platform limit). Returns profile details including follower counts and verification status.
- [Search videos](https://docs.konbiniapi.com/reference/api/tiktok/search-videos.md): Searches TikTok for videos matching a query. Supports filtering by publish time and sorting by relevance, likes, or date.
- [MCP overview](https://docs.konbiniapi.com/reference/mcp/overview.md): Use KonbiniAPI directly from AI agents and coding assistants via the Model Context Protocol. No API calls, no headers — just ask.
- [Antigravity](https://docs.konbiniapi.com/reference/mcp/setup/antigravity.md): Connect KonbiniAPI to Antigravity using the Model Context Protocol.
- [ChatGPT](https://docs.konbiniapi.com/reference/mcp/setup/chatgpt.md): Connect KonbiniAPI to ChatGPT using the Model Context Protocol.
- [Claude](https://docs.konbiniapi.com/reference/mcp/setup/claude.md): Connect KonbiniAPI to Claude and Claude Desktop using the Model Context Protocol.
- [Claude Code](https://docs.konbiniapi.com/reference/mcp/setup/claude-code.md): Connect KonbiniAPI to Claude Code using the hosted remote MCP server.
- [Cline](https://docs.konbiniapi.com/reference/mcp/setup/cline.md): Connect KonbiniAPI to Cline using the hosted remote MCP server.
- [Codex](https://docs.konbiniapi.com/reference/mcp/setup/codex.md): Connect KonbiniAPI to OpenAI Codex CLI and the Codex app using the Model Context Protocol.
- [Cursor](https://docs.konbiniapi.com/reference/mcp/setup/cursor.md): Connect KonbiniAPI to Cursor using the Model Context Protocol. Fetch social media data directly from your editor.
- [Custom agents](https://docs.konbiniapi.com/reference/mcp/setup/custom-agents.md): Connect your own AI agent or framework to KonbiniAPI via the Model Context Protocol HTTP endpoint.
- [Gemini CLI](https://docs.konbiniapi.com/reference/mcp/setup/gemini-cli.md): Connect KonbiniAPI to the Gemini CLI using the Model Context Protocol.
- [Make](https://docs.konbiniapi.com/reference/mcp/setup/make.md): Connect KonbiniAPI's hosted MCP server to Make scenarios with MCP Client.
- [n8n](https://docs.konbiniapi.com/reference/mcp/setup/n8n.md): Connect KonbiniAPI's hosted MCP server to n8n workflows and AI agents.
- [Pipedream](https://docs.konbiniapi.com/reference/mcp/setup/pipedream.md): Use KonbiniAPI's hosted MCP server from Pipedream workflows and app integrations.
- [Replit](https://docs.konbiniapi.com/reference/mcp/setup/replit.md): Connect KonbiniAPI to Replit Agent using the hosted remote MCP server.
- [VS Code](https://docs.konbiniapi.com/reference/mcp/setup/vscode.md): Connect KonbiniAPI to VS Code agent mode using the Model Context Protocol.
- [Windsurf](https://docs.konbiniapi.com/reference/mcp/setup/windsurf.md): Connect KonbiniAPI to Windsurf using the Model Context Protocol.
- [Zapier](https://docs.konbiniapi.com/reference/mcp/setup/zapier.md): Connect KonbiniAPI's hosted MCP server to Zapier using MCP Client.
- [Zed](https://docs.konbiniapi.com/reference/mcp/setup/zed.md): Connect KonbiniAPI to Zed using a custom remote MCP server.
- [instagram.get_highlight_stories](https://docs.konbiniapi.com/reference/mcp/tools/instagram/get-highlight-stories.md): Returns all story items within a highlight reel, including images and videos. The highlight ID comes from the highlights list endpoint.
- [instagram.get_location_posts](https://docs.konbiniapi.com/reference/mcp/tools/instagram/get-location-posts.md): Returns recent posts tagged at a location. Fixed page size of 21 (platform limit). The location ID is a numeric Facebook Places ID.
- [instagram.get_post](https://docs.konbiniapi.com/reference/mcp/tools/instagram/get-post.md): Returns details for a single post by its shortcode, including media, captions, and engagement counts. Supports photos, videos, and carousels.
- [instagram.get_post_comments](https://docs.konbiniapi.com/reference/mcp/tools/instagram/get-post-comments.md): Returns top-level comments on an Instagram post. Fixed page size of 15 (platform limit). Includes comment text, author info, like counts, and timestamps.
- [instagram.get_user](https://docs.konbiniapi.com/reference/mcp/tools/instagram/get-user.md): Returns profile information for an Instagram user including bio, follower counts, profile picture, and account metadata. Look up any public Instagram account by username.
- [instagram.get_user_highlights](https://docs.konbiniapi.com/reference/mcp/tools/instagram/get-user-highlights.md): Returns the list of story highlight reels on a user's profile. Use the highlight endpoint to get individual stories within a highlight.
- [instagram.get_user_posts](https://docs.konbiniapi.com/reference/mcp/tools/instagram/get-user-posts.md): Returns a paginated list of posts from an Instagram user's profile feed. Maximum 12 posts per page. Includes photos, videos, carousels, and engagement counts.
- [instagram.get_user_reels](https://docs.konbiniapi.com/reference/mcp/tools/instagram/get-user-reels.md): Returns a paginated list of reels from an Instagram user's profile. Maximum 12 reels per page. Includes video URLs, captions, and engagement counts.
- [instagram.get_user_tagged](https://docs.konbiniapi.com/reference/mcp/tools/instagram/get-user-tagged.md): Returns Instagram posts where the user has been tagged by other accounts. Maximum 12 posts per page. Includes full post details and engagement counts.
- [instagram.search_media](https://docs.konbiniapi.com/reference/mcp/tools/instagram/search-media.md): Searches Instagram for reels and videos matching a keyword. Maximum 24 results per page. Returns video details including captions and engagement counts.
- [MCP tools](https://docs.konbiniapi.com/reference/mcp/tools/overview.md): Browse the generated KonbiniAPI MCP tool reference. One typed tool exists for each supported Instagram and TikTok endpoint.
- [tiktok.get_audio](https://docs.konbiniapi.com/reference/mcp/tools/tiktok/get-audio.md): Returns metadata for a TikTok audio track including title, artist, duration, usage count, and cover image. Look up any sound by its audio ID.
- [tiktok.get_audio_videos](https://docs.konbiniapi.com/reference/mcp/tools/tiktok/get-audio-videos.md): Returns a paginated list of TikTok videos using a specific audio track. Maximum 30 per page. Discover trending content by sound or music.
- [tiktok.get_collection_videos](https://docs.konbiniapi.com/reference/mcp/tools/tiktok/get-collection-videos.md): Returns a paginated list of videos in a TikTok collection (playlist or mix). Maximum 35 per page. Includes full video details and engagement counts.
- [tiktok.get_comment_replies](https://docs.konbiniapi.com/reference/mcp/tools/tiktok/get-comment-replies.md): Returns a paginated list of replies to a TikTok comment. Maximum 50 per page. Includes author info, like counts, and reply timestamps.
- [tiktok.get_tag_videos](https://docs.konbiniapi.com/reference/mcp/tools/tiktok/get-tag-videos.md): Returns TikTok videos associated with a hashtag or challenge. The tag name is resolved to an internal ID automatically. Includes video details and engagement counts.
- [tiktok.get_user](https://docs.konbiniapi.com/reference/mcp/tools/tiktok/get-user.md): Returns profile information for a TikTok user including bio, follower counts, verification status, and profile picture. Look up any public TikTok account by username.
- [tiktok.get_user_collections](https://docs.konbiniapi.com/reference/mcp/tools/tiktok/get-user-collections.md): Returns a paginated list of video collections (playlists and mixes) on a TikTok user's profile. Includes collection name, cover image, and video count.
- [tiktok.get_user_followers](https://docs.konbiniapi.com/reference/mcp/tools/tiktok/get-user-followers.md): Returns a paginated list of accounts following a TikTok user. Maximum 30 per page. Includes profile details for each follower account.
- [tiktok.get_user_following](https://docs.konbiniapi.com/reference/mcp/tools/tiktok/get-user-following.md): Returns a paginated list of accounts a TikTok user follows. Maximum 30 per page. Includes profile details for each followed account.
- [tiktok.get_user_likes](https://docs.konbiniapi.com/reference/mcp/tools/tiktok/get-user-likes.md): Returns a paginated list of videos liked by a TikTok user. Note: Users may have their likes set to private, in which case an empty list will be returned.
- [tiktok.get_user_live](https://docs.konbiniapi.com/reference/mcp/tools/tiktok/get-user-live.md): Returns the current live stream for a user, including stream URLs and viewer count. Returns 404 if the user is not currently live.
- [tiktok.get_user_reposts](https://docs.konbiniapi.com/reference/mcp/tools/tiktok/get-user-reposts.md): Returns a paginated list of videos reposted by a TikTok user. Note: Users may have their reposts set to private, in which case an empty list will be returned.
- [tiktok.get_user_stories](https://docs.konbiniapi.com/reference/mcp/tools/tiktok/get-user-stories.md): Returns a paginated list of active stories for a TikTok user. Stories expire after 24 hours and include both images and videos with engagement data.
- [tiktok.get_user_videos](https://docs.konbiniapi.com/reference/mcp/tools/tiktok/get-user-videos.md): Returns a paginated list of videos from a user's profile. Supports sorting by newest, popular, or oldest. Maximum 35 videos per page.
- [tiktok.get_video](https://docs.konbiniapi.com/reference/mcp/tools/tiktok/get-video.md): Returns details for a single TikTok video including engagement counts, media files in multiple qualities, audio track, author info, and hashtags.
- [tiktok.get_video_comments](https://docs.konbiniapi.com/reference/mcp/tools/tiktok/get-video-comments.md): Returns a paginated list of top-level comments on a video. Maximum 50 per page. Use the replies endpoint to fetch threaded replies.
- [tiktok.get_video_transcript](https://docs.konbiniapi.com/reference/mcp/tools/tiktok/get-video-transcript.md): Returns the transcript for a video in a specific language. Supports both auto-generated (ASR) and machine-translated subtitles. Returns WebVTT format.
- [tiktok.search_content](https://docs.konbiniapi.com/reference/mcp/tools/tiktok/search-content.md): General search that returns mixed results including videos and user profiles. Supports sorting and publish-time filters.
- [tiktok.search_users](https://docs.konbiniapi.com/reference/mcp/tools/tiktok/search-users.md): Searches TikTok for user profiles matching a query. Fixed page size of 10 (platform limit). Returns profile details including follower counts and verification status.
- [tiktok.search_videos](https://docs.konbiniapi.com/reference/mcp/tools/tiktok/search-videos.md): Searches TikTok for videos matching a query. Supports filtering by publish time and sorting by relevance, likes, or date.

## OpenAPI Specs

- [openapi](https://docs.konbiniapi.com/openapi.json)