# 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.

## What it is

LurkAPI turns public social pages into structured data for marketers and their AI tools. Connect it to Claude and ask in plain English, or call the REST API from code.

Try it free on the site without signing up (5 requests a day), then [get a free key](https://lurkapi.com/login?next=/dashboard).

## For developers and AI agents

- **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`.

curl:

```bash
curl "https://api.lurkapi.com/v1/facebook/adLibrary/search/ads?query=running+shoes&country=US&status=active" \
  -H "x-api-key: YOUR_API_KEY"
```

## Platforms and endpoints

### Facebook

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)
- [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)
- [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)
- [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)
- [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)
- [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)

### Reddit

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)
- [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)
- [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)
- [Search Reddit](https://lurkapi.com/docs/reddit/search.md): Search all of Reddit for posts matching a keyword. (GET /v1/reddit/search · 1 credit)
- [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)

### YouTube

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)
- [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)
- [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)
- [Comment replies](https://lurkapi.com/docs/youtube/comment-replies.md): The replies to one YouTube comment. (GET /v1/youtube/video/comment/replies · 1 credit)
- [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)
- [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)
- [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)
- [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)

### TikTok

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)
- [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)
- [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)
- [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)
- [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)
- [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)
- [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)
- [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)
- [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)
- [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)
- [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)
- [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)
- [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)
- [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)

### Google

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)
- [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)
- [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)

### Bluesky

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)
- [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)
- [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)

### Snapchat

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)

### Truth Social

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)
- [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)
- [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)

### Telegram

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)
- [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)
- [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)

### X (Twitter)

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)
- [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)
- [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)

### Threads

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)
- [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)
- [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)

### Instagram

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)
- [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)
- [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)
- [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)
- [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)
- [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)

### LinkedIn

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)
- [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)
- [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)
- [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)

### Link-in-bio

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)

### Account

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)

## Pricing

Endpoints cost 1–5 credits per call. Validation errors, `401`/`402`/`429` rejections and `5xx` failures are free; `not_found` is charged ([how charging works](https://lurkapi.com/docs.md#credits)).

- **Without an account:** 5 free requests a day from the playground and the free tools.
- **New accounts:** 100 free credits, no card needed.
- **Every day:** if your balance is under 25, it's topped back up to 25.
- **Credit packs:** one-off purchases, no subscription. Credits never expire.

| Pack | Credits | Price | Per 1,000 credits |
| --- | --- | --- | --- |
| Starter | 20,000 | $10.00 | $0.50 |
| Growth | 150,000 | $49.00 | $0.327 |
| Scale | 1,000,000 | $199.00 | $0.199 |

[Full pricing](https://lurkapi.com/pricing.md)

## Docs

- [Quickstart](https://lurkapi.com/docs.md): connect to Claude, first request, auth, credits, errors, rate limits
- [Migrating from another provider](https://lurkapi.com/docs/switching.md): what changes when you move an existing client
- [Pricing](https://lurkapi.com/pricing.md)