API reference
Every endpoint of the API. Account and management endpoints are documented by hand; every data API has a page generated from the live catalog.
Last updated
All endpoints live at https://api.primaryapi.com and speak JSON. Authenticate with Authorization: Bearer pa_live_… or X-API-Key: pa_live_… (Authentication). Errors always have the shape { code, error, requestId } (Errors).
Account and management endpoints
| Area | Endpoints | Page |
|---|---|---|
| Run and quote | POST /v1/run/{sku}, POST /v1/quote/{sku} | Run and quote |
| Requests and results | GET /v1/requests, GET /v1/requests/{id}, GET /v1/results/{id} | Requests and results |
| API keys | GET/POST /v1/api-keys, GET/PATCH/DELETE /v1/api-keys/{id}, POST /v1/api-keys/{id}/rotate, GET /v1/api-keys/{id}/usage | API keys |
| Balance and billing | GET /v1/balance, GET /v1/billing/ledger, GET /v1/billing/orders, GET /v1/billing/packs, POST /v1/billing/checkout, GET /v1/workspace | Balance and billing |
| Usage | GET /v1/usage | Usage |
| Monitors | GET/POST /v1/monitors, GET/PATCH/DELETE /v1/monitors/{id}, GET /v1/monitors/by-custom-id/{customId}, POST /v1/monitors/{id}/run, POST /v1/monitors/{id}/test, GET /v1/monitors/{id}/runs, GET /v1/monitors/{id}/deliveries, POST /v1/monitors/{id}/deliveries/{deliveryId}/redeliver | Monitors |
| Webhook signing secret | GET /v1/webhooks/secret, POST /v1/webhooks/secret/rotate | Webhooks |
| Catalog and status | GET /v1/apis, GET /v1/apis/{sku}, GET /v1/catalog, GET /v1/categories, GET /v1/platforms, GET /openapi.json, GET /v1/status, GET /v1/status/apis, GET /health, GET /ready | Catalog and status |
| Agents | POST /agent/signup, GET /v1/agent/claim/{token}, POST /v1/agent/claim/{token}/approve | Agents |
| Feedback | POST /v1/feedback, POST /v1/bug-reports, POST /v1/api-requests | Feedback |
| MCP | POST /mcp | MCP server |
Who can call what
| Endpoint | No key | run key | view key | full key | Dashboard session |
|---|---|---|---|---|---|
| Catalog, status, OpenAPI, health | yes | yes | yes | yes | yes |
POST /agent/signup, POST /v1/api-requests | yes | yes | yes | yes | yes |
POST /v1/run/{sku}, POST /v1/quote/{sku} | — | yes | — | yes | yes |
GET /v1/requests, /v1/requests/{id}, /v1/results/{id} | — | yes | yes | yes | yes |
GET /v1/balance, /v1/usage, /v1/billing/ledger, /v1/billing/orders, /v1/workspace | — | — | yes | yes | yes |
/v1/api-keys/** | — | — | — | yes | yes |
GET /v1/monitors/** (monitors, runs, deliveries) | — | yes | yes | yes | yes |
POST/PATCH/DELETE /v1/monitors/** | — | its own monitors | — | yes | owners, admins, developers |
/v1/webhooks/secret, /v1/webhooks/secret/rotate | — | — | — | yes | owners, admins |
POST /v1/feedback, POST /v1/bug-reports | — | yes | yes | yes | yes |
POST /v1/billing/checkout, /v1/agent/claim/**, POST /v1/workspace/restricted-terms | — | — | — | — | yes |
Data APIs
Every data API is called with POST /v1/run/{sku} and documented on its own page: input fields, output fields, prices, measured reliability, example request and response, and the errors to handle. The pages are generated from the same catalog the gateway runs on, grouped by category and platform. The catalog currently lists 200 APIs across 31 platforms in 10 categories.
200 APIs
Social
- Bluesky Postbluesky.postOne public Bluesky post by URL: text, author, like, reply, repost and quote counts, media and creation time.1 credit per call
- Bluesky Profilebluesky.profilePublic Bluesky profile for one handle or DID: display name, bio, avatar, follower, following and post counts.1 credit per call
- Bluesky User Postsbluesky.user_postsRecent posts from one Bluesky account, newest first, with engagement counts, media and cursor pagination.1 credit per call
- Hacker News Profilehackernews.profileA Hacker News user's public profile: karma, about text and account creation date.1 credit per call
- Hacker News Searchhackernews.searchFull-text search of Hacker News stories and comments with title, link, author, points and comment count.1 credit per call
- Hacker News Storyhackernews.storyOne Hacker News story or item by id: title, link, author, points, comment count and timestamp.1 credit per call
- Hacker News Story Commentshackernews.story_commentsEvery comment of a Hacker News story, flattened depth-first with parent ids, authors, timestamps and depth.1 credit per call
- Instagram Basic Profileinstagram.basic_profileCore public profile fields (username, counts, bio, verification) for an Instagram account when you already hold its numeric user id.1 credit per call
- Instagram Comment Repliesinstagram.comment_repliesReplies to one comment on a public Instagram post or reel, paged by cursor, with text, author and like counts.1 credit per call
- Instagram Hashtag Recent Postsinstagram.hashtag_recent_postsNewest Instagram posts under a hashtag, read from its live chronological feed, for monitoring a tag as posts appear.1 credit per call
- Instagram Highlight Detailinstagram.highlight_detailEvery story item of one Instagram highlight by id: photo and video URLs, sizes, durations and timestamps.1 credit per call
- Instagram Media Transcriptinstagram.media_transcriptSpoken-audio transcript of a public Instagram reel or video post by URL, one entry per video in the post.3 credits per call
- Instagram Postinstagram.postOne public Instagram post or reel by URL: owner, caption, like, comment and play counts, media URLs and audio.1 credit per call
- Instagram Post Commentsinstagram.post_commentsComments on a public Instagram post or reel by URL, one page per call, with text, author, likes and reply counts.1 credit per call
- Instagram Profileinstagram.profilePublic profile of one Instagram account by handle: bio and links, follower, following and post counts, verification and business flags.1 credit per call
- Instagram Profile Contact InfoRestrictedinstagram.profile_contactContact email and phone number an Instagram creator or business publishes on its profile, including the address behind the Email and Call buttons.1 credit per call
- Instagram Profile Searchinstagram.search_profilesFind public Instagram profiles matching a keyword (name, handle or bio words) with handle, name, verified and private flags.1 credit per call
- Instagram Reel Transcriptinstagram.reel_transcriptSpeech transcript of a public Instagram reel or video post with timed segments, billed per started audio minute.4.38 credits per result
- Instagram Reels Searchinstagram.reels_searchSearch Instagram Reels by keyword through Instagram's own reels search, with views, likes, comments, caption and creator.1 credit per call
- Instagram Reels Web Searchinstagram.web_reels_searchSearch Instagram Reels through a web search index with an optional recency window and numbered pages (pages 1-11 of about 10 reels).1 credit per call
- Instagram Searchinstagram.searchKeyword search over Instagram users, hashtags or places with names, counts and links.1 credit per call
- Instagram Similar Profilesinstagram.similar_profilesAccounts Instagram recommends as similar to a public profile, with handle, display name, verified flag and avatar.1 credit per call
- Instagram Stories (basic)instagram.stories_thinLightweight list of a public account's live stories: media URL, permalink, owner and posting time only.3 credits per call
- Instagram Stories (full)instagram.stories_fullCurrently live stories of a public Instagram account with media URLs, type, dimensions, posting time and 24-hour expiry.3 credits per call
- Instagram Tagged Postsinstagram.tagged_postsPosts in which a public Instagram account is tagged, newest first, with the posting author, caption and engagement counts.1 credit per call
- Instagram User Highlightsinstagram.user_highlightsStory highlight reels of a public Instagram account by handle: ids, titles, cover images and owner.3 credits per call
- Instagram User Postsinstagram.user_postsRecent feed posts of a public Instagram account by handle (about 12 per page) with caption, likes, comments, views, media and cursor pagination.1 credit per call
- Instagram User Reelsinstagram.user_reelsReels of a public Instagram account by handle or user id with plays, likes, comments and caption, with cursor pagination.1 credit per call
- Instagram Hashtag Analyticsinstagram.hashtag_analyticsTotal public post count for an Instagram hashtag, plus related tags when the source returns them.planned
- Instagram Hashtag Searchinstagram.search_hashtagPosts under a hashtag from a web search index, filterable by date window and media type.planned
- Instagram Location Postsinstagram.location_postsPublic posts tagged at an Instagram location id, ranked or most recent, with cursor pagination.planned
- Instagram Location Searchinstagram.search_locationsSearch Instagram places by keyword and return each place id, name, address and coordinates.planned
- Instagram Profile Embedinstagram.embedPublic embed HTML document for an Instagram profile handle.planned
- Instagram Profile Search with ContactRestrictedinstagram.search_profiles_contactKeyword profile search that also returns each hit's country, join month, public email and phone, billed per profile returned.planned
- Instagram Reels by Audioinstagram.audio_reelsReels that use a given Instagram audio track, by audio id.planned
- Instagram Search Followersinstagram.search_followersSearch within a public account's followers by name or username using Instagram's own follower search.planned
- Instagram Search Followinginstagram.search_followingSearch within the accounts a public user follows by name or username using Instagram search.planned
- Instagram Trending Reelsinstagram.trending_reelsRecently popular Instagram reels, up to 12 per call, with caption, creator and engagement counts.planned
- Instagram User Repostsinstagram.user_repostsPosts a public Instagram account has reposted to its feed, by numeric user id, with cursor pagination.planned
- Reddit Postreddit.postOne Reddit post by URL: title, body, author, subreddit, score, upvote ratio, comment count and flags.2 credits per call
- Reddit Post Commentsreddit.post_commentsComments of a Reddit post by URL, flattened depth-first with parent ids, scores and timestamps, cursor paged.2 credits per call
- Reddit Searchreddit.searchSearch Reddit posts across all subreddits by query, with sort order and time window, cursor paged.2 credits per call
- Reddit Subreddit Detailsreddit.subreddit_detailsMetadata of one subreddit: description, icon, creation date, weekly active users and advertiser category.2 credits per call
- Reddit Subreddit Postsreddit.subreddit_postsPosts of one subreddit listing (hot, new or top with a time window), cursor paged.2 credits per call
- Reddit Subreddit Searchreddit.subreddit_searchSearch posts inside one subreddit by query, sort order and time window, cursor paged.2 credits per call
- Reddit Trending Postsreddit.trending_postsCurrently popular posts across Reddit (the r/popular feed), cursor paged.2 credits per call
- Reddit User Postsreddit.user_postsPosts submitted by one Reddit user, sorted by new, top, hot or controversial, cursor paged.2 credits per call
- Reddit Community and User Searchreddit.search_accountsFind Reddit communities (subreddits) or users by keyword.planned
- Reddit Post Transcriptreddit.post_transcriptSpoken-word transcript of a Reddit video post, from its post URL or v.redd.it link.planned
- Reddit User Commentsreddit.user_commentsComments written by a Reddit user, with the parent post title and subreddit, cursor paged.planned
- RedNote (Xiaohongshu) Noterednote.noteOne RedNote (Xiaohongshu) note by id: title, text, cover, author, engagement counts, location and timestamps.7 credits per call
- RedNote (Xiaohongshu) Note Commentsrednote.note_commentsTop-level comments of a RedNote (Xiaohongshu) note with author, likes, reply counts and timestamps, cursor paged.13 credits per call
- RedNote (Xiaohongshu) Profilerednote.profileRedNote (Xiaohongshu) creator profile by user id: nickname, RedNote number, bio, follower, like and note counts.7 credits per call
- RedNote (Xiaohongshu) Searchrednote.searchSearch RedNote (Xiaohongshu) notes by keyword, sorted by relevance, popularity or time, cursor paged.13 credits per call
- RedNote (Xiaohongshu) User Notesrednote.user_notesNotes posted by a RedNote (Xiaohongshu) user, with cover, engagement counts and timestamps, cursor-paged.13 credits per call
- RedNote (Xiaohongshu) User Searchrednote.search_usersSearch RedNote (Xiaohongshu) users by keyword and get normalised user records with RedNote number, bio and verification.13 credits per call
- Social Post Lookupsocial.post_lookupPaste a public post URL from X, Reddit, Hacker News, Weibo, RedNote or Zhihu and get that post through the matching platform API.1 credit per call
- Social Profile Check (Facebook / Threads / Snapchat)social.profile_checkCheck whether a handle exists on Facebook, Threads or Snapchat and get its public profile; a miss means the profile was not found.2 credits per call
- Social Account Searchsocial.searchFind accounts and communities on Reddit, X / Twitter or RedNote by keyword through one composite endpoint.planned
- Social Search (video platforms)social.search_videoKeyword in, matching public accounts out (handle, name, description, followers, profile URL) on YouTube, TikTok or Instagram.planned
- Telegram Channeltelegram.channelPublic Telegram channel profile: title, description, avatar, verified badge, subscriber count and media counters.1 credit per call
- Telegram Channel Poststelegram.channel_postsLatest public posts of a Telegram channel with text, time, views, reactions, media and link previews; pages back by cursor.1 credit per call
- Telegram Posttelegram.postOne public Telegram channel post by its t.me link: text, time, views, reactions, media and link preview.1 credit per call
- Threads Postthreads.postOne Threads post by URL: text, author, timestamp and like, reply, repost and quote counts.2 credits per call
- Threads Post Searchthreads.searchSearch public Threads posts by keyword or hashtag, optionally within a date range; up to 10 posts per call with engagement counts.2 credits per call
- Threads Profilethreads.profilePublic Threads profile by username: bio, follower count, verification, privacy flag, picture and bio links.2 credits per call
- Threads User Poststhreads.user_postsThe latest public posts of a Threads user (about 20-30 are visible) with text, timestamps, engagement counts and URLs.2 credits per call
- Threads User Searchthreads.search_usersSearch Threads accounts by name or username and get handle, display name, verification and profile picture.2 credits per call
- Truth Social Posttruthsocial.postOne public Truth Social post by URL: text, author, like, comment and ReTruth counts, media and timestamp.2 credits per call
- Truth Social Profiletruthsocial.profilePublic Truth Social account profile by handle: display name, bio, follower, following and post counts, verification.2 credits per call
- Truth Social User Poststruthsocial.user_postsRecent posts of a public Truth Social account, newest first, with engagement counts and media, paged by cursor.2 credits per call
- Twitter Tweet Transcripttwitter.tweet_transcriptSpoken-word transcript of a public X / Twitter video post, from its URL.3 credits per call
- X / Twitter Communitytwitter.communityPublic details of an X (Twitter) Community by URL: name, description, member count, join policy, creator and rules.1 credit per call
- X / Twitter Community Poststwitter.community_tweetsRecent posts in an X (Twitter) Community by URL, with author and engagement counts, newest first.2 credits per call
- X / Twitter Followerstwitter.followersFollower list of a public X (Twitter) account with bio, counts and avatar per follower, cursor-paged up to 200 per page.2 credits per call
- X / Twitter Followingtwitter.followingAccounts a public X (Twitter) user follows, with bio, counts and avatar per account, cursor-paged.2 credits per call
- X / Twitter Posttwitter.tweetOne public X (Twitter) post by URL: full text, author, media and engagement counts (likes, reposts, replies, quotes, bookmarks, views).1 credit per call
- X / Twitter Post Repliestwitter.repliesReplies to a public X (Twitter) post as structured records with author, text and engagement, cursor-paged about 20 per page.2 credits per call
- X / Twitter Profiletwitter.profilePublic X (Twitter) profile for one handle: bio, follower and post counts, verification, links and pinned posts.1 credit per call
- X / Twitter User Poststwitter.user_postsPosts-tab timeline of a public X account: pinned post first, then newest posts, about 20 per page with cursor paging.2 credits per call
- X / Twitter User Searchtwitter.search_usersSearch X (Twitter) accounts by keyword (the People tab) and get profile records with follower, following and post counts.2 credits per call
- X / Twitter Community Searchtwitter.search_communitiesSearch X (Twitter) Communities by keyword: id, name, topic and member count.planned
- YouTube Channelyoutube.channelYouTube channel profile and stats by handle or channel id: subscribers, video and view counts, description and links.1 credit per call
- YouTube Channel Live Streamsyoutube.channel_livesLive and past live streams from a YouTube channel’s Live tab: title, views, length and publish label, with cursor pages.2 credits per call
- YouTube Channel Public EmailRestrictedyoutube.channel_public_emailEmail address a creator wrote in a YouTube channel's public description or About links (never the hidden View email address button).1 credit per call
- YouTube Channel Searchyoutube.search_channelsKeyword search returning YouTube channels (handle, name, description snippet, subscriber count, URL, avatar) with cursor pagination.2 credits per call
- YouTube Channel Shortsyoutube.channel_shortsShorts published by a YouTube channel (title, views, likes, duration, publish time), newest or most popular first, with cursor pagination.2 credits per call
- YouTube Channel Videosyoutube.channel_videosLong-form videos uploaded by a YouTube channel (title, views, length, publish time), newest or most popular first, with cursor pagination.1 credit per call
- YouTube Hashtag Searchyoutube.search_hashtagVideos tagged with a YouTube hashtag (title, channel, views, length, publish time), with cursor pagination.2 credits per call
- YouTube Searchyoutube.searchKeyword search over YouTube videos with relevance or popularity sorting, upload-date filters and cursor pagination.2 credits per call
- YouTube Shorts Searchyoutube.search_shortsKeyword search restricted to YouTube Shorts (title, views, channel, URL) with sorting, upload-date filters and cursor pagination.2 credits per call
- YouTube Videoyoutube.videoMetadata for one YouTube video or Short by URL or ID: title, description, channel, views, likes, comment count, duration, publish date, tags and category.2 credits per call
- YouTube Video Commentsyoutube.video_commentsTop-level comments on a YouTube video or Short (text, author, likes, reply count, publish time), top or newest first, with cursor pagination.2 credits per call
- YouTube Video Transcriptyoutube.video_transcriptExisting captions of a YouTube video or Short as plain text plus timed segments, by URL or ID (no speech-to-text; videos without captions are a free miss).2 credits per call
- YouTube Video Transcript (Provenance)youtube.video_transcript_fullTranscript of a YouTube video or Short with timed segments, whether the captions are creator-written or speech recognition, and the video metadata in one response.3 credits per call
- YouTube Channel Community Postsyoutube.channel_community_postsPosts from a YouTube channel's Posts (community) tab: text, images, like count and publish time, with cursor pagination.planned
- YouTube Channel Contact EmailRestrictedyoutube.channel_contactBusiness inquiry email a creator publishes behind the signed-in, CAPTCHA-gated "View email address" button on the About page.planned
- YouTube Channel Playlistsyoutube.channel_playlistsPlaylists on a YouTube channel's Playlists tab (ID, title, video count, thumbnail) with cursor pagination.planned
- YouTube Comment Repliesyoutube.comment_repliesReplies to one YouTube comment, fetched with the replies token from youtube.video_comments, with cursor pagination.planned
- YouTube Community Postyoutube.community_postOne YouTube community post by URL: text, images, likes, publish time, channel and any attached video.planned
- YouTube Playlistyoutube.playlistVideos in a YouTube playlist (title, length, channel per video) plus the playlist title, owner and total video count.planned
- YouTube Trending Shortsyoutube.trending_shortsAbout 48 currently trending YouTube Shorts per call (title, channel, views, likes, duration); every call returns a fresh batch.planned
- YouTube Video Sponsorsyoutube.video_sponsorsPaid-promotion flag of a YouTube video plus inferred sponsors (name, website, confidence) from its description, links and transcript.planned
- Zhihu Answerzhihu.answerOne public Zhihu answer by id: full text, excerpt, author, parent question and timestamps.2 credits per call
- Zhihu Article Searchzhihu.search_articlesSearch public Zhihu articles by keyword, sorted by relevance, upvotes or date, with author and engagement data.2 credits per call
- Zhihu Questionzhihu.questionOne public Zhihu question by id: title, description and answer, comment, follower and view counts.2 credits per call
Search & SEO
- Google Maps Nearby Searchmaps.search_nearbySearch Google Maps around exact coordinates and zoom and get one viewport of up to 20 places with the address split into street, city, state, postal code and country.2 credits per call
- Google Maps Searchmaps.searchSearch Google Maps for places matching a query in a free-text location and get up to 20 normalised places with rating, address, phone, website and coordinates.2 credits per call
Knowledge & Data
- GitHub Repositorygithub.repositoryMetadata of one public GitHub repository: stars, forks, watchers, language, license, topics and timestamps.1 credit per call
- GitHub Trending Repositoriesgithub.trending_repositoriesRepositories on GitHub Trending for a language and window, with rank, stars, stars gained and description.1 credit per call
- GitHub Usergithub.userPublic profile of a GitHub user or organization: name, bio, company, location, followers and repository counts.1 credit per call
- GitHub User Repositoriesgithub.user_repositoriesA GitHub user's or organization's public repositories with stars, forks, language and dates, sortable and paged.1 credit per call
- GitHub Trending Developersgithub.trending_developersTrending GitHub developers for a language and time range, with each developer’s most popular repository.planned
- GitHub User Activitygithub.user_activityMonthly summary of a GitHub user’s public contributions (commits, pull requests and issues) for a given year.planned
Video
E-commerce
- TikTok Shop Creator Showcasetiktok-shop.user_showcaseThe TikTok Shop products a creator promotes in their profile showcase, with price, discount, rating and units sold.3 credits per call
- TikTok Shop Producttiktok-shop.productFull detail of one TikTok Shop product page: title, images, price and discount, rating, units sold, seller and variants.2 credits per call
- TikTok Shop Product Reviewstiktok-shop.product_reviewsCustomer reviews of a TikTok Shop product, page by page: rating, text, photos, variant, country and verified-purchase flag.2 credits per call
- TikTok Shop Searchtiktok-shop.searchTikTok Shop products matching a keyword in one country store, with price, discount, rating, units sold and seller.2 credits per call
- TikTok Shop Store Productstiktok-shop.shop_productsProducts listed by one TikTok Shop store, with price, discount, rating and units sold per product plus store-level stats.2 credits per call
- TikTok Shop Categoriestiktok-shop.categoriesThe TikTok Shop category tree for a market: top-level categories with ids, names and images, each with its children.planned
- TikTok Shop Creator Analyticstiktok-shop.creatorAffiliate performance of a TikTok Shop creator: GMV range, promoted products, audience demographics and engagement.planned
Validation
- Email Authentication Checkemail.auth_checkGrades a domain's MX, SPF (counting the 10-lookup limit), DMARC, DKIM and BIMI records, says whether the domain can be spoofed and lists fixes.1 credit per call
- Email Verificationemail.verifyDeliverability verdict (good, risky or bad) for one email address, with catch-all, disposable, role and free-provider signals and a confidence score.1 credit per call
- Phone Intelligencephone.intelligenceValidates a phone number and returns its E.164, national and international formats, country, calling code and line type.1 credit per call
- Phone Number Typephone.number_typeClassifies a phone number as mobile, landline, VoIP, toll-free, premium-rate and so on from numbering-plan data, with a validity check.1 credit per call
Compliance & Records
Web Intelligence
- Facebook Ad Creative Detailsfacebook.ad_details_fullOne Meta Ad Library ad with its full creative: every carousel card or version, image and video URL, headline, body and CTA.2 credits per call
- Facebook Ad Detailsfacebook.ad_detailsOne Meta Ad Library ad by id or URL: advertiser, creative text, call to action, platforms, run dates and media.2 credits per call
- Facebook Ad Library Advertiser Searchfacebook.search_companiesFind Meta Ad Library advertisers by name and get their page ids, category, verification and linked Instagram account.2 credits per call
- Facebook Ad Library Searchfacebook.ads_searchSearch the Meta Ad Library by keyword with country, status, media, date and sort filters; returns matching ads with cursor pagination.1 credit per call
- Facebook Company Adsfacebook.company_adsThe ads one advertiser runs in the Meta Ad Library, by Ad Library page id or company name, with filters and cursor pagination.2 credits per call
- Facebook Event Detailsfacebook.event_detailsFull details of one public Facebook event by id or URL: schedule, venue with coordinates, hosts, description and attendance.2 credits per call
- Facebook Events by Cityfacebook.eventsPublic Facebook events for a city or place from its events-explore URL: name, date, venue and going / interested counts.2 credits per call
- Facebook Events Searchfacebook.events_searchKeyword search over public Facebook events returning name, schedule, venue, price range and attendance counts.2 credits per call
- Facebook Group Postsfacebook.group_postsRecent posts of a public Facebook group by URL, with sort order and cursor pagination: text, author, reaction and comment counts.2 credits per call
- Facebook Marketplace Itemfacebook.marketplace_itemFull details of one Facebook Marketplace listing by id or URL: title, description, price, location, photos, condition and status.2 credits per call
- Facebook Marketplace Searchfacebook.marketplaceSearch Facebook Marketplace listings by keyword near a latitude/longitude with price, condition, delivery, recency and availability filters.2 credits per call
- Facebook Page Contact InfoRestrictedfacebook.page_contactPublic contact details of a Facebook page (email, phone, website, address, price range, rating) by URL, handle or page id.2 credits per call
- Facebook Page Eventsfacebook.profile_eventsEvents hosted by a public Facebook page by URL: name, start time, venue, city, host and status, with cursor pagination.2 credits per call
- Facebook Page Lookup by Namefacebook.page_lookupResolve a brand or page name to up to 7 matching Facebook pages with id, URL, picture and verified flag.2 credits per call
- Facebook Page Photosfacebook.photosRecent photos of a public Facebook page by URL: image URL, thumbnail, size, caption and photo id, with cursor pagination.2 credits per call
- Facebook Page Postsfacebook.profile_postsRecent public posts of a Facebook page by URL or page id, with cursor pagination: text, time, reactions, comments and media.2 credits per call
- Facebook Page Profilefacebook.profilePublic profile of a Facebook page by URL or handle: name, category, intro, followers, likes, website and Ad Library page id.2 credits per call
- Facebook Page Reelsfacebook.profile_reelsReels of a public Facebook page by URL with cursor pagination: caption, view count, thumbnail, video URL and permalink.2 credits per call
- Facebook Page Searchfacebook.search_pagesSearch Facebook pages by keyword, optionally near a place, and get page profiles with category, followers and contact fields.6.25 credits per result
- Facebook Postfacebook.postOne public Facebook post or reel by URL: text, author, likes, comments, shares, views, video URL and duration.2 credits per call
- Facebook Post Commentsfacebook.post_commentsTop-level comments of a public Facebook post or reel with cursor pagination: text, author, reactions and reply count.2 credits per call
- Facebook Post Searchfacebook.search_postsKeyword search over public Facebook posts, optionally by date range and place, with post text, author and engagement counts.3.24 credits per result
- Facebook Post Transcriptfacebook.post_transcriptSpoken-word transcript of a public Facebook video post or reel by URL (native captions first, AI for clips up to 2 minutes).2 credits per call
- Facebook Followers / Following ListRestrictedfacebook.followersList the public followers of a Facebook page or profile, or the accounts it follows, as id, name, URL and picture.planned
- TikTok Ad Library Adtiktok.ad_library_adFull details of one TikTok ad by id or URL: brand, ad text, objective, countries, CTR and spend bucket, engagement, landing page and video.2 credits per call
- TikTok Ad Library Searchtiktok.ad_library_searchSearch TikTok's public Ads Library (Commercial Content Library) by keyword or advertiser: advertiser, format, run dates, audience band, library link and video.3 credits per call
- TikTok Ad Transparency Searchtiktok.ad_transparency_searchSearch TikTok's EU Commercial Content Library (ad transparency) by keyword, optionally narrowed to one advertiser id, region and sort order.3 credits per call
- TikTok Audience Demographicstiktok.audience_demographicsWhere a TikTok creator's followers are located: follower count and percentage share per country, by handle.62 credits per call
- TikTok Comment Repliestiktok.comment_repliesReplies to one TikTok comment, with text, likes, language and replier details, paginated by cursor.2 credits per call
- TikTok Followerstiktok.followersPage of accounts that follow a public TikTok profile, with each follower’s handle, name, bio and counts.2 credits per call
- TikTok Followingtiktok.followingPage of accounts a public TikTok profile follows, with each account’s handle, display name, bio and counts.2 credits per call
- TikTok Hashtag Searchtiktok.search_hashtagTikTok videos posted under a hashtag, as TikTok ranks them, with captions, authors and engagement counts.3 credits per call
- TikTok Hashtag Videostiktok.hashtag_videosRecent TikTok videos posted under a hashtag, with caption, creator, sound and view, like, comment and share counts.3 credits per call
- TikTok Keyword Searchtiktok.search_keywordTikTok videos matching a keyword, sortable by relevance, likes or date and filterable by posting window.2 credits per call
- TikTok Livetiktok.liveWhether a TikTok creator is live right now and, if so, the live room title, viewers, entries and start time, by handle.2 credits per call
- TikTok Photostiktok.photosEvery image of a public TikTok photo-mode (slideshow) post, in order, with the caption, author and engagement counts.2 credits per call
- TikTok Playlist Videostiktok.playlist_videosVideos inside one public TikTok playlist (collection), in playlist order, with view, like and comment counts.2 credits per call
- TikTok Profiletiktok.profilePublic profile of one TikTok account: bio, follower, like and video counts, verification, link in bio and stable ids.2 credits per call
- TikTok Profile Contact InfoRestrictedtiktok.profile_contactPublic contact emails of a TikTok creator, read from the bio and the linked website, each labelled with its source.3 credits per call
- TikTok Profile Regiontiktok.profile_regionCountry code TikTok associates with an account, looked up by handle.2 credits per call
- TikTok Profile Repoststiktok.profile_repostsVideos a public TikTok account has reposted to its profile, with the original creator and engagement counts.2 credits per call
- TikTok Profile Videostiktok.profile_videosOne page of the public videos a TikTok account has posted, newest or most popular first, with engagement counts.2 credits per call
- TikTok Search Suggestionstiktok.search_suggestionsSearch terms TikTok suggests for a seed keyword, with language and relative weight: what users type around a topic.2 credits per call
- TikTok Songtiktok.songDetails of a TikTok sound by clip id: title, artist, album, duration, cover art and how many videos use it.2 credits per call
- TikTok Song Videostiktok.song_videosOne page of TikTok videos that use a given sound, with captions, authors and engagement counts.2 credits per call
- TikTok Top Ads Searchtiktok.top_ads_searchSearch TikTok Creative Center top-performing video ads by brand or product keyword, with objective, period and performance filters.2 credits per call
- TikTok Top Searchtiktok.search_topResults of TikTok's "Top" search tab for a keyword: videos and photo carousels with captions and engagement counts.2 credits per call
- TikTok Trending Feedtiktok.trending_feedA fresh sample of TikTok's For You feed as served from one country, with caption, author and engagement per video.3 credits per call
- TikTok Trending Hashtagstiktok.trending_hashtagsTikTok Creative Center's trending hashtag board for one market and industry, with post counts, views and a daily popularity curve.2 credits per call
- TikTok User Searchtiktok.search_usersTikTok accounts matching a name or keyword, with handles, ids, follower counts and linked profiles.2 credits per call
- TikTok Videotiktok.videoCaption, author, sound, engagement counts and a playable media URL for one public TikTok video or photo post.1 credit per call
- TikTok Video Commentstiktok.video_commentsTop-level comments on a public TikTok video or photo post, with author, likes and reply counts, page by page.2 credits per call
- TikTok Video Downloadtiktok.video_downloadDirect media links for a public TikTok video: the no-watermark MP4, the watermarked MP4 and the cover, with size and duration.1 credit per call
- TikTok Video Transcripttiktok.video_transcriptThe caption track TikTok already has for a public video, flattened to plain text with timed segments when available.2 credits per call
- TikTok Video Transcript (Speech to Text)tiktok.video_transcript_fullSpeech-to-text transcript of a public TikTok video with timed segments and optional word timings, billed per started audio minute.3 credits per call
- TikTok Photo Searchtiktok.search_photosSearch TikTok photo-mode (slideshow) posts by keyword, with every image of each post and its engagement counts.planned
- TikTok Profile Playliststiktok.profile_playlistsThe playlists a TikTok creator has published on their profile, with name, video count and cover image.planned
- TikTok User Storiestiktok.user_storiesA TikTok creator's currently active public stories: video or photo links, posting and expiry times and engagement counts.planned
Audio
- Spotify Albumspotify.albumA Spotify album by URL or ID with its tracklist, per-track play counts, album total, label and release date.5 credits per call
- Spotify Artistspotify.artistA Spotify artist by URL or ID: followers, monthly listeners, world rank, top cities, top tracks with play counts and releases.2 credits per call
- Spotify Play Countspotify.play_countLifetime stream counts for a Spotify track, every track of an album, or an artist's top tracks, from one URL.1.13 credits per result
- Spotify Podcastspotify.podcastA Spotify podcast show by URL or ID: name, publisher, description, artwork, episode count and languages.2 credits per call
- Spotify Trackspotify.trackOne Spotify track by URL or ID: lifetime play count, popularity, duration, artists and album details.2 credits per call
Web Scraping
Missing an API you need? Ask for it; the request takes a minute and needs no account.