# LurkAPI

> Social media data API: one GET request returns clean JSON from public Facebook, Reddit, YouTube, TikTok, Google, Bluesky, Snapchat, Truth Social, Telegram, X (Twitter), Threads, Instagram, LinkedIn and Link-in-bio pages. Works inside Claude as an MCP connector. Endpoints cost 1–5 credits per call, from $0.199 per 1,000 credits.

- **Base URL:** `https://api.lurkapi.com`
- **Auth:** `x-api-key: lk_live_…` header (or `Authorization: Bearer lk_live_…`). [Get a free key](https://lurkapi.com/login?next=/dashboard): 100 free credits on signup, no card.
- **Requests:** `GET` with query parameters. Responses are JSON with `success`, `credits_remaining` and the data at the top level; errors add `code` and `docs`.
- **Price:** Endpoints cost 1–5 credits per call, from $0.199 per 1,000 credits. Validation errors, `401`/`402`/`429` rejections and `5xx` failures are free; `not_found` is charged ([how charging works](https://lurkapi.com/docs.md#credits)). Every response has `credits_charged` and `credits_remaining`; `GET /v1/account/credit-balance` is free.
- **Rate limit:** 50 requests per 10 seconds per account (100 for high-volume accounts: support@lurkapi.com); over it, `429 rate_limited` with `retry-after`.
- **Agents:** getting a key needs a human sign-in. Ask your user to sign in at https://lurkapi.com/login and paste the key from the dashboard.
- **MCP server:** `https://api.lurkapi.com/mcp` (Streamable HTTP). Add `platforms` to pick what Claude sees (recommended): `https://api.lurkapi.com/mcp?platforms=facebook,reddit,youtube,tiktok,google,bluesky,snapchat,truthsocial,telegram,twitter,threads,instagram,linkedin,linkinbio` gives one tool per endpoint of those platforms, plus the free account tool. Platform ids: `facebook`, `reddit`, `youtube`, `tiktok`, `google`, `bluesky`, `snapchat`, `truthsocial`, `telegram`, `twitter`, `threads`, `instagram`, `linkedin` and `linkinbio`. Without it you get one tool per endpoint up to 25 endpoints; past that, two tools: `find_endpoints` to search the catalog and `call_endpoint` to run one, charged the same. Tool results skip nulls and empty lists to save tokens, and `trim` defaults to `true` where an endpoint has it.
- **Machine-readable:** [/openapi.json](https://lurkapi.com/openapi.json), [/llms.txt](https://lurkapi.com/llms.txt), [/llms-full.txt](https://lurkapi.com/llms-full.txt), and every docs page as markdown at its URL + `.md`.

## Docs

- [Quickstart](https://lurkapi.com/docs.md): Try it live, Connect to Claude, Make your first request, Authentication, Responses, Credits, Errors, Rate limits, Pagination, Caching and freshness, All endpoints, For AI agents
- [Migrating from another provider](https://lurkapi.com/docs/switching.md): Paths follow the /v1/<platform>/… pattern with an x-api-key header, so most clients only change the base URL and key. Every difference, listed.

## Facebook

- [Facebook overview](https://lurkapi.com/docs/facebook.md): Ads running on Facebook and Instagram, from Meta's Ad Library: copy, creative, landing page, dates and platforms.
- [Search Ad Library ads](https://lurkapi.com/docs/facebook/search-ads.md): Find ads in Meta's Ad Library by keyword, with their copy, media, landing page and run dates. `GET /v1/facebook/adLibrary/search/ads`, 1 credit, MCP tool `facebook_search_ads`.
- [Ad Library ads by company](https://lurkapi.com/docs/facebook/company-ads.md): Every ad one advertiser is running (or ran) on Facebook and Instagram, from Meta's Ad Library. `GET /v1/facebook/adLibrary/company/ads`, 1 credit, MCP tool `facebook_company_ads`.
- [Ad Library ad details](https://lurkapi.com/docs/facebook/ad.md): Full detail for one ad from Meta's Ad Library, by its id or URL. `GET /v1/facebook/adLibrary/ad`, 1 credit, MCP tool `facebook_ad`.
- [Search Ad Library companies](https://lurkapi.com/docs/facebook/search-companies.md): Find an advertiser's Facebook page id by name in Meta's Ad Library, with followers and linked Instagram. `GET /v1/facebook/adLibrary/search/companies`, 1 credit, MCP tool `facebook_search_companies`.
- [Public profile](https://lurkapi.com/docs/facebook/profile.md): A Facebook Page's or public person's name, pictures, verification and follower counts. `GET /v1/facebook/profile`, 1 credit, MCP tool `facebook_profile`.
- [Public post](https://lurkapi.com/docs/facebook/post.md): A public post's text, author, engagement counts and attached media. `GET /v1/facebook/post`, 1 credit, MCP tool `facebook_post`.

## Reddit

- [Reddit overview](https://lurkapi.com/docs/reddit.md): Posts, comments, search and community stats from any public subreddit.
- [Subreddit posts](https://lurkapi.com/docs/reddit/subreddit-posts.md): A subreddit's feed (hot, new, top, rising or best), with titles, text, scores and comment counts. `GET /v1/reddit/subreddit`, 1 credit, MCP tool `reddit_subreddit_posts`.
- [Subreddit details](https://lurkapi.com/docs/reddit/subreddit-details.md): A community's size, activity, description, rules and images. `GET /v1/reddit/subreddit/details`, 1 credit, MCP tool `reddit_subreddit_details`.
- [Subreddit search](https://lurkapi.com/docs/reddit/subreddit-search.md): Search one subreddit's posts by keyword, returned as compact result cards. `GET /v1/reddit/subreddit/search`, 1 credit, MCP tool `reddit_subreddit_search`.
- [Search Reddit](https://lurkapi.com/docs/reddit/search.md): Search all of Reddit for posts matching a keyword. `GET /v1/reddit/search`, 1 credit, MCP tool `reddit_search`.
- [Post comments](https://lurkapi.com/docs/reddit/post-comments.md): A Reddit post and its comment thread, with nested replies. `GET /v1/reddit/post/comments`, 1 credit, MCP tool `reddit_post_comments`.

## YouTube

- [YouTube overview](https://lurkapi.com/docs/youtube.md): Videos, Shorts, transcripts, comments and channel stats from any public YouTube channel.
- [Video details](https://lurkapi.com/docs/youtube/video.md): A video's or Short's title, description, exact views and likes, publish date, length, tags, chapters and channel. `GET /v1/youtube/video`, 1 credit, MCP tool `youtube_video`.
- [Video transcript](https://lurkapi.com/docs/youtube/transcript.md): What's said in a video or Short: its captions as timed segments and as one block of text. `GET /v1/youtube/video/transcript`, 1 credit, MCP tool `youtube_transcript`.
- [Video comments](https://lurkapi.com/docs/youtube/comments.md): A video's comments, top or newest first, with likes, reply counts and who wrote them. `GET /v1/youtube/video/comments`, 1 credit, MCP tool `youtube_comments`.
- [Comment replies](https://lurkapi.com/docs/youtube/comment-replies.md): The replies to one YouTube comment. `GET /v1/youtube/video/comment/replies`, 1 credit, MCP tool `youtube_comment_replies`.
- [Channel details](https://lurkapi.com/docs/youtube/channel.md): A channel's subscribers, total views, video count, join date, country, links and description. `GET /v1/youtube/channel`, 1 credit, MCP tool `youtube_channel`.
- [Channel videos](https://lurkapi.com/docs/youtube/channel-videos.md): A channel's videos, newest or most popular first, with views, length and upload time. `GET /v1/youtube/channel-videos`, 1 credit, MCP tool `youtube_channel_videos`.
- [Channel Shorts](https://lurkapi.com/docs/youtube/channel-shorts.md): A channel's Shorts, newest or most popular first, with titles and view counts. `GET /v1/youtube/channel/shorts`, 1 credit, MCP tool `youtube_channel_shorts`.
- [Search YouTube](https://lurkapi.com/docs/youtube/search.md): Search YouTube by keyword for videos, Shorts, channels and playlists, with date, length and type filters. `GET /v1/youtube/search`, 1 credit, MCP tool `youtube_search`.

## TikTok

- [TikTok overview](https://lurkapi.com/docs/tiktok.md): Profiles, videos, transcripts and comments from any public TikTok account.
- [Profile](https://lurkapi.com/docs/tiktok/profile.md): A creator's bio, avatar, verification and exact follower, like and video counts. `GET /v1/tiktok/profile`, 1 credit, MCP tool `tiktok_profile`.
- [Video details](https://lurkapi.com/docs/tiktok/video.md): One video or photo post: caption, stats, author, sound, hashtags and a playable MP4 URL. `GET /v2/tiktok/video`, 1 credit, MCP tool `tiktok_video`.
- [Video transcript](https://lurkapi.com/docs/tiktok/transcript.md): What's said in a video, from TikTok's captions: WEBVTT with timestamps plus plain text. `GET /v1/tiktok/video/transcript`, 1 credit; 5 if speech-to-text runs, MCP tool `tiktok_transcript`.
- [Profile videos](https://lurkapi.com/docs/tiktok/profile-videos.md): A creator's videos and photo posts, newest first, up to 15 per page. `GET /v3/tiktok/profile/videos`, 1 credit, MCP tool `tiktok_profile_videos`.
- [Video comments](https://lurkapi.com/docs/tiktok/comments.md): A video's top-level comments, most relevant first, with like and reply counts. `GET /v1/tiktok/video/comments`, 1 credit, MCP tool `tiktok_comments`.
- [Comment replies](https://lurkapi.com/docs/tiktok/comment-replies.md): The replies under one comment, oldest first. `GET /v1/tiktok/video/comment/replies`, 1 credit, MCP tool `tiktok_comment_replies`.
- [Hashtag videos](https://lurkapi.com/docs/tiktok/hashtag-videos.md): Videos posted with a hashtag, plus how big the hashtag is: total posts and views. `GET /v1/tiktok/search/hashtag`, 1 credit, MCP tool `tiktok_hashtag_videos`.
- [Song](https://lurkapi.com/docs/tiktok/song.md): A TikTok sound: title, artist, album, length, cover, audio URL and how many videos use it. `GET /v1/tiktok/song`, 1 credit, MCP tool `tiktok_song`.
- [Song videos](https://lurkapi.com/docs/tiktok/song-videos.md): Videos that use a sound, 30 per page, with stats and creators. `GET /v1/tiktok/song/videos`, 1 credit, MCP tool `tiktok_song_videos`.
- [Search TikTok Ad Library](https://lurkapi.com/docs/tiktok/ad-library-search.md): Ads shown in the EU, the UK, Switzerland and Turkey that match a keyword or an advertiser, 12 per page. `GET /v1/tiktok/ad-library/search`, 1 credit, MCP tool `tiktok_ad_library_search`.
- [TikTok Ad Library ad](https://lurkapi.com/docs/tiktok/ad-library-ad.md): One ad from TikTok's EU Ad Library: creative, landing page, advertiser, who paid, targeting and reach by country, age and gender. `GET /v1/tiktok/ad-library/ad`, 1 credit, MCP tool `tiktok_ad_library_ad`.
- [Live status](https://lurkapi.com/docs/tiktok/live.md): Whether a public creator is live, with the current room title, viewers and start time. `GET /v1/tiktok/user/live`, 1 credit, MCP tool `tiktok_live`.
- [Public stories](https://lurkapi.com/docs/tiktok/stories.md): A creator's active public stories, with captions, media and expiration times. `GET /v1/tiktok/user/stories`, 1 credit, MCP tool `tiktok_stories`.
- [TikTok Shop product](https://lurkapi.com/docs/tiktok/product.md): A US TikTok Shop product's price, images, seller, variants, sales and review totals. `GET /v1/tiktok/product`, 1 credit, MCP tool `tiktok_product`.

## Google

- [Google overview](https://lurkapi.com/docs/google.md): Ads running on Google Search, YouTube, Maps, Play and Shopping, from Google's Ads Transparency Center.
- [Search Google advertisers](https://lurkapi.com/docs/google/search-advertisers.md): Find an advertiser's Google Ads id by brand name, with how many ads they run, plus matching websites. `GET /v1/google/adLibrary/advertisers/search`, 1 credit, MCP tool `google_search_advertisers`.
- [Google ads by company](https://lurkapi.com/docs/google/company-ads.md): Every ad an advertiser or website runs on Google Search, YouTube, Maps, Play and Shopping, from the Ads Transparency Center. `GET /v1/google/company/ads`, 1 credit, MCP tool `google_company_ads`.
- [Google ad details](https://lurkapi.com/docs/google/ad.md): One ad from Google's Ads Transparency Center: every version of the creative, where it ran and, for political ads, spend and targeting. `GET /v1/google/ad`, 1 credit, MCP tool `google_ad`.

## Bluesky

- [Bluesky overview](https://lurkapi.com/docs/bluesky.md): Profiles, posts and full threads from any public Bluesky account.
- [Profile](https://lurkapi.com/docs/bluesky/profile.md): An account's bio, avatar, banner and exact follower, following and post counts. `GET /v1/bluesky/profile`, 1 credit, MCP tool `bluesky_profile`.
- [User posts](https://lurkapi.com/docs/bluesky/user-posts.md): An account's latest posts and reposts, newest first, with text, media and engagement counts. `GET /v1/bluesky/user/posts`, 1 credit, MCP tool `bluesky_user_posts`.
- [Post](https://lurkapi.com/docs/bluesky/post.md): A post with its replies (three levels deep) and the posts it replies to. `GET /v1/bluesky/post`, 1 credit, MCP tool `bluesky_post`.

## Snapchat

- [Snapchat overview](https://lurkapi.com/docs/snapchat.md): Public profiles, live stories, highlights and Spotlight videos from Snapchat.
- [Profile and stories](https://lurkapi.com/docs/snapchat/profile.md): A public profile with its live story, highlights and Spotlight videos, with direct media links. `GET /v1/snapchat/profile`, 1 credit, MCP tool `snapchat_profile`.

## Truth Social

- [Truth Social overview](https://lurkapi.com/docs/truthsocial.md): Profiles and posts from public Truth Social accounts.
- [Profile](https://lurkapi.com/docs/truthsocial/profile.md): An account's bio, avatar, follower and post counts, and verification. `GET /v1/truthsocial/profile`, 1 credit, MCP tool `truthsocial_profile`.
- [User posts](https://lurkapi.com/docs/truthsocial/user-posts.md): An account's latest posts and ReTruths, newest first, 20 per page. `GET /v1/truthsocial/user/posts`, 1 credit, MCP tool `truthsocial_user_posts`.
- [Post](https://lurkapi.com/docs/truthsocial/post.md): One post with its text, media, link preview and engagement counts. `GET /v1/truthsocial/post`, 1 credit, MCP tool `truthsocial_post`.

## Telegram

- [Telegram overview](https://lurkapi.com/docs/telegram.md): Public channel profiles, their posts and single posts, with views, media and reactions.
- [Channel](https://lurkapi.com/docs/telegram/channel.md): A public channel's name, bio, photo, exact subscriber count and media counts. `GET /v1/telegram/channel`, 1 credit, MCP tool `telegram_channel`.
- [Channel posts](https://lurkapi.com/docs/telegram/channel-posts.md): A public channel's latest posts, newest first, with text, views, media, links and reactions. `GET /v1/telegram/channel/posts`, 1 credit, MCP tool `telegram_channel_posts`.
- [Post](https://lurkapi.com/docs/telegram/post.md): One public channel post by link, with text, views, media, links and reactions. `GET /v1/telegram/post`, 1 credit, MCP tool `telegram_post`.

## X (Twitter)

- [X (Twitter) overview](https://lurkapi.com/docs/twitter.md): Tweets, profiles and recent posts from any public X account.
- [Tweet](https://lurkapi.com/docs/twitter/tweet.md): One tweet: text, author, likes, replies, reposts, quotes, bookmarks, views, media and the tweet it quotes. `GET /v1/twitter/tweet`, 1 credit, MCP tool `twitter_tweet`.
- [Profile](https://lurkapi.com/docs/twitter/profile.md): An account's bio, avatar, verification and exact follower, following, tweet and like counts. `GET /v1/twitter/profile`, 1 credit, MCP tool `twitter_profile`.
- [User tweets](https://lurkapi.com/docs/twitter/user-tweets.md): An account's tweets and retweets, about 20 per page, with text, media and engagement counts. `GET /v1/twitter/user-tweets`, 1 credit, MCP tool `twitter_user_tweets`.

## Threads

- [Threads overview](https://lurkapi.com/docs/threads.md): Public profiles, paginated account posts and individual Threads posts.
- [Threads profile](https://lurkapi.com/docs/threads/profile.md): Public profile biography, links, follower count and account metadata. `GET /v1/threads/profile`, 1 credit, MCP tool `threads_profile`.
- [Threads account posts](https://lurkapi.com/docs/threads/user-posts.md): One page of a public account's Threads posts, with text, media and engagement. `GET /v1/threads/user/posts`, 1 credit, MCP tool `threads_user_posts`.
- [Threads post](https://lurkapi.com/docs/threads/post.md): The text, author, media and engagement of one public Threads post. `GET /v1/threads/post`, 1 credit, MCP tool `threads_post`.

## Instagram

- [Instagram overview](https://lurkapi.com/docs/instagram.md): Public profiles, posts, reels and comments with media and engagement counts.
- [Profile](https://lurkapi.com/docs/instagram/profile.md): A public profile's biography, links and follower counts. `GET /v1/instagram/profile`, 1 credit, MCP tool `instagram_profile`.
- [User posts](https://lurkapi.com/docs/instagram/user-posts.md): A page of public posts with captions, media and engagement counts. `GET /v2/instagram/user/posts`, 1 credit, MCP tool `instagram_user_posts`.
- [Post](https://lurkapi.com/docs/instagram/post.md): A public photo, carousel, video or reel with its caption and counts. `GET /v1/instagram/post`, 1 credit, MCP tool `instagram_post`.
- [Post comments](https://lurkapi.com/docs/instagram/post-comments.md): A page of public comments with authors, timestamps and likes. `GET /v2/instagram/post/comments`, 1 credit, MCP tool `instagram_post_comments`.
- [User reels](https://lurkapi.com/docs/instagram/user-reels.md): A page of public reel previews with play, like and comment counts. `GET /v1/instagram/user/reels`, 1 credit, MCP tool `instagram_user_reels`.
- [Media transcript](https://lurkapi.com/docs/instagram/media-transcript.md): Transcribe speech from a public Instagram video or reel. `GET /v2/instagram/media/transcript`, 1 credit; 5 if speech-to-text runs, MCP tool `instagram_media_transcript`.

## LinkedIn

- [LinkedIn overview](https://lurkapi.com/docs/linkedin.md): Public company pages, their latest updates and ads from LinkedIn's Ad Library.
- [LinkedIn company page](https://lurkapi.com/docs/linkedin/company.md): A company's public overview and latest updates. `GET /v1/linkedin/company`, 1 credit, MCP tool `linkedin_company`.
- [LinkedIn company posts](https://lurkapi.com/docs/linkedin/company-posts.md): Latest public updates from a company page, with text, engagement and media. `GET /v1/linkedin/company/posts`, 1 credit, MCP tool `linkedin_company_posts`.
- [Search LinkedIn ads](https://lurkapi.com/docs/linkedin/search-ads.md): Search LinkedIn's public Ad Library by advertiser or keyword. `GET /v1/linkedin/ads/search`, 1 credit, MCP tool `linkedin_search_ads`.
- [LinkedIn ad details](https://lurkapi.com/docs/linkedin/ad.md): One LinkedIn ad's creative, payer and public delivery disclosures. `GET /v1/linkedin/ad`, 1 credit, MCP tool `linkedin_ad`.

## Link-in-bio

- [Link-in-bio overview](https://lurkapi.com/docs/linkinbio.md): Linktree profiles, their public links and social destinations.
- [Linktree page](https://lurkapi.com/docs/linkinbio/linktree.md): A public Linktree profile, its link cards and listed social accounts. `GET /v1/linktree`, 1 credit, MCP tool `linkinbio_linktree`.

## Account

- [Account overview](https://lurkapi.com/docs/account.md): Your LurkAPI credit balance.
- [Credit balance](https://lurkapi.com/docs/account/credit-balance.md): Your credit balance and daily top-up. Free. `GET /v1/account/credit-balance`, free, MCP tool `account_credit_balance`.

## Optional

- [Everything in one file](https://lurkapi.com/llms-full.txt): every docs page linked above, plus pricing, in one file
- [OpenAPI 3.1 spec](https://lurkapi.com/openapi.json): every endpoint's parameters and response schema
- [Pricing](https://lurkapi.com/pricing.md): credit packs, free credits and the cost of every endpoint