# InsightSocial API reference (/docs/api-reference) Every endpoint, one block each. Append `.md` to any `/docs/...` URL to read that page as Markdown; each block below links to its endpoint page, which has every parameter and the response. - Interactive docs: https://www.insightsocial.app/docs/api-reference - Machine-readable catalogue (public, no key): https://api.insightsocial.app/v1/endpoints - Guides index: https://www.insightsocial.app/docs/llms.txt ## Authentication Every request needs an `x-api-key` header carrying your key (it starts with `isk_`). Never put the key in the URL. Get a key at https://www.insightsocial.app/portal/api/keys. ## Base URL https://api.insightsocial.app/v1 Every data endpoint is a `GET` with query parameters. "one of (a | b)" means send at least one of them. ## Pagination List endpoints return `pagination.next_cursor`. Send it back as `cursor` and stop when `pagination.has_more` is false. See https://www.insightsocial.app/docs/pagination.md. ## Account - `GET /v1/credits`: The calling key owner's balance and this period's usage. Free. Required: (none) Markdown: https://www.insightsocial.app/docs/api-reference/account/credits.md - `GET /v1/endpoints`: This catalogue, with per-endpoint prices. Free, and needs no key. Required: (none) Markdown: https://www.insightsocial.app/docs/api-reference/account/endpoints.md ## Instagram - `GET /v1/instagram/profile`: Returns an Instagram account's public profile: bio, exact integer follower count on author.followers, following count, picture URL, verification, and author.ext.public_email from the bio. Required: handle Markdown: https://www.insightsocial.app/docs/api-reference/instagram/profile.md - `GET /v1/instagram/profile/about`: Returns Instagram's "About this account" details for a public account (country, month joined, published contact) plus its follower count and lifetime post count. Required: handle Markdown: https://www.insightsocial.app/docs/api-reference/instagram/profile-about.md - `GET /v1/instagram/profile/posts`: Returns a user's recent posts with caption, like and comment counts, media URL, media type, and timestamp; share counts are not included. Collab posts list every co-author under ext.coauthors. Required: handle Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/instagram/profile-posts.md - `GET /v1/instagram/post`: Returns one post's details: caption, view count on videos and reels, like and comment counts, media URLs, media type, the author, and any tagged users. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/instagram/post.md - `GET /v1/instagram/post/comments`: Returns a post's comments, each with its text, author, like count, reply count, and time, ranked by popularity by default or newest first. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/instagram/post-comments.md - `GET /v1/instagram/comment`: Returns one comment's current text, like count, reply count, author, and timestamp, plus the post's total comment count for context. Required: one of (comment_url | post_url) Markdown: https://www.insightsocial.app/docs/api-reference/instagram/comment.md - `GET /v1/instagram/basic-profile`: Returns a minimal Instagram profile looked up by numeric user id: username, full name, and profile picture. Required: userId Markdown: https://www.insightsocial.app/docs/api-reference/instagram/basic-profile.md - `GET /v1/instagram/profile/reels`: Returns a user's reels with view, like and comment counts and a thumbnail; share counts are not included here. Collab reels list every co-author under ext.coauthors. Required: one of (user_id | handle) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/instagram/profile-reels.md - `GET /v1/instagram/highlights`: Returns a user's saved story highlight collections, each with its title, cover image, and the number of items inside. Required: one of (user_id | handle) Markdown: https://www.insightsocial.app/docs/api-reference/instagram/highlights.md - `GET /v1/instagram/highlight/detail`: Returns the individual stories saved inside one highlight, with their media URLs, timestamps, and interaction counts. Required: id Markdown: https://www.insightsocial.app/docs/api-reference/instagram/highlight-detail.md - `GET /v1/instagram/search/reels`: Returns reels matching a keyword, each with its view count, like count, and author; share and save counts are not included on this endpoint. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/instagram/search-reels.md - `GET /v1/instagram/media/transcript`: Returns the spoken words in an Instagram video or reel of up to 2 minutes as text. A video with no speech returns 404 with reason no_speech, free of charge. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/instagram/media-transcript.md - `GET /v1/instagram/media/screen-text`: Returns the text shown on an Instagram post's images, read by AI: the photo, each carousel slide up to 10, or a reel's cover frame, with results per slide. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/instagram/media-screen-text.md - `GET /v1/instagram/user/embed`: Returns an embeddable HTML snippet for an Instagram profile, meant to be dropped into a page on your own site. Required: handle Markdown: https://www.insightsocial.app/docs/api-reference/instagram/user-embed.md - `GET /v1/instagram/audio/reels`: Returns reels that use one specific audio track, each with its engagement counts and the account that posted it. Required: audio_id Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/instagram/audio-reels.md - `GET /v1/instagram/search/hashtag`: Returns public posts carrying a hashtag, each with shortcode, URL, caption, media URLs, engagement counts, and the author; share and save counts are not included. Required: hashtag Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/instagram/search-hashtag.md - `GET /v1/instagram/search/profiles`: Returns public profiles matching a keyword, each with username, display name, bio, follower and following counts, post count, and profile URL. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/instagram/search-profiles.md - `GET /v1/instagram/reels/trending`: Returns reels from Instagram's public trending page, each with shortcode, URL, caption, media URLs, engagement counts where shown, and the account. Required: (none) Markdown: https://www.insightsocial.app/docs/api-reference/instagram/reels-trending.md - `GET /v1/instagram/followers`: Returns the accounts that follow a user, each with username, display name, avatar URL, verification status, and profile URL. Required: one of (handle | user_id) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/instagram/followers.md - `GET /v1/instagram/following`: Returns the accounts a user follows, each with username, display name, avatar URL, verification status, and profile URL. Required: one of (handle | user_id) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/instagram/following.md - `GET /v1/instagram/similar`: Returns the accounts Instagram suggests as similar to a given user, each with username, display name, avatar URL, verification status, and URL. Required: one of (handle | user_id) Markdown: https://www.insightsocial.app/docs/api-reference/instagram/similar.md - `GET /v1/instagram/post/likers`: Returns a sample of the accounts that liked a post, each with username, display name, avatar, and verification status, plus the full like count. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/instagram/post-likers.md - `GET /v1/instagram/post/stats`: Returns one post's engagement: likes, comments, and, on video posts only, the play count and the share count shown by the paper plane icon. Collab posts also list co-authors under ext.coauthors. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/instagram/post-stats.md - `GET /v1/instagram/tagged`: Returns posts that tag a given user, each with its shortcode, URL, caption, media URLs, engagement counts, and the account that posted it. Required: one of (handle | user_id) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/instagram/tagged.md - `GET /v1/instagram/location/posts`: Returns posts tagged at a place, newest first, about 60 a page, each with shortcode, URL, caption, media URLs, engagement counts, and the author. Required: location_id Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/instagram/location-posts.md - `GET /v1/instagram/engagement`: Returns a computed engagement report for an account: overall engagement rate, follower count, total likes and comments, and a per-post breakdown. Required: handle Markdown: https://www.insightsocial.app/docs/api-reference/instagram/engagement.md - `GET /v1/instagram/search/location`: Returns places matching a keyword, each with its location id, name, and coordinates, plus a display title and subtitle. Required: query Markdown: https://www.insightsocial.app/docs/api-reference/instagram/search-location.md - `GET /v1/instagram/search`: Returns mixed Instagram search matches for a query: accounts, hashtags, and places in one payload. Required: query Markdown: https://www.insightsocial.app/docs/api-reference/instagram/search.md - `GET /v1/instagram/search/popular`: Returns popular Instagram posts matching a keyword, each with caption, play count, permalink, thumbnail, and the owner's username. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/instagram/search-popular.md - `GET /v1/instagram/post/comment/replies`: Returns replies under one Instagram comment, each with text, like count, nested reply count, author, and timestamp. Required: url, comment_id Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/instagram/post-comment-replies.md - `GET /v1/instagram/username-suggestions`: Returns suggested available Instagram usernames built from a keyword you supply. Required: query Markdown: https://www.insightsocial.app/docs/api-reference/instagram/username-suggestions.md - `GET /v1/instagram/search/music`: Returns audio tracks matching a keyword, each with artist, title, audio and cover artwork URLs, duration, and usage details. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/instagram/search-music.md - `GET /v1/instagram/stories`: Returns the stories a user has live right now, each with its id, image or video URLs, thumbnail, duration, capture time, and the author. Required: one of (handle | user_id) Markdown: https://www.insightsocial.app/docs/api-reference/instagram/stories.md - `GET /v1/instagram/story/download`: Returns the full resolution image or video URLs and metadata for one specific story. Required: user_id, story_id Markdown: https://www.insightsocial.app/docs/api-reference/instagram/story-download.md - `GET /v1/instagram/music/trending`: Returns a chart of licensed tracks trending on Instagram, each with title, artist, audio and cover artwork URLs, and usage details. Required: (none) Markdown: https://www.insightsocial.app/docs/api-reference/instagram/music-trending.md - `GET /v1/instagram/profile/full`: Returns the profile plus its latest 12 posts and computed metrics: engagement rate by views and by followers, posting cadence, the top post, and the mix of post formats. Required: handle Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/instagram/profile-full.md - `GET /v1/instagram/profile/reels/full`: Returns a user's reels with views, likes, comments, and a per-reel share count where the second source exposes one, plus a coverage figure. Required: one of (handle | user_id) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/instagram/profile-reels-full.md - `GET /v1/instagram/profile/posts/full`: Returns a user's recent posts with likes, comments, views, and a per-post share count where the second source exposes one, plus a coverage figure. Required: one of (handle | user_id) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/instagram/profile-posts-full.md ## TikTok - `GET /v1/tiktok/profile`: Returns a TikTok account's public profile: display name, bio, follower count on author.followers (or the rounded figure with author.ext.followers_approximate), likes, verification, and user id. Required: one of (handle | user_id) Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/profile.md - `GET /v1/tiktok/profile/videos`: Returns a page of an account's recent public videos, each with caption, view, like, comment and share counts, and a thumbnail URL. Handle lookup covers login or age-walled profiles. Required: one of (handle | user_id) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/profile-videos.md - `GET /v1/tiktok/post`: Returns one TikTok video in full: caption, engagement counts, author, sound, video metadata, and any on-screen text the creator typed with TikTok's text tool (post.ext.on_screen_texts). Required: url Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/post.md - `GET /v1/tiktok/post/comments`: Returns a page of comments on one TikTok video, each with the commenter's username, comment text, like count, reply count, and timestamp. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/post-comments.md - `GET /v1/tiktok/video/comment/replies`: Returns the replies under a single TikTok comment, with each reply's text, author, likes, and timestamps. Required: comment_id, url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/video-comment-replies.md - `GET /v1/tiktok/comment`: Returns one TikTok comment with its current like count, reply count, pinned flag, author, and timestamp, found by link, by id, or by its text. Required: one of (comment_url | post_url) Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/comment.md - `GET /v1/tiktok/search`: Returns TikTok videos matching a keyword, each with caption, view and like counts, author details, a thumbnail, and post.ext.region (the country the video is registered to). Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/search.md - `GET /v1/tiktok/trending`: Returns a page of popular TikTok videos with caption, view and like counts, author and thumbnail. Every row carries post.ext.region, the country the video is registered to. Required: region Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/trending.md - `GET /v1/tiktok/search/hashtag`: Returns TikTok videos posted under a given hashtag, each with caption, view, like, comment and share counts, author details, and a thumbnail. Required: hashtag Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/search-hashtag.md - `GET /v1/tiktok/search/top`: Returns the videos TikTok ranks highest for a keyword on its Top tab, each with caption, author, engagement counts, a music id, and post.ext.region (the country the video is registered to). Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/search-top.md - `GET /v1/tiktok/search/users`: Returns TikTok accounts for a search term with username, name, avatar, followers, verification. include=profile adds bio, region, link and category. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/search-users.md - `GET /v1/tiktok/user/audience`: Returns where a creator's followers are: the top countries in their audience, with sampled follower counts and each country's share. Required: handle Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/user-audience.md - `GET /v1/tiktok/user/followers`: Returns a page of accounts that follow a TikTok user, each with username, display name, avatar, and its own follower count. Required: one of (handle | user_id) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/user-followers.md - `GET /v1/tiktok/user/following`: Returns a page of accounts a TikTok user follows, each with username, display name, avatar, and its own follower count. Required: one of (handle | user_id) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/user-following.md - `GET /v1/tiktok/user/live`: Returns a TikTok account's live room in the platform's own shape: cover image, title, start time, status code, viewer and entry counts, stream ids, and the host's profile. Required: handle Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/user-live.md - `GET /v1/tiktok/post/transcript`: Returns the spoken text of a TikTok video from its captions, with an option to fall back to AI transcription when no captions exist. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/post-transcript.md - `GET /v1/tiktok/video/screen-text`: Returns the text shown on the video itself: native text stickers plus AI OCR of the cover frame, so burned-in editor captions are caught too. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/video-screen-text.md - `GET /v1/tiktok/song`: Returns one TikTok sound's details: title, artist, duration, how many videos use it, and its cover image. Required: clipId Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/song.md - `GET /v1/tiktok/song/videos`: Returns videos that use a given TikTok sound, each with caption, author details, and engagement counts. Required: clipId Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/song-videos.md - `GET /v1/tiktok/hashtags/popular`: Returns TikTok's trending-hashtag board for one of 27 markets over 7, 30 or 90 days: each hashtag's rank, window post and view counts, daily popularity curve, industry board and top creators. Required: (none) Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/hashtags-popular.md - `GET /v1/tiktok/videos/popular`: Returns TikTok's Top Videos board for the US, Japan, Vietnam, Thailand or Indonesia over 7 or 30 days: each video's rank, lifetime and window views, organic views, engagement rate and creator. Required: (none) Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/videos-popular.md - `GET /v1/tiktok/profile/region`: Returns the two letter country code for a public TikTok profile, for example US or MX. Required: handle Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/profile-region.md - `GET /v1/tiktok/adlibrary/search`: Returns TikTok Ad Library ads matching a keyword or advertiser name, each with creative, title, advertiser, impressions and date; include=ad adds the brand, landing page and advertiser link. Required: one of (query | advertiser_name) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/adlibrary-search.md - `GET /v1/tiktok/adlibrary/ad`: Returns one TikTok Ad Library ad: creative video, title, advertiser account, landing page, brand name, and first-shown date. Required: one of (ad_id | url) Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/adlibrary-ad.md - `GET /v1/tiktok/search/suggestions`: Returns the autocomplete suggestions TikTok's own search box shows for a partial query, as a list of suggestion rows. Required: query Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/search-suggestions.md - `GET /v1/tiktok/collection/videos`: Returns the public videos inside a TikTok collection, each with caption, play like comment share and save counts, author, and a playable URL. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/collection-videos.md - `GET /v1/tiktok/profile/playlists`: Returns the playlists a TikTok creator has published on their profile, each with its playlist id, its name, and the number of videos it holds. Required: one of (handle | user_id) Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/profile-playlists.md - `GET /v1/tiktok/playlist/videos`: Returns the videos inside one of a creator's profile playlists, in playlist order, each with engagement counts, caption, author, and a playable URL. Required: playlist_id, one of (handle | user_id) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/playlist-videos.md - `GET /v1/tiktok/user/liked`: Returns the videos a TikTok account has liked, newest first, each carrying its own third party author, engagement counts, caption, and a playable URL. Required: one of (handle | user_id) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/user-liked.md - `GET /v1/tiktok/location/posts`: Returns public TikTok videos tagged at a place, each with engagement counts, caption, author, and a playable URL. Required: location_id Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/location-posts.md - `GET /v1/tiktok/effects`: Returns TikTok camera effects by id, each with its name, its designer, the views of videos made with it, and how many such videos exist. Required: ids Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/effects.md - `GET /v1/tiktok/effect/videos`: Returns public TikTok videos created with a camera effect, each with engagement counts, caption, author, and a playable URL. Required: effect_id Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/effect-videos.md - `GET /v1/tiktok/search/music`: Returns TikTok sounds matching a keyword, each with title, artist, duration, cover art, a preview audio URL, and how many videos use it. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/search-music.md - `GET /v1/tiktok/hashtag`: Returns TikTok's own record for a hashtag, with its display name, its description where one exists, the live total views under the tag, and how many videos carry it. Required: one of (hashtag | hashtag_id) Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/hashtag.md - `GET /v1/tiktok/ads/top`: Returns TikTok's Creative Center leaderboard of top-performing ads for a market and time window, each with click-through rate, board rank, like count, industry, objective, and the ad video. Required: (none) Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/ads-top.md - `GET /v1/tiktok/profile/full`: Returns a TikTok profile plus its latest 10 videos and computed stats: engagement rate by views and by followers, posting cadence, the top post, and the mix of formats. Required: one of (handle | user_id) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/tiktok/profile-full.md ## Facebook - `GET /v1/facebook/profile`: Returns a Facebook page's public profile: page id, display name, profile image, bio, follower count, and page-like count. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/facebook/profile.md - `GET /v1/facebook/profile/posts`: Returns recent posts from a Facebook page or profile, each with the post text, like and comment counts, the per-reaction breakdown, media, and publish time. Share counts are null on a plain call. Required: one of (url | pageId) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/facebook/profile-posts.md - `GET /v1/facebook/post`: Returns one Facebook post in full: the post text, like, comment and share counts, a reactions breakdown, media attachments, and author info. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/facebook/post.md - `GET /v1/facebook/post/comments`: Returns comments on a Facebook post, each with the commenter's name, comment text, like count, reply count, and creation time. Required: one of (url | feedback_id) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/facebook/post-comments.md - `GET /v1/facebook/group/posts`: Returns posts from a Facebook group, 3 to 4 per page, each with the post text, reaction count, comment count, the per-reaction breakdown, and author info. Required: one of (url | group_id) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/facebook/group-posts.md - `GET /v1/facebook/group`: Returns a Facebook group's public record: name, description, member count, privacy, visibility, and creation date. Required: one of (url | group_id) Markdown: https://www.insightsocial.app/docs/api-reference/facebook/group.md - `GET /v1/facebook/post/transcript`: Returns the spoken words of a Facebook video post as a transcript, using Facebook's auto-generated captions. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/facebook/post-transcript.md - `GET /v1/facebook/profile/photos`: Returns a page or profile's photos, each with a photo id, permalink, full-size image URL, thumbnail, and accessibility caption when available. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/facebook/profile-photos.md - `GET /v1/facebook/profile/reels`: Returns a page or profile's reels, each with a reel id, description, thumbnail, permalink, publish time, and a rounded public view count. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/facebook/profile-reels.md - `GET /v1/facebook/adlibrary/ad`: Returns one ad from the Facebook Ad Library: creative, CTA and link, run dates, display format, and the advertiser's page URL, likes and categories. Required: one of (id | url) Markdown: https://www.insightsocial.app/docs/api-reference/facebook/adlibrary-ad.md - `GET /v1/facebook/adlibrary/company/ads`: Returns the ads one company or page is running in the Facebook Ad Library, each with its creative, status, spend, and targeting info. Required: one of (pageId | companyName) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/facebook/adlibrary-company-ads.md - `GET /v1/facebook/adlibrary/search/ads`: Returns Facebook Ad Library ads matching a keyword, each with its creative text, images, sponsor info, and running status. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/facebook/adlibrary-search-ads.md - `GET /v1/facebook/adlibrary/search/companies`: Returns advertiser pages in the Facebook Ad Library matching a name, each with its page id, name, handle, verification badge and follower count. Required: query Markdown: https://www.insightsocial.app/docs/api-reference/facebook/adlibrary-search-companies.md - `GET /v1/facebook/profile/events`: Returns a Facebook page's upcoming and past events, each with a title, link, the start time, the venue, the city, the rendered time line, and the cancelled, past and online flags. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/facebook/profile-events.md - `GET /v1/facebook/post/comment/replies`: Returns the replies under a single Facebook comment, each with the author name, reply text, like count, and creation time. Required: feedback_id, expansion_token Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/facebook/post-comment-replies.md - `GET /v1/facebook/marketplace/location/search`: Returns Facebook Marketplace locations and cities matching a search term, each with its lat and lng coordinates. Required: query Markdown: https://www.insightsocial.app/docs/api-reference/facebook/marketplace-location-search.md - `GET /v1/facebook/marketplace/search`: Returns Facebook Marketplace listings near a lat/lng, each with title, price, location, photo, delivery types, and sold or live flags. Required: query, lat, lng Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/facebook/marketplace-search.md - `GET /v1/facebook/marketplace/item`: Returns one Facebook Marketplace listing: title, description, price, location, condition, photos, seller, and availability flags. Required: one of (id | url) Markdown: https://www.insightsocial.app/docs/api-reference/facebook/marketplace-item.md - `GET /v1/facebook/events/search`: Returns public Facebook events matching a keyword, each with name, date sentence, venue, cover photo, interested and going counts, and online and past flags. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/facebook/events-search.md - `GET /v1/facebook/events`: Returns the events listed on a Facebook city or region events page, each with a title, link, cover image, the start time, the venue, and the going and interested counts. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/facebook/events.md - `GET /v1/facebook/event/details`: Returns one Facebook event in full: title, description, start and end time, location, host, cover image, and RSVP counts when shown. Required: one of (id | url) Markdown: https://www.insightsocial.app/docs/api-reference/facebook/event-details.md - `GET /v1/facebook/adlibrary/ad/transcript`: Returns the spoken words of a Facebook Ad Library video ad, from Facebook's captions when available or transcribed from the video itself. Required: one of (id | url) Markdown: https://www.insightsocial.app/docs/api-reference/facebook/adlibrary-ad-transcript.md - `GET /v1/facebook/profile/full`: Returns a page's profile plus its latest 3 posts and computed figures: engagement rate by views and by followers, posting cadence, top post, and format mix. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/facebook/profile-full.md - `GET /v1/facebook/profile/reels/full`: Returns a page's reels with exact per-reel engagement merged in: views, likes, comments, and shares, plus each reel's id, thumbnail, and link. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/facebook/profile-reels-full.md - `GET /v1/facebook/search/posts`: Returns public Facebook posts matching a keyword, each with text, permalink, publish time, like count, comment count, and author. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/facebook/search-posts.md - `GET /v1/facebook/search/pages`: Returns Facebook pages matching a keyword, each with page id, display name, permalink, avatar, and verified flag. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/facebook/search-pages.md - `GET /v1/facebook/search/people`: Returns Facebook people matching a keyword, each with profile id, display name, permalink, avatar, and verified flag. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/facebook/search-people.md - `GET /v1/facebook/search/videos`: Returns public Facebook videos matching a keyword, each with video id, caption, permalink, thumbnail, and author. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/facebook/search-videos.md - `GET /v1/facebook/search/groups`: Returns public Facebook groups matching your keywords, one row per group, with the group's name, id and URL in the same shape the group endpoints take. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/facebook/search-groups.md ## LinkedIn - `GET /v1/linkedin/profile`: Returns a LinkedIn member's public profile: full name, headline, location, follower and connection counts, profile picture, and profile URL. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile.md - `GET /v1/linkedin/company`: Returns a LinkedIn company page: company name, description, follower count, headquarters location, website, and logo. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/company.md - `GET /v1/linkedin/company/by-domain`: Returns the LinkedIn company page that owns a website domain: name, description, follower count, headquarters, website, logo, and numeric company id. Required: domain Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/company-by-domain.md - `GET /v1/linkedin/profile/similar`: Returns members LinkedIn groups with a given profile, each with handle, headline, profile URL, and picture. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-similar.md - `GET /v1/linkedin/search/companies`: Returns LinkedIn company pages matching a keyword, each with name, tagline, page URL, and logo. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/search-companies.md - `GET /v1/linkedin/profile/posted-jobs`: Returns the jobs a LinkedIn member has posted, each with job id, title, hiring company, location, and posting date. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-posted-jobs.md - `GET /v1/linkedin/job/hiring-team`: Returns the members LinkedIn shows as the hiring team on a job, each with handle, headline, profile URL, and picture. Required: one of (id | url) Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/job-hiring-team.md - `GET /v1/linkedin/profile/articles`: Returns Pulse articles a LinkedIn member published, each with text, author, engagement, and date. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-articles.md - `GET /v1/linkedin/article`: Returns one LinkedIn Pulse article: its text, author, like and comment counts, and publish time. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/article.md - `GET /v1/linkedin/article/comments`: Returns comments on a LinkedIn Pulse article, with commenter identity, text, and timestamp. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/article-comments.md - `GET /v1/linkedin/article/reactions`: Returns members who reacted to a LinkedIn Pulse article, each with handle, name, picture, and reaction type. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/article-reactions.md - `GET /v1/linkedin/search/hashtag`: Returns public LinkedIn posts tagged with a hashtag, each with text, author, engagement, and date. Required: query Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/search-hashtag.md - `GET /v1/linkedin/profile/activity`: Returns when a LinkedIn member last showed public activity. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-activity.md - `GET /v1/linkedin/company/also-viewed`: Returns company pages LinkedIn shows as people also viewed, each with name, page URL, and logo. Required: one of (company_id | url) Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/company-also-viewed.md - `GET /v1/linkedin/company/employees-count`: Returns how many LinkedIn members list a company as employer, optionally broken down by location. Required: company_id Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/company-employees-count.md - `GET /v1/linkedin/profile/interests/schools`: Returns the school pages a LinkedIn member follows, each with name and page URL. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-interests-schools.md - `GET /v1/linkedin/profile/interests/newsletters`: Returns the newsletters a LinkedIn member follows, each with name and page URL. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-interests-newsletters.md - `GET /v1/linkedin/profile/interests/top-voices`: Returns the Top Voice profiles a LinkedIn member follows, each with name and profile URL. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-interests-top-voices.md - `GET /v1/linkedin/profile/position-skills`: Returns a member's positions with the skills listed on each role. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-position-skills.md - `GET /v1/linkedin/profile/top-position`: Returns the company page of the member's current top position: company id, name, website, headcount, industries and locations, not the job title. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-top-position.md - `GET /v1/linkedin/search/people/by-url`: Returns LinkedIn members from a people-search results URL, each with handle, headline, and profile URL. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/search-people-by-url.md - `GET /v1/linkedin/profile/all`: Returns a member's entire public profile in one call: `author` with both counts, and `background` with About, experience, education, skills, recommendations, Featured and interests. Required: one of (url | urls) Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-all.md - `GET /v1/linkedin/profile/complete`: Returns a member's full background: `author` in the /profile shape, and `background` with About, experiences, educations, skills and recommendations in the profile/* item shapes. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-complete.md - `GET /v1/linkedin/profile/with-posts`: Returns a member's profile with follower and connection counts in `author`, recent `posts` in the profile/posts item shape, and experiences, educations and skills under `background`. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-with-posts.md - `GET /v1/linkedin/post/with-comments`: Returns one LinkedIn post packed with its comments in a single payload. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/post-with-comments.md - `GET /v1/linkedin/post`: Returns one LinkedIn post: its text, author name and picture, like, comment and share counts, attached media, and the publish time. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/post.md - `GET /v1/linkedin/search/people`: Returns LinkedIn members matching a name or filters, each with handle, headline, location, follower count, profile URL, and member id. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/search-people.md - `GET /v1/linkedin/company/people`: Returns the members who list a company as their employer, each with handle, headline, location, profile picture, and follower count. Required: company_id Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/company-people.md - `GET /v1/linkedin/post/comments`: Returns the comments on a LinkedIn post: commenter name, comment text, reaction counts, reply count, pinned and edited flags, and timestamps. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/post-comments.md - `GET /v1/linkedin/profile/posts`: Returns the posts a LinkedIn member published, each with text, author name, like, comment and share counts, media, and publish time. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-posts.md - `GET /v1/linkedin/profile/reactions`: Returns the posts a LinkedIn member reacted to, each with the post text, its original author, like, comment and share counts, and date. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-reactions.md - `GET /v1/linkedin/post/reposts`: Returns the reposts of a LinkedIn post, each with the resharer's name, any added commentary, engagement counts, and publish time. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/post-reposts.md - `GET /v1/linkedin/group/posts`: Returns the posts inside a LinkedIn group, each with text, author name, like, comment and share counts, media, and publish time. Required: group_id Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/group-posts.md - `GET /v1/linkedin/company/affiliated-pages`: Returns a company's affiliated and showcase pages, each with page name, LinkedIn URL, speciality, follower count, and logo. Required: company_id Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/company-affiliated-pages.md - `GET /v1/linkedin/post/comments/replies`: Returns the replies under one LinkedIn comment, each with the replier's name, reply text, reaction and reply counts, and timestamps. Required: url, comment_id Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/post-comments-replies.md - `GET /v1/linkedin/profile/experiences`: Returns a LinkedIn member's work history, with each role's job title, company, employment dates, location, and description. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-experiences.md - `GET /v1/linkedin/profile/educations`: Returns a LinkedIn member's education history, with each entry's school, degree, field of study, and the years attended. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-educations.md - `GET /v1/linkedin/profile/skills`: Returns the skills listed on a LinkedIn member's profile, with each skill's name and the endorsements shown against it. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-skills.md - `GET /v1/linkedin/profile/honors`: Returns the honors and awards on a LinkedIn member's profile, with each award's title, issuer, date, and description. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-honors.md - `GET /v1/linkedin/profile/certifications`: Returns the licenses and certifications on a LinkedIn member's profile, with each one's name, issuer, and issue or expiry dates. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-certifications.md - `GET /v1/linkedin/profile/publications`: Returns the publications on a LinkedIn member's profile, with each one's title, publisher, publication date, description, and link. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-publications.md - `GET /v1/linkedin/profile/volunteers`: Returns the volunteer experience on a LinkedIn member's profile, with each entry's role, organisation, cause, and dates. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-volunteers.md - `GET /v1/linkedin/profile/recommendations`: Returns the recommendations on a LinkedIn member's profile, with the recommender's name and headline, the recommendation text, and date. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-recommendations.md - `GET /v1/linkedin/profile/interests/companies`: Returns the companies a LinkedIn member follows, with each company's name, LinkedIn URL, follower count, and logo. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-interests-companies.md - `GET /v1/linkedin/profile/interests/groups`: Returns the LinkedIn groups a member follows, with each group's name, URL, and the size of its membership. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-interests-groups.md - `GET /v1/linkedin/profile/images`: Returns the image posts on a LinkedIn member's profile, with each post's text, image links, engagement counts, and publish time. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-images.md - `GET /v1/linkedin/profile/videos`: Returns the video posts on a LinkedIn member's profile, with each post's text, video and thumbnail links, engagement counts, and date. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-videos.md - `GET /v1/linkedin/profile/comments`: Returns the comments a LinkedIn member left on other people's posts, with the comment text, the post it sits under, and the timestamp. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-comments.md - `GET /v1/linkedin/post/reactions`: Returns the people who reacted to a LinkedIn post, each with their name, headline, profile URL, and the reaction they left. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/post-reactions.md - `GET /v1/linkedin/company/jobs`: Returns the jobs a company has posted, each with job id, title, location, hiring company details, posting date, and Easy Apply flag. Required: company_id Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/company-jobs.md - `GET /v1/linkedin/search/jobs`: Returns LinkedIn job postings matching a keyword, each with job id, title, hiring company, location, posting date, and Easy Apply flag. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/search-jobs.md - `GET /v1/linkedin/search/location`: Returns LinkedIn locations matching a place name, each with the location's display name and the geocode id LinkedIn filters on. Required: query Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/search-location.md - `GET /v1/linkedin/search/schools`: Returns LinkedIn school pages matching a name, each with the school's name, page URL, and the id used in search filters. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/search-schools.md - `GET /v1/linkedin/search/industry`: Returns LinkedIn industries matching a keyword, each with the industry name and the id LinkedIn uses to identify it. Required: query Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/search-industry.md - `GET /v1/linkedin/profile/about`: Returns the month a LinkedIn member joined and how recently contact details and the profile photo were updated, plus identity verification when LinkedIn shows it for that member. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-about.md - `GET /v1/linkedin/profile/contact`: Returns the contact details a LinkedIn member exposes publicly: websites, phone numbers, address, WeChat, and Twitter, alongside their name and profile urn. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-contact.md - `GET /v1/linkedin/profile/stats`: Returns a LinkedIn member's audience size: their follower count and their connection count. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-stats.md - `GET /v1/linkedin/company/job-count`: Returns the number of jobs a LinkedIn company currently has open. Required: company_id Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/company-job-count.md - `GET /v1/linkedin/company/insights`: Returns headcount breakdowns of a LinkedIn company's members as name and count pairs, covering locations, schools, job functions, skills, service categories, and fields of study. Required: company_id Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/company-insights.md - `GET /v1/linkedin/group`: Returns a LinkedIn group's profile: name, description, member count, posting rules, industries, owners, logo and cover images, and its public and active flags. Required: group_id Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/group.md - `GET /v1/linkedin/job`: Returns one LinkedIn job posting in full: title, hiring company, location, posting date, the job description text, and the Easy Apply flag. Required: id Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/job.md - `GET /v1/linkedin/company/posts`: Returns the recent posts from a LinkedIn company page, each with text, author name, like, comment and share counts, media, and date. Required: company_id Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/company-posts.md - `GET /v1/linkedin/ad`: Returns one LinkedIn ad from the Ad Library: the ad copy, creative images, the advertiser's name and logo, total impressions, and start date. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/ad.md - `GET /v1/linkedin/ads/search`: Returns ads from the LinkedIn Ad Library matching a company, keyword, country, or date range, with each ad's copy and the advertiser behind it. Required: one of (company | keyword | companyId) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/ads-search.md - `GET /v1/linkedin/profile/posts/archive`: Returns a LinkedIn member's deep post archive, read from their own feed rather than a search index, with the exact publish timestamp, media and the full engagement breakdown including share counts. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-posts-archive.md - `GET /v1/linkedin/search/posts`: Returns public LinkedIn posts and Pulse articles matching a keyword, with each result's text, author, media, like and comment counts, and date. Required: one of (query | from_member | from_company) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/search-posts.md - `GET /v1/linkedin/post/transcript`: Returns the spoken text of a video in a LinkedIn post. A post with no transcript answers 404 with reason no_captions, and a repost is read from the original post it shares. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/post-transcript.md - `GET /v1/linkedin/profile/full`: Returns a LinkedIn company page, its latest 10 posts, and computed metrics together: engagement rate by views and by followers, posting cadence, top post, format mix. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/linkedin/profile-full.md ## Twitter/X - `GET /v1/twitter/profile`: Returns an X (Twitter) account's public profile: follower count, following count, tweet count, bio, profile and banner image URLs, and verification status. Required: handle Markdown: https://www.insightsocial.app/docs/api-reference/twitter/profile.md - `GET /v1/twitter/user/tweets`: Returns an account's most recent tweets in descending order, with full text, like, retweet, reply, bookmark and view counts, media, and creation time. Around 20 tweets per page. Required: handle Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/twitter/user-tweets.md - `GET /v1/twitter/tweet`: Returns one tweet in full: its text, like, retweet, reply and quote counts, media attachments, author info, and creation timestamp. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/twitter/tweet.md - `GET /v1/twitter/community`: Returns an X (Twitter) community's details: name, description, member count, rules, and creation date. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/twitter/community.md - `GET /v1/twitter/community/tweets`: Returns recent tweets posted inside an X (Twitter) community, each with its text, engagement counts, and author info. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/twitter/community-tweets.md - `GET /v1/twitter/tweet/transcript`: Returns the transcript of a video attached to a tweet, including auto-generated captions. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/twitter/tweet-transcript.md - `GET /v1/twitter/ai-search`: Returns a written answer to a plain-English question about X (Twitter), the X posts cited as sources, and how many searches the model ran. Required: query Markdown: https://www.insightsocial.app/docs/api-reference/twitter/ai-search.md - `GET /v1/twitter/search/tweets`: Returns tweets matching a keyword or phrase, each with the full text, like, retweet, reply, bookmark and view counts, media attachments, author info, and creation time. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/twitter/search-tweets.md - `GET /v1/twitter/tweet/replies`: Returns the replies to a tweet, each with the reply text, author info, like and reply counts, and creation time. The tweet itself is not in the list. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/twitter/tweet-replies.md - `GET /v1/twitter/user/media`: Returns the tweets on an account's Media tab, only those carrying a photo or video, with media URLs, engagement counts, and creation time. View and bookmark counts are null here. Required: handle Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/twitter/user-media.md - `GET /v1/twitter/user/followers`: Returns the accounts following an X (Twitter) user, each with the handle, display name, bio, follower and tweet counts, privacy flag, and join date. Required: handle Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/twitter/user-followers.md - `GET /v1/twitter/user/following`: Returns the accounts an X (Twitter) user follows, each with the handle, display name, bio, follower and tweet counts, privacy flag, and join date. Required: handle Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/twitter/user-following.md - `GET /v1/twitter/tweet/retweeters`: Returns the accounts that retweeted a tweet, each with the handle, display name, bio, follower and tweet counts, privacy flag, and join date. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/twitter/tweet-retweeters.md - `GET /v1/twitter/search/users`: Returns X (Twitter) accounts matching a name, handle or keyword, with handle, display name, bio, avatar, follower, following and tweet counts, location, verification, join date, and a private flag. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/twitter/search-users.md - `GET /v1/twitter/profile/full`: Returns an X account's profile, its recent tweets, and computed metrics in one call: engagement rate by views and by followers, posting cadence, top post, and format mix. Required: handle Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/twitter/profile-full.md ## Threads - `GET /v1/threads/profile`: Returns a Threads account's public profile: bio, the external link set in that bio, follower count, profile picture URL, and verification status. Required: handle Markdown: https://www.insightsocial.app/docs/api-reference/threads/profile.md - `GET /v1/threads/user/posts`: Returns a Threads user's most recent posts, usually about 15. Send limit above 15 (up to 50) to collect more of the same feed, with view counts and display names filled in. Required: handle Markdown: https://www.insightsocial.app/docs/api-reference/threads/user-posts.md - `GET /v1/threads/post`: Returns one Threads post's text, like, reply and repost counts, every carousel slide or video URL, author, creation time, and topic tag at post.ext.topic_tag. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/threads/post.md - `GET /v1/threads/search`: Returns Threads posts matching a keyword, each with its text, like count, author, creation time, and the topic tag it was filed under at post.ext.topic_tag, plus a cursor for the next window. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/threads/search.md - `GET /v1/threads/post/comments`: Returns the replies Threads bundles with a post, usually about 20. Send limit above 25 (up to 50) to collect more first-level replies from a second source. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/threads/post-comments.md - `GET /v1/threads/search/users`: Returns Threads accounts matching a query, with handle, display name, avatar and verification status. Follower count, bio and the private flag stay null unless you send include=profile. Required: query Markdown: https://www.insightsocial.app/docs/api-reference/threads/search-users.md ## YouTube - `GET /v1/youtube/channel`: Returns a YouTube channel's public profile: subscriber count on author.followers (rounded above 1,000), video and view totals, description, banner and avatar URLs, and author.ext.public_email. Required: one of (channelId | handle | url) Markdown: https://www.insightsocial.app/docs/api-reference/youtube/channel.md - `GET /v1/youtube/channel/about`: Returns the address behind a channel's View email address control on author.ext.public_email, its listed country, and the profile: id, handle, name, avatar, bio, URL, subscribers, join date, views. Required: one of (channelId | handle | url) Markdown: https://www.insightsocial.app/docs/api-reference/youtube/channel-about.md - `GET /v1/youtube/channel/videos`: Returns recent videos published by a channel, each with title, view count, duration, thumbnail, and publish date; pass includeExtras=true to add like and comment counts. Required: one of (channelId | handle) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/youtube/channel-videos.md - `GET /v1/youtube/video`: Returns full details for one video: title, view, like and comment counts, description, tags, duration, channel info, and publish date. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/youtube/video.md - `GET /v1/youtube/video/sponsors`: Returns whether a video carries a paid-promotion disclosure plus the brands likely sponsoring it, each with supporting evidence and a confidence score. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/youtube/video-sponsors.md - `GET /v1/youtube/video/comments`: Returns comments on a video, each with the author name, comment text, like count, reply count, and publish timestamp. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/youtube/video-comments.md - `GET /v1/youtube/video/comment/replies`: Returns the replies under one comment, each with the reply text, author details, like count, and publish date. Required: continuationToken Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/youtube/video-comment-replies.md - `GET /v1/youtube/search`: Returns YouTube search results for a keyword: videos, channels, playlists, shorts, and live streams, each with title, thumbnail, views, and channel. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/youtube/search.md - `GET /v1/youtube/channel/shorts`: Returns the Shorts published by a channel, each with title, view count, like count, and thumbnail. Required: one of (channelId | handle) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/youtube/channel-shorts.md - `GET /v1/youtube/community-post`: Returns one YouTube community post: its text, like count, comment count, attached images, and author info. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/youtube/community-post.md - `GET /v1/youtube/playlist`: Returns the videos in a playlist in playlist order: video id, title, thumbnail, channel and publish date. include=engagement adds views, likes, comments and duration. Required: playlist_id Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/youtube/playlist.md - `GET /v1/youtube/search/hashtag`: Returns videos posted under a hashtag, each with view count, channel info, and publish date. Required: hashtag Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/youtube/search-hashtag.md - `GET /v1/youtube/shorts/trending`: Returns the Shorts trending on YouTube right now, each with view count, like count, channel info, and thumbnail. Required: (none) Markdown: https://www.insightsocial.app/docs/api-reference/youtube/shorts-trending.md - `GET /v1/youtube/video/transcript`: Returns the spoken transcript of a video as timestamped segments, each with text, start time and duration, plus language, word count, and speech rate. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/youtube/video-transcript.md - `GET /v1/youtube/channel/playlists`: Returns the playlists on a channel's Playlists tab, each with playlist id, title, thumbnail, video count, channel info, and playlist URL. Required: one of (channelId | handle) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/youtube/channel-playlists.md - `GET /v1/youtube/channel/lives`: Returns the live and past streams on a channel's Live tab, each with title, URL, thumbnail, view count, publish time, and duration. Required: one of (channelId | handle) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/youtube/channel-lives.md - `GET /v1/youtube/channel/community-posts`: Returns the posts on a channel's Posts tab, each with post id, URL, text, images, attached video, like count, publish time, and channel info. Required: one of (channelId | handle) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/youtube/channel-community-posts.md - `GET /v1/youtube/videos/trending`: Returns the trending videos for a country and category, each with title, thumbnail, duration, view, like and comment counts, channel, and publish time. Required: (none) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/youtube/videos-trending.md - `GET /v1/youtube/playlist/items`: Returns the videos of a playlist in playlist order, each with video id, title, thumbnail, the video's own channel, its publish date, and its position and insertion time on post.ext. Required: playlist_id Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/youtube/playlist-items.md - `GET /v1/youtube/search/advanced`: Returns video search results with the full filter set: sort order, length, live status, license, category, country, language, and publish date window. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/youtube/search-advanced.md - `GET /v1/youtube/search/suggestions`: Returns the autocomplete suggestions YouTube's own search box shows for a partial query, as a plain list of strings. Required: query Markdown: https://www.insightsocial.app/docs/api-reference/youtube/search-suggestions.md - `GET /v1/youtube/video/audio`: Returns the downloadable audio streams for a video, each with a direct media URL, mime type, bitrate, audio quality, sample rate, channels, and duration. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/youtube/video-audio.md - `GET /v1/youtube/video/files`: Returns the downloadable video streams for a video, each with a direct media URL, mime type, resolution, quality label, frame rate, bitrate, and duration. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/youtube/video-files.md - `GET /v1/youtube/video/subtitles`: Returns the caption track files for a video, each with a language code and name, file format, and a direct download URL, including auto-generated tracks. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/youtube/video-subtitles.md - `GET /v1/youtube/video/thumbnails`: Returns a video's thumbnail images at every available size, each with a direct image URL, width, height, aspect ratio, and image format. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/youtube/video-thumbnails.md - `GET /v1/youtube/profile/full`: Returns a channel's profile, up to 30 recent videos, and computed metrics in one call: engagement rate by views and by followers, posting cadence, top post, and format mix. Required: one of (handle | channelId | url) Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/youtube/profile-full.md ## Reddit - `GET /v1/reddit/subreddit`: Returns posts from a subreddit, each with title, body, score, comment count, author, permalink, and creation timestamp. Required: subreddit Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/reddit/subreddit.md - `GET /v1/reddit/subreddit/details`: Returns a subreddit's own details: subscriber count, active user count, description, creation date, rules, and icon URL. Required: one of (subreddit | url) Markdown: https://www.insightsocial.app/docs/api-reference/reddit/subreddit-details.md - `GET /v1/reddit/search`: Returns posts matching a keyword from across Reddit, each with title, score, comment count, subreddit, permalink, and the body at ext.selftext. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/reddit/search.md - `GET /v1/reddit/post`: Returns one post from its URL including the body text, plus score, comment count, share count, author, author avatar, thumbnail, and creation timestamp. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/reddit/post.md - `GET /v1/reddit/post/comments`: Returns the full comment tree for a post, each comment with author, body, score, direct-reply count, nesting depth, timestamp, and its nested replies. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/reddit/post-comments.md - `GET /v1/reddit/subreddit/search`: Returns posts matching a query inside one subreddit, each with title, score, comment count, and permalink. This source sends no post body, so ext.selftext is null without include_body. Required: subreddit Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/reddit/subreddit-search.md - `GET /v1/reddit/profile`: Returns one Reddit account: total karma, the post/comment/award karma split, cake day, bio, avatar, banner, trophy count and profile title. Required: handle Markdown: https://www.insightsocial.app/docs/api-reference/reddit/profile.md - `GET /v1/reddit/profile/posts`: Returns the posts one account has submitted, newest first, with the body at ext.selftext, score, comment count, upvote ratio, flair, media and ext.subreddit. Required: handle Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/reddit/profile-posts.md - `GET /v1/reddit/profile/comments`: Returns an account's own comment history, newest first, each with the text, score, permalink, parent_id, the post it sits under and ext.subreddit. Required: handle Markdown: https://www.insightsocial.app/docs/api-reference/reddit/profile-comments.md - `GET /v1/reddit/search/comments`: Returns comments matching a phrase from Reddit's comment index, each with its parent post inline: ext.post_title, ext.subreddit, ext.post_score and ext.post_url. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/reddit/search-comments.md - `GET /v1/reddit/subreddits/search`: Returns up to 25 communities matching a topic, each with the name at author.id, subscriber count, description and icon. include=details adds the creation date, weekly activity, rules and language. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/reddit/subreddits-search.md - `GET /v1/reddit/search/media`: Returns up to 25 Reddit posts that carry an image, video or gallery, with the media at content.media_urls plus title, score, comment count and subreddit. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/reddit/search-media.md - `GET /v1/reddit/post/transcript`: Returns the transcript of a Reddit video post, both the raw caption file and a plain-text version, when Reddit publishes captions for it. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/reddit/post-transcript.md - `GET /v1/reddit/omni-search`: Returns threads from across Reddit for one keyword with their top comments inline at top_comments, plus a roll-up of which subreddits are talking, their weekly active users and tone. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/reddit/omni-search.md ## Pinterest - `GET /v1/pinterest/search`: Returns Pinterest pins matching a keyword, each with its text, original image, pinner and pin date; include=engagement adds save, reaction, comment and share counts. Required: query Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/pinterest/search.md - `GET /v1/pinterest/pin`: Returns one Pinterest pin: its text, original image, pinner, pin date, and its save, reaction, comment and share counts. Required: url Markdown: https://www.insightsocial.app/docs/api-reference/pinterest/pin.md - `GET /v1/pinterest/url-stats`: Returns how many times each of up to 10 external URLs has been saved to Pinterest through the Save Button. Required: urls Markdown: https://www.insightsocial.app/docs/api-reference/pinterest/url-stats.md - `GET /v1/pinterest/board`: Returns the pins on a Pinterest board with text, image URL, author, and save, comment and share counts; include=engagement adds each pin's date and reaction count. Required: url Paginates: by `cursor` Markdown: https://www.insightsocial.app/docs/api-reference/pinterest/board.md - `GET /v1/pinterest/user/boards`: Returns the boards a Pinterest user has created, each with its title, description, pin count, and cover image. Required: handle Markdown: https://www.insightsocial.app/docs/api-reference/pinterest/user-boards.md - `GET /v1/pinterest/trends`: Returns the Pinterest Trends list for one country: ranked search terms with a relative search index, for growing, seasonal, monthly or yearly tables. Required: (none) Markdown: https://www.insightsocial.app/docs/api-reference/pinterest/trends.md