# PrimaryAPI > One API key and one balance of prepaid credits for pay-per-call data APIs: social, search and SEO, enrichment, e-commerce, maps, public records, validation, web scraping and more. Every call is routed to a healthy upstream and retried automatically when an attempt fails; you pay credits only for successful answers. - API base URL: https://api.primaryapi.com. Authenticate with `Authorization: Bearer pa_live_…` (or `X-API-Key`). - Call any API with `POST /v1/run/{sku}` and a JSON body matching its input schema (`GET /v1/apis/{sku}`, no key needed). Unknown input fields are rejected. - Success envelope: `{ output: { found, data, reason? }, provider, credits, items, requestId, nextCursor?, hint? }`; `credits` is what the call cost. `found: false` (does not exist, private, no results) is a successful, usually free answer, not an error. - Prices are in credits: most calls cost 1 or 2 credits, per call or per result (`price` in `GET /v1/apis/{sku}`). `POST /v1/quote/{sku}` returns `maxCredits`, the most a call can cost; the routing control `maxCredits` caps a call. - Errors: `{ code, error, requestId }`, never charged. A `202` means the call is still running: poll `GET /v1/requests/{id}` instead of calling again. - Agents without a key: `POST https://api.primaryapi.com/agent/signup` mints a capped trial key. On `402 trial_cap_reached`, give `upgrade.claimUrl` to a human. - MCP server (Streamable HTTP): https://api.primaryapi.com/mcp. Agent skill: https://primaryapi.com/SKILL.md - The catalog currently lists 200 APIs across 31 platforms in 10 categories. ## Docs - [Introduction](https://primaryapi.com/docs/md): One API key and one balance of credits for pay-per-call data APIs. The four ideas the rest of these docs build on. - [Quickstart](https://primaryapi.com/docs/md/quickstart): Get a key, make your first call with cURL, TypeScript or Python, and read the response envelope. - [Authentication](https://primaryapi.com/docs/md/authentication): Send your API key as a Bearer token or X-API-Key header. Access levels, spend limits and windows, expiry, rotation and paused keys. - [Making requests](https://primaryapi.com/docs/md/making-requests): Call any API with POST /v1/run/{sku}. Build the input from the schema, read the envelope, handle not-found results, and trim large responses with fields, max_items and summary. - [Pricing and billing](https://primaryapi.com/docs/md/pricing-and-billing): Credits and what a call costs, per call or per result, the price ceiling and holds, quotes, what is free, plans and what a credit costs, data retention by plan, buying credits, auto top-up and spend alerts, your balance, expiry and the three 402 errors. - [Routing and failover](https://primaryapi.com/docs/md/routing-and-failover): How each call is routed to a healthy upstream and retried automatically inside the same request, what the public reliability figures mean, and how to steer a call by cost and latency with maxCredits and preferLatencyUnderMs. - [Durable requests](https://primaryapi.com/docs/md/durable-requests): What a 202 means, how to choose the wait window with the Prefer header, how to poll GET /v1/requests/{id}, deadlines, and how long results are kept. - [Idempotency and retries](https://primaryapi.com/docs/md/idempotency): Send an Idempotency-Key so a retried call can never run or bill twice. Exactly what happens on replays, conflicts (409) and failed attempts, and which errors to retry. - [Pagination](https://primaryapi.com/docs/md/pagination): Walk through long results with opaque cursors, both in list and search APIs (cursor and nextCursor) and in account endpoints such as GET /v1/requests. - [Errors](https://primaryapi.com/docs/md/errors): One flat error shape for every endpoint, every error code with its HTTP status, causes and fix, and what to retry. Errors are never charged. - [Rate limits](https://primaryapi.com/docs/md/rate-limits): 200 requests per 10 seconds per key and 1,000 per minute per account, what a 429 looks like, how to back off with Retry-After, and the limits on keyless and trial endpoints. - [Monitors](https://primaryapi.com/docs/md/monitors): Run an API on a schedule with saved input and get the result at your webhook, when it changes or after every run. Credits, schedules, failures, your own ids, keys, run now, and the endpoints. - [Webhooks](https://primaryapi.com/docs/md/webhooks): Monitor webhooks, every delivery's attempt log, verifying the PrimaryAPI-Signature header in Node and Python, retries, redelivery, how long events are kept, and the signing secret. - [Agent self-signup](https://primaryapi.com/docs/md/agent-signup): An AI agent mints its own capped trial key with POST /agent/signup, uses it without a human, and hands a claim link to its human when the trial budget runs out. The agent keeps the same key. - [MCP server](https://primaryapi.com/docs/md/mcp-server): Connect Claude Code, Claude Desktop, Cursor, Codex, VS Code or any MCP client to the catalog. Ten tools to search, inspect, quote and run APIs, with the same prices, routing and errors as the REST API. - [SKILL.md and llms.txt](https://primaryapi.com/docs/md/skill-md): Teach a coding agent the whole workflow in one file, and give any model the docs as Markdown with llms.txt, llms-full.txt and per-page Markdown. - [Restricted APIs](https://primaryapi.com/docs/md/restricted-apis): Some APIs return sensitive personal data. Using them needs an approved account that accepted the permissible-purpose terms. How access works, what is not allowed, and how restricted calls are stored. - [Security and data handling](https://primaryapi.com/docs/md/security): How keys, sessions and upstream credentials are protected, what is stored for each call and for how long, how upstream calls are isolated, and how to report a vulnerability. - [Changelog](https://primaryapi.com/docs/md/changelog): Changes to the API, the MCP server, the agent files and these docs, newest first. ## Guides - [Truth Social API: what exists in 2026 and how to read public posts](https://primaryapi.com/guides/truth-social-api): Is there a Truth Social API? What Trump Media’s Truth API offers, what Truth Social’s Mastodon base means, and how to read public posts by code. - [Google Maps API pricing: SKUs, free caps and Places API costs](https://primaryapi.com/guides/google-maps-api-pricing): Google Maps API pricing explained: how SKUs, free monthly caps, volume tiers and plans work, what Places API requests cost, and when pay per call fits. - [How to get an X API key in 2026, and what it costs](https://primaryapi.com/guides/x-api-key): How to get an X API key: Developer Console steps, which credential you need, what Pay-Per-Use costs, the errors people hit, and a one-key alternative. - [How to get a Reddit API key in 2026, and what changed](https://primaryapi.com/guides/reddit-api-key): How to get Reddit API credentials in late 2026: app types, approval and commercial rules, rate limits, the 2027 cutoffs, and a one-key way to read Reddit. - [YouTube transcript API: what the Data API gives and what it doesn’t](https://primaryapi.com/guides/youtube-transcript-api): Is there a YouTube transcript API? What the Data API’s captions methods return, what they cost in quota, and how to get any public video’s transcript. - [Spotify Web API: what it offers now and what changed for developers](https://primaryapi.com/guides/spotify-web-api): What the Spotify Web API offers today, what Spotify changed for developers in 2026, how its quota modes work, and how to read public Spotify data instead. ## Free tools - [YouTube transcript](https://primaryapi.com/tools/youtube-transcript): The words of any public YouTube video, with timestamps. - [TikTok transcript](https://primaryapi.com/tools/tiktok-transcript): The captions of a public TikTok video as text. - [Instagram reel transcript](https://primaryapi.com/tools/instagram-reel-transcript): What is said in a public reel, as text. - [Facebook video transcript](https://primaryapi.com/tools/facebook-video-transcript): The words of a public Facebook video or reel. - [Twitter video transcript](https://primaryapi.com/tools/twitter-video-transcript): What is said in a video posted on X, as text. - [Video transcript generator](https://primaryapi.com/tools/video-transcript-generator): One box for YouTube, TikTok, Instagram, Facebook and X videos. - [Instagram profile viewer](https://primaryapi.com/tools/instagram-profile-viewer): Followers, posts, bio and links of any public account. - [Instagram story viewer](https://primaryapi.com/tools/instagram-story-viewer): Today’s stories from any public account, without signing in. - [Instagram highlights viewer](https://primaryapi.com/tools/instagram-highlights-viewer): The story highlights pinned to any public profile. - [TikTok viewer](https://primaryapi.com/tools/tiktok-viewer): Followers, likes and bio of any TikTok account. - [Twitter (X) viewer](https://primaryapi.com/tools/twitter-viewer): Followers, posts and bio of any X account. - [Snapchat viewer](https://primaryapi.com/tools/snapchat-viewer): Subscribers and bio of public Snapchat profiles. - [Threads viewer](https://primaryapi.com/tools/threads-viewer): Followers, bio and links of any Threads profile. - [Bluesky viewer](https://primaryapi.com/tools/bluesky-viewer): Followers, posts and bio of any Bluesky account. - [Facebook profile viewer](https://primaryapi.com/tools/facebook-profile-viewer): Followers, likes and details of any Facebook page. - [YouTube subscriber count](https://primaryapi.com/tools/youtube-subscriber-count): Subscribers, views and videos of any channel. - [Telegram channel viewer](https://primaryapi.com/tools/telegram-channel-viewer): Subscribers and details of public Telegram channels. - [Spotify artist stats](https://primaryapi.com/tools/spotify-artist-stats): Monthly listeners, followers and top cities of any artist. - [TikTok downloader](https://primaryapi.com/tools/tiktok-downloader): Save a public TikTok video, with or without the watermark. - [Instagram reel downloader](https://primaryapi.com/tools/instagram-reel-downloader): Save a public reel, video post or carousel. - [Twitter video downloader](https://primaryapi.com/tools/twitter-video-downloader): Save the video, GIF or photos of a post on X. - [Meta ad library](https://primaryapi.com/tools/meta-ad-library): The ads any brand runs on Facebook and Instagram. - [TikTok ad library](https://primaryapi.com/tools/tiktok-ad-library): The ads brands have shown on TikTok in Europe. - [CPM calculator](https://primaryapi.com/tools/cpm-calculator): Cost per thousand impressions, cost or reach: fill in two, get the third. - [YouTube money calculator](https://primaryapi.com/tools/youtube-money-calculator): What your views earn at your RPM, per day, month and year. - [TikTok money calculator](https://primaryapi.com/tools/tiktok-money-calculator): What paid videos earn at your rate, per video, month and year. - [Instagram money calculator](https://primaryapi.com/tools/instagram-money-calculator): What sponsored posts earn at your rate, per post, month and year. - [Engagement rate calculator](https://primaryapi.com/tools/engagement-rate-calculator): Likes, comments, shares and saves, by followers or by views. - [IP address lookup](https://primaryapi.com/tools/ip-address-lookup): Location, network and VPN checks for any IP. - [What is my IP](https://primaryapi.com/tools/what-is-my-ip): Your public IP address, its location and network. - [Email verifier](https://primaryapi.com/tools/email-verifier): Check that an email address is real before you send. - [DMARC checker](https://primaryapi.com/tools/dmarc-checker): Read and grade a domain’s DMARC record. - [SPF record checker](https://primaryapi.com/tools/spf-record-checker): See a domain’s SPF record and count its DNS lookups. - [DKIM checker](https://primaryapi.com/tools/dkim-checker): Find a domain’s DKIM keys and check their strength. - [MX lookup](https://primaryapi.com/tools/mx-lookup): Find the mail servers of any domain. - [Phone number lookup](https://primaryapi.com/tools/phone-number-lookup): Check a number’s country, line type and format. ## API reference - [API reference](https://primaryapi.com/docs/md/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. - [Run and quote](https://primaryapi.com/docs/md/api-reference/run): Reference for POST /v1/run/{sku} and POST /v1/quote/{sku}. Path, headers, query parameters, body, every response shape and status code. - [Requests and results](https://primaryapi.com/docs/md/api-reference/requests): Reference for GET /v1/requests, GET /v1/requests/{id} and GET /v1/results/{id}. List your calls, poll a running request and re-read stored results for free. - [API keys](https://primaryapi.com/docs/md/api-reference/keys): Reference for /v1/api-keys. List, create, read, update, disable, rotate and revoke keys, set spend limits and expiry, and read per-key usage. - [Balance and billing](https://primaryapi.com/docs/md/api-reference/balance): Reference for GET /v1/balance, the credit ledger, credit orders and packs, Stripe checkout, and GET /v1/workspace. - [Usage](https://primaryapi.com/docs/md/api-reference/usage): Reference for GET /v1/usage. Credits spent today, this week and this month, totals per API and a daily series, for the whole account or one key. - [Catalog and status](https://primaryapi.com/docs/md/api-reference/catalog): Reference for the public discovery endpoints (GET /v1/apis, /v1/apis/{sku}, /v1/catalog, /v1/categories, /v1/platforms, /openapi.json) and the status endpoints (GET /v1/status, /v1/status/apis). No key needed. - [Agents](https://primaryapi.com/docs/md/api-reference/agents): Reference for POST /agent/signup (self-service trial keys) and the claim endpoints a signed-in human uses to approve a trial key and its spend limit. - [Feedback](https://primaryapi.com/docs/md/api-reference/feedback): Reference for POST /v1/feedback, POST /v1/bug-reports and the public POST /v1/api-requests. Report problems, send feedback and ask for APIs that are missing. ## Social APIs - [Bluesky](https://primaryapi.com/docs/md/api-reference/bluesky): bluesky.post (1 credit per call), bluesky.profile (1 credit per call), bluesky.user_posts (1 credit per call) - [Hacker News](https://primaryapi.com/docs/md/api-reference/hackernews): hackernews.profile (1 credit per call), hackernews.search (1 credit per call), hackernews.story (1 credit per call), hackernews.story_comments (1 credit per call) - [Instagram](https://primaryapi.com/docs/md/api-reference/instagram): instagram.basic_profile (1 credit per call), instagram.comment_replies (1 credit per call), instagram.hashtag_recent_posts (1 credit per call), instagram.highlight_detail (1 credit per call), instagram.media_transcript (3 credits per call), instagram.post (1 credit per call), instagram.post_comments (1 credit per call), instagram.profile (1 credit per call), instagram.profile_contact (1 credit per call), instagram.search_profiles (1 credit per call), instagram.reel_transcript (4.38 credits per result), instagram.reels_search (1 credit per call), instagram.web_reels_search (1 credit per call), instagram.search (1 credit per call), instagram.similar_profiles (1 credit per call), instagram.stories_thin (3 credits per call), instagram.stories_full (3 credits per call), instagram.tagged_posts (1 credit per call), instagram.user_highlights (3 credits per call), instagram.user_posts (1 credit per call), instagram.user_reels (1 credit per call), instagram.hashtag_analytics (planned), instagram.search_hashtag (planned), instagram.location_posts (planned), instagram.search_locations (planned), instagram.embed (planned), instagram.search_profiles_contact (planned), instagram.audio_reels (planned), instagram.search_followers (planned), instagram.search_following (planned), instagram.trending_reels (planned), instagram.user_reposts (planned) - [Link-in-bio](https://primaryapi.com/docs/md/api-reference/linkinbio): linkinbio.lookup (1 credit per call) - [Naver](https://primaryapi.com/docs/md/api-reference/naver): naver.blog_search (planned) - [Nextdoor](https://primaryapi.com/docs/md/api-reference/nextdoor): nextdoor.business (planned), nextdoor.search (planned) - [Pinterest](https://primaryapi.com/docs/md/api-reference/pinterest): pinterest.search (2 credits per call) - [Reddit](https://primaryapi.com/docs/md/api-reference/reddit): reddit.post (2 credits per call), reddit.post_comments (2 credits per call), reddit.search (2 credits per call), reddit.subreddit_details (2 credits per call), reddit.subreddit_posts (2 credits per call), reddit.subreddit_search (2 credits per call), reddit.trending_posts (2 credits per call), reddit.user_posts (2 credits per call), reddit.search_accounts (planned), reddit.post_transcript (planned), reddit.user_comments (planned) - [RedNote](https://primaryapi.com/docs/md/api-reference/rednote): rednote.note (7 credits per call), rednote.note_comments (13 credits per call), rednote.profile (7 credits per call), rednote.search (13 credits per call), rednote.user_notes (13 credits per call), rednote.search_users (13 credits per call) - [Snapchat](https://primaryapi.com/docs/md/api-reference/snapchat): snapchat.profile (1 credit per call) - [Social](https://primaryapi.com/docs/md/api-reference/social): social.post_lookup (1 credit per call), social.profile_check (2 credits per call), social.search (planned), social.search_video (planned) - [Substack](https://primaryapi.com/docs/md/api-reference/substack): substack.posts (1 credit per call) - [Telegram](https://primaryapi.com/docs/md/api-reference/telegram): telegram.channel (1 credit per call), telegram.channel_posts (1 credit per call), telegram.post (1 credit per call) - [Threads](https://primaryapi.com/docs/md/api-reference/threads): threads.post (2 credits per call), threads.search (2 credits per call), threads.profile (2 credits per call), threads.user_posts (2 credits per call), threads.search_users (2 credits per call) - [Truth Social](https://primaryapi.com/docs/md/api-reference/truthsocial): truthsocial.post (2 credits per call), truthsocial.profile (2 credits per call), truthsocial.user_posts (2 credits per call) - [X / Twitter](https://primaryapi.com/docs/md/api-reference/twitter): twitter.tweet_transcript (3 credits per call), twitter.community (1 credit per call), twitter.community_tweets (2 credits per call), twitter.followers (2 credits per call), twitter.following (2 credits per call), twitter.tweet (1 credit per call), twitter.replies (2 credits per call), twitter.profile (1 credit per call), twitter.user_posts (2 credits per call), twitter.search_users (2 credits per call), twitter.search_communities (planned) - [YouTube](https://primaryapi.com/docs/md/api-reference/youtube): youtube.channel (1 credit per call), youtube.channel_lives (2 credits per call), youtube.channel_public_email (1 credit per call), youtube.search_channels (2 credits per call), youtube.channel_shorts (2 credits per call), youtube.channel_videos (1 credit per call), youtube.search_hashtag (2 credits per call), youtube.search (2 credits per call), youtube.search_shorts (2 credits per call), youtube.video (2 credits per call), youtube.video_comments (2 credits per call), youtube.video_transcript (2 credits per call), youtube.video_transcript_full (3 credits per call), youtube.channel_community_posts (planned), youtube.channel_contact (planned), youtube.channel_playlists (planned), youtube.comment_replies (planned), youtube.community_post (planned), youtube.playlist (planned), youtube.trending_shorts (planned), youtube.video_sponsors (planned) - [Zhihu](https://primaryapi.com/docs/md/api-reference/zhihu): zhihu.answer (2 credits per call), zhihu.search_articles (2 credits per call), zhihu.question (2 credits per call) ## Search & SEO APIs - [Google Maps](https://primaryapi.com/docs/md/api-reference/maps): maps.search_nearby (2 credits per call), maps.search (2 credits per call) ## Knowledge & Data APIs - [Banks (FDIC)](https://primaryapi.com/docs/md/api-reference/bank): bank.lookup (1 credit per call) - [GitHub](https://primaryapi.com/docs/md/api-reference/github): github.repository (1 credit per call), github.trending_repositories (1 credit per call), github.user (1 credit per call), github.user_repositories (1 credit per call), github.trending_developers (planned), github.user_activity (planned) ## Video APIs - [Video](https://primaryapi.com/docs/md/api-reference/video): video.transcript (2 credits per call) ## E-commerce APIs - [TikTok Shop](https://primaryapi.com/docs/md/api-reference/tiktok-shop): tiktok-shop.user_showcase (3 credits per call), tiktok-shop.product (2 credits per call), tiktok-shop.product_reviews (2 credits per call), tiktok-shop.search (2 credits per call), tiktok-shop.shop_products (2 credits per call), tiktok-shop.categories (planned), tiktok-shop.creator (planned) ## Validation APIs - [Email](https://primaryapi.com/docs/md/api-reference/email): email.auth_check (1 credit per call), email.verify (1 credit per call) - [Phone](https://primaryapi.com/docs/md/api-reference/phone): phone.intelligence (1 credit per call), phone.number_type (1 credit per call) ## Compliance & Records APIs - [Sanctions Lists](https://primaryapi.com/docs/md/api-reference/sanctions): sanctions.screen (1 credit per call) ## Web Intelligence APIs - [Ad Libraries](https://primaryapi.com/docs/md/api-reference/ads): ads.library_lookup (4 credits per call) - [Facebook](https://primaryapi.com/docs/md/api-reference/facebook): facebook.ad_details_full (2 credits per call), facebook.ad_details (2 credits per call), facebook.search_companies (2 credits per call), facebook.ads_search (1 credit per call), facebook.company_ads (2 credits per call), facebook.event_details (2 credits per call), facebook.events (2 credits per call), facebook.events_search (2 credits per call), facebook.group_posts (2 credits per call), facebook.marketplace_item (2 credits per call), facebook.marketplace (2 credits per call), facebook.page_contact (2 credits per call), facebook.profile_events (2 credits per call), facebook.page_lookup (2 credits per call), facebook.photos (2 credits per call), facebook.profile_posts (2 credits per call), facebook.profile (2 credits per call), facebook.profile_reels (2 credits per call), facebook.search_pages (6.25 credits per result), facebook.post (2 credits per call), facebook.post_comments (2 credits per call), facebook.search_posts (3.24 credits per result), facebook.post_transcript (2 credits per call), facebook.followers (planned) - [TikTok](https://primaryapi.com/docs/md/api-reference/tiktok): tiktok.ad_library_ad (2 credits per call), tiktok.ad_library_search (3 credits per call), tiktok.ad_transparency_search (3 credits per call), tiktok.audience_demographics (62 credits per call), tiktok.comment_replies (2 credits per call), tiktok.followers (2 credits per call), tiktok.following (2 credits per call), tiktok.search_hashtag (3 credits per call), tiktok.hashtag_videos (3 credits per call), tiktok.search_keyword (2 credits per call), tiktok.live (2 credits per call), tiktok.photos (2 credits per call), tiktok.playlist_videos (2 credits per call), tiktok.profile (2 credits per call), tiktok.profile_contact (3 credits per call), tiktok.profile_region (2 credits per call), tiktok.profile_reposts (2 credits per call), tiktok.profile_videos (2 credits per call), tiktok.search_suggestions (2 credits per call), tiktok.song (2 credits per call), tiktok.song_videos (2 credits per call), tiktok.top_ads_search (2 credits per call), tiktok.search_top (2 credits per call), tiktok.trending_feed (3 credits per call), tiktok.trending_hashtags (2 credits per call), tiktok.search_users (2 credits per call), tiktok.video (1 credit per call), tiktok.video_comments (2 credits per call), tiktok.video_download (1 credit per call), tiktok.video_transcript (2 credits per call), tiktok.video_transcript_full (3 credits per call), tiktok.search_photos (planned), tiktok.profile_playlists (planned), tiktok.user_stories (planned) ## Audio APIs - [Spotify](https://primaryapi.com/docs/md/api-reference/spotify): spotify.album (5 credits per call), spotify.artist (2 credits per call), spotify.play_count (1.13 credits per result), spotify.podcast (2 credits per call), spotify.track (2 credits per call) ## Web Scraping APIs - [Linktree](https://primaryapi.com/docs/md/api-reference/linktree): linktree.profile (1 credit per call) ## Optional - [Everything in one file](https://primaryapi.com/llms-full.txt): every guide and every API reference page as Markdown. - [OpenAPI 3.1](https://api.primaryapi.com/openapi.json): generated from the catalog, one operation per API. - [Catalog JSON](https://api.primaryapi.com/v1/catalog): every callable API with its price and measured 30-day health. - [Agent onboarding skill](https://primaryapi.com/agent-onboarding/SKILL.md): get a working key and connect an MCP client.