# Quickstart

> Social media data from Facebook, Reddit, YouTube, TikTok, Google, Bluesky, Snapchat, Truth Social, Telegram, X (Twitter), Threads, Instagram, LinkedIn and Link-in-bio, as clean JSON. Connect it to Claude and ask, or call it with one request.

- **Web page:** https://lurkapi.com/docs

## Try it live

Pick an endpoint and run it: real data, no signup, 5 free requests a day.

Live playground: https://lurkapi.com/docs#try

## Connect to Claude

Add LurkAPI to Claude once, then ask in plain English, like “Which ads is Allbirds running right now?” Claude picks the right endpoint, calls it and reads the results for you. Calls from Claude spend credits the same way API calls do.

### Claude on the web and desktop

1. [Get your free API key](https://lurkapi.com/login?next=/dashboard). Your dashboard shows your personal connector URL, with the key already in it.
2. In Claude, open **Settings → Connectors** and choose **Add custom connector**.
3. Name it `LurkAPI`, paste your connector URL and click **Add**.
4. In a chat, switch LurkAPI on from the tools menu and ask away.

The connector URL looks like `https://api.lurkapi.com/mcp?key=lk_live_…`. It contains your key, so treat it like a password.

[Get my connector URL](https://lurkapi.com/login?next=/dashboard)

### Pick your platforms

Add `platforms` to pick what Claude sees (recommended): `https://api.lurkapi.com/mcp?key=lk_live_…&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.

### Claude Code

Add it from your terminal. The key travels in a header instead of the URL.

Terminal:

```bash
claude mcp add --transport http lurkapi https://api.lurkapi.com/mcp \
  --header "x-api-key: YOUR_API_KEY"
```

### Cursor and other MCP clients

Most clients take a JSON config with a URL and headers:

mcp.json:

```json
{
  "mcpServers": {
    "lurkapi": {
      "url": "https://api.lurkapi.com/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}
```

Tools are named after the endpoint: `facebook_search_ads`, `linkinbio_linktree` and so on. Each endpoint page shows its tool name and an example prompt. Tool results skip nulls and empty lists to save tokens, and `trim` defaults to `true` where an endpoint has it.

## Make your first request

Every endpoint is a `GET` request with query parameters and your key in the `x-api-key` header. Here's [Search Ad Library ads](https://lurkapi.com/docs/facebook/search-ads.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"
```

JavaScript:

```js
const params = new URLSearchParams({
  query: "running shoes",
  country: "US",
  status: "active",
});
const res = await fetch(`https://api.lurkapi.com/v1/facebook/adLibrary/search/ads?${params}`, {
  headers: { "x-api-key": process.env.LURKAPI_KEY },
});
const data = await res.json();
if (!data.success) throw new Error(`${data.code}: ${data.error}`);
console.log(data.searchResults);
```

Python:

```python
import os
import requests

res = requests.get(
    "https://api.lurkapi.com/v1/facebook/adLibrary/search/ads",
    params={
        "query": "running shoes",
        "country": "US",
        "status": "active",
    },
    headers={"x-api-key": os.environ["LURKAPI_KEY"]},
    timeout=60,
)
data = res.json()
if not data["success"]:
    raise RuntimeError(f"{data['code']}: {data['error']}")
print(data["searchResults"])
```

Every endpoint page has these snippets with its own parameters, a real example response and a live playground.

## Authentication

Send your key in the `x-api-key` header. `Authorization: Bearer <key>` works too. Keys start with `lk_live_` and are shown once when you create them; create and revoke them in your [dashboard](https://lurkapi.com/dashboard).

For MCP, the key can also go in the URL as `?key=`, because Claude's custom connectors only take a URL.

Keys are secret. Call LurkAPI from a server or a script, not from a web page your visitors can inspect.

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

## Responses

A successful call returns `success: true`, what it cost in `credits_charged`, your balance after it in `credits_remaining`, and the endpoint's data at the top level:

200 OK:

```json
{
  "success": true,
  "credits_remaining": 4985,
  "credits_charged": 1,
  "searchResults": […]
}
```

An error returns a 4xx or 5xx status and a body you can branch on. Match on `code`; the `error` text is for people and may change.

400 Bad Request:

```json
{
  "success": false,
  "error": "query: required",
  "code": "invalid_params",
  "docs": "https://lurkapi.com/docs/facebook/search-ads",
  "issues": [
    {
      "path": "query",
      "message": "required"
    }
  ]
}
```

Unknown parameters are ignored, blank ones count as unset, and a repeated parameter uses its first value.

## Credits

Endpoints cost 1–5 credits per call; the cost is on each endpoint's page. A call is charged when it reached the platform, including `not_found` and other errors returned by the endpoint itself (e.g. a bad cursor). Free: parameter validation errors caught before the call, `401`/`402`/`429` rejections, and `5xx` failures (`500`/`502`/`503`). Cached responses cost the same as fresh ones. Anonymous tries follow the same rule.

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

Every response has `credits_charged` (this call) and `credits_remaining` (your balance after it). When the balance is too low for a call, you get `402 insufficient_credits` and nothing is charged. [Credit balance](https://lurkapi.com/docs/account/credit-balance.md) (`GET /v1/account/credit-balance`) is free, for checking before a batch.

## Errors

Every error has the same shape: `success: false`, a readable `error`, a stable `code` and a `docs` link. Validation errors, `401`/`402`/`429` rejections and `5xx` failures are free; `not_found` is charged ([how charging works](https://lurkapi.com/docs.md#credits)). Retry `429`, `502` and `503`; `429` and `503` carry a `retry-after` header with the seconds to wait.

| Status | Code | Meaning |
| --- | --- | --- |
| 400 | `invalid_params` | A parameter is missing or invalid. `issues` names each one. |
| 401 | `missing_api_key` | No API key. Send it in the `x-api-key` header. |
| 401 | `invalid_api_key` | The key is unknown or was revoked. |
| 401 | `invalid_token` | The playground token expired. Reload the page. |
| 402 | `insufficient_credits` | Not enough credits for this call. Buy a pack or wait for tomorrow's top-up. |
| 403 | `not_public` | The platform confirmed this account or content isn't available to logged-out visitors. Use a publicly visible target. Charged when the platform was checked. |
| 404 | `not_found` | The endpoint, or the thing you asked for (ad, post, subreddit), doesn't exist. Charged when the platform was checked. |
| 404 | `transcript_unavailable` | The video has no captions and speech-to-text heard no speech in it. Charged the base credit, never the speech-to-text extra; the answer is cached. |
| 405 | `method_not_allowed` | Endpoints take GET with query params. |
| 429 | `rate_limited` | Too many calls at once. Wait for the `retry-after` seconds, then retry. |
| 429 | `signup_required` | Free tries for today are used up. Sign up for free daily credits. |
| 500 | `internal_error` | Something broke on our side. Retry; 5xx errors are free. |
| 502 | `upstream_error` | The platform didn't give a usable answer. Retry; 5xx errors are free. |
| 503 | `upstream_busy` | All our connections to the platform are busy. Retry in a few seconds; 5xx errors are free. |
| 504 | `upstream_timeout` | The platform took over 30 seconds to answer. Retry; timeouts are free. |

## Rate limits

Each account can make 50 requests every 10 seconds (5 a second, sustained). Past that you get `429 rate_limited` with a `retry-after` header: wait that many seconds and retry.

High-volume accounts get 100 requests every 10 seconds. Email [support@lurkapi.com](mailto:support@lurkapi.com) to switch yours.

Without an account, the playground and free tools allow 5 requests per IP address a day, then `429 signup_required`.

## Pagination

List endpoints return one page per call. The response carries a cursor (`cursor` or `after`, named on each endpoint's page); send it back with the same parameters to get the next page. It's `null` on the last page. Each page costs the endpoint's credits.

## Caching and freshness

Responses are cached for a while, so repeated calls come back fast. How long depends on how quickly the data changes:

| Endpoint | Cached for up to |
| --- | --- |
| [Facebook: Search Ad Library ads](https://lurkapi.com/docs/facebook/search-ads.md) | 30 minutes |
| [Facebook: Ad Library ads by company](https://lurkapi.com/docs/facebook/company-ads.md) | 30 minutes |
| [Facebook: Ad Library ad details](https://lurkapi.com/docs/facebook/ad.md) | 6 hours |
| [Facebook: Search Ad Library companies](https://lurkapi.com/docs/facebook/search-companies.md) | 1 day |
| [Facebook: Public profile](https://lurkapi.com/docs/facebook/profile.md) | 10 minutes |
| [Facebook: Public post](https://lurkapi.com/docs/facebook/post.md) | 5 minutes |
| [Reddit: Subreddit posts](https://lurkapi.com/docs/reddit/subreddit-posts.md) | 1 minute |
| [Reddit: Subreddit details](https://lurkapi.com/docs/reddit/subreddit-details.md) | 1 hour |
| [Reddit: Subreddit search](https://lurkapi.com/docs/reddit/subreddit-search.md) | 1 minute |
| [Reddit: Search Reddit](https://lurkapi.com/docs/reddit/search.md) | 1 minute |
| [Reddit: Post comments](https://lurkapi.com/docs/reddit/post-comments.md) | 1 minute |
| [YouTube: Video details](https://lurkapi.com/docs/youtube/video.md) | 1 hour |
| [YouTube: Video transcript](https://lurkapi.com/docs/youtube/transcript.md) | 30 days |
| [YouTube: Video comments](https://lurkapi.com/docs/youtube/comments.md) | 10 minutes |
| [YouTube: Comment replies](https://lurkapi.com/docs/youtube/comment-replies.md) | 10 minutes |
| [YouTube: Channel details](https://lurkapi.com/docs/youtube/channel.md) | 6 hours |
| [YouTube: Channel videos](https://lurkapi.com/docs/youtube/channel-videos.md) | 1 hour |
| [YouTube: Channel Shorts](https://lurkapi.com/docs/youtube/channel-shorts.md) | 1 hour |
| [YouTube: Search YouTube](https://lurkapi.com/docs/youtube/search.md) | 15 minutes |
| [TikTok: Profile](https://lurkapi.com/docs/tiktok/profile.md) | 15 minutes |
| [TikTok: Video details](https://lurkapi.com/docs/tiktok/video.md) | 15 minutes |
| [TikTok: Video transcript](https://lurkapi.com/docs/tiktok/transcript.md) | 30 days |
| [TikTok: Profile videos](https://lurkapi.com/docs/tiktok/profile-videos.md) | 5 minutes |
| [TikTok: Video comments](https://lurkapi.com/docs/tiktok/comments.md) | 5 minutes |
| [TikTok: Comment replies](https://lurkapi.com/docs/tiktok/comment-replies.md) | 5 minutes |
| [TikTok: Hashtag videos](https://lurkapi.com/docs/tiktok/hashtag-videos.md) | 10 minutes |
| [TikTok: Song](https://lurkapi.com/docs/tiktok/song.md) | 1 hour |
| [TikTok: Song videos](https://lurkapi.com/docs/tiktok/song-videos.md) | 10 minutes |
| [TikTok: Search TikTok Ad Library](https://lurkapi.com/docs/tiktok/ad-library-search.md) | 1 hour |
| [TikTok: TikTok Ad Library ad](https://lurkapi.com/docs/tiktok/ad-library-ad.md) | 3 hours |
| [TikTok: Live status](https://lurkapi.com/docs/tiktok/live.md) | 30 seconds |
| [TikTok: Public stories](https://lurkapi.com/docs/tiktok/stories.md) | 1 minute |
| [TikTok: TikTok Shop product](https://lurkapi.com/docs/tiktok/product.md) | 5 minutes |
| [Google: Search Google advertisers](https://lurkapi.com/docs/google/search-advertisers.md) | 1 day |
| [Google: Google ads by company](https://lurkapi.com/docs/google/company-ads.md) | 12 hours |
| [Google: Google ad details](https://lurkapi.com/docs/google/ad.md) | 12 hours |
| [Bluesky: Profile](https://lurkapi.com/docs/bluesky/profile.md) | 30 seconds |
| [Bluesky: User posts](https://lurkapi.com/docs/bluesky/user-posts.md) | 3 minutes |
| [Bluesky: Post](https://lurkapi.com/docs/bluesky/post.md) | 3 minutes |
| [Snapchat: Profile and stories](https://lurkapi.com/docs/snapchat/profile.md) | 15 minutes |
| [Truth Social: Profile](https://lurkapi.com/docs/truthsocial/profile.md) | 10 minutes |
| [Truth Social: User posts](https://lurkapi.com/docs/truthsocial/user-posts.md) | 2 minutes |
| [Truth Social: Post](https://lurkapi.com/docs/truthsocial/post.md) | 5 minutes |
| [Telegram: Channel](https://lurkapi.com/docs/telegram/channel.md) | 1 hour |
| [Telegram: Channel posts](https://lurkapi.com/docs/telegram/channel-posts.md) | 5 minutes |
| [Telegram: Post](https://lurkapi.com/docs/telegram/post.md) | 10 minutes |
| [X (Twitter): Tweet](https://lurkapi.com/docs/twitter/tweet.md) | 5 minutes |
| [X (Twitter): Profile](https://lurkapi.com/docs/twitter/profile.md) | 1 hour |
| [X (Twitter): User tweets](https://lurkapi.com/docs/twitter/user-tweets.md) | 5 minutes |
| [Threads: Threads profile](https://lurkapi.com/docs/threads/profile.md) | 1 hour |
| [Threads: Threads account posts](https://lurkapi.com/docs/threads/user-posts.md) | 1 minute |
| [Threads: Threads post](https://lurkapi.com/docs/threads/post.md) | 5 minutes |
| [Instagram: Profile](https://lurkapi.com/docs/instagram/profile.md) | 10 minutes |
| [Instagram: User posts](https://lurkapi.com/docs/instagram/user-posts.md) | 3 minutes |
| [Instagram: Post](https://lurkapi.com/docs/instagram/post.md) | 5 minutes |
| [Instagram: Post comments](https://lurkapi.com/docs/instagram/post-comments.md) | 2 minutes |
| [Instagram: User reels](https://lurkapi.com/docs/instagram/user-reels.md) | 3 minutes |
| [Instagram: Media transcript](https://lurkapi.com/docs/instagram/media-transcript.md) | 30 days |
| [LinkedIn: LinkedIn company page](https://lurkapi.com/docs/linkedin/company.md) | 1 hour |
| [LinkedIn: LinkedIn company posts](https://lurkapi.com/docs/linkedin/company-posts.md) | 1 hour |
| [LinkedIn: Search LinkedIn ads](https://lurkapi.com/docs/linkedin/search-ads.md) | 1 hour |
| [LinkedIn: LinkedIn ad details](https://lurkapi.com/docs/linkedin/ad.md) | 1 hour |
| [Link-in-bio: Linktree page](https://lurkapi.com/docs/linkinbio/linktree.md) | 1 day |

A cached response costs the same credits as a fresh one. We'll publish typical response times once they're measured in production.

## All endpoints

### Facebook

| Endpoint | Path | Cost | MCP tool |
| --- | --- | --- | --- |
| [Search Ad Library ads](https://lurkapi.com/docs/facebook/search-ads.md) | `/v1/facebook/adLibrary/search/ads` | 1 credit | `facebook_search_ads` |
| [Ad Library ads by company](https://lurkapi.com/docs/facebook/company-ads.md) | `/v1/facebook/adLibrary/company/ads` | 1 credit | `facebook_company_ads` |
| [Ad Library ad details](https://lurkapi.com/docs/facebook/ad.md) | `/v1/facebook/adLibrary/ad` | 1 credit | `facebook_ad` |
| [Search Ad Library companies](https://lurkapi.com/docs/facebook/search-companies.md) | `/v1/facebook/adLibrary/search/companies` | 1 credit | `facebook_search_companies` |
| [Public profile](https://lurkapi.com/docs/facebook/profile.md) | `/v1/facebook/profile` | 1 credit | `facebook_profile` |
| [Public post](https://lurkapi.com/docs/facebook/post.md) | `/v1/facebook/post` | 1 credit | `facebook_post` |

### Reddit

| Endpoint | Path | Cost | MCP tool |
| --- | --- | --- | --- |
| [Subreddit posts](https://lurkapi.com/docs/reddit/subreddit-posts.md) | `/v1/reddit/subreddit` | 1 credit | `reddit_subreddit_posts` |
| [Subreddit details](https://lurkapi.com/docs/reddit/subreddit-details.md) | `/v1/reddit/subreddit/details` | 1 credit | `reddit_subreddit_details` |
| [Subreddit search](https://lurkapi.com/docs/reddit/subreddit-search.md) | `/v1/reddit/subreddit/search` | 1 credit | `reddit_subreddit_search` |
| [Search Reddit](https://lurkapi.com/docs/reddit/search.md) | `/v1/reddit/search` | 1 credit | `reddit_search` |
| [Post comments](https://lurkapi.com/docs/reddit/post-comments.md) | `/v1/reddit/post/comments` | 1 credit | `reddit_post_comments` |

### YouTube

| Endpoint | Path | Cost | MCP tool |
| --- | --- | --- | --- |
| [Video details](https://lurkapi.com/docs/youtube/video.md) | `/v1/youtube/video` | 1 credit | `youtube_video` |
| [Video transcript](https://lurkapi.com/docs/youtube/transcript.md) | `/v1/youtube/video/transcript` | 1 credit | `youtube_transcript` |
| [Video comments](https://lurkapi.com/docs/youtube/comments.md) | `/v1/youtube/video/comments` | 1 credit | `youtube_comments` |
| [Comment replies](https://lurkapi.com/docs/youtube/comment-replies.md) | `/v1/youtube/video/comment/replies` | 1 credit | `youtube_comment_replies` |
| [Channel details](https://lurkapi.com/docs/youtube/channel.md) | `/v1/youtube/channel` | 1 credit | `youtube_channel` |
| [Channel videos](https://lurkapi.com/docs/youtube/channel-videos.md) | `/v1/youtube/channel-videos` | 1 credit | `youtube_channel_videos` |
| [Channel Shorts](https://lurkapi.com/docs/youtube/channel-shorts.md) | `/v1/youtube/channel/shorts` | 1 credit | `youtube_channel_shorts` |
| [Search YouTube](https://lurkapi.com/docs/youtube/search.md) | `/v1/youtube/search` | 1 credit | `youtube_search` |

### TikTok

| Endpoint | Path | Cost | MCP tool |
| --- | --- | --- | --- |
| [Profile](https://lurkapi.com/docs/tiktok/profile.md) | `/v1/tiktok/profile` | 1 credit | `tiktok_profile` |
| [Video details](https://lurkapi.com/docs/tiktok/video.md) | `/v2/tiktok/video` | 1 credit | `tiktok_video` |
| [Video transcript](https://lurkapi.com/docs/tiktok/transcript.md) | `/v1/tiktok/video/transcript` | 1 credit; 5 if speech-to-text runs | `tiktok_transcript` |
| [Profile videos](https://lurkapi.com/docs/tiktok/profile-videos.md) | `/v3/tiktok/profile/videos` | 1 credit | `tiktok_profile_videos` |
| [Video comments](https://lurkapi.com/docs/tiktok/comments.md) | `/v1/tiktok/video/comments` | 1 credit | `tiktok_comments` |
| [Comment replies](https://lurkapi.com/docs/tiktok/comment-replies.md) | `/v1/tiktok/video/comment/replies` | 1 credit | `tiktok_comment_replies` |
| [Hashtag videos](https://lurkapi.com/docs/tiktok/hashtag-videos.md) | `/v1/tiktok/search/hashtag` | 1 credit | `tiktok_hashtag_videos` |
| [Song](https://lurkapi.com/docs/tiktok/song.md) | `/v1/tiktok/song` | 1 credit | `tiktok_song` |
| [Song videos](https://lurkapi.com/docs/tiktok/song-videos.md) | `/v1/tiktok/song/videos` | 1 credit | `tiktok_song_videos` |
| [Search TikTok Ad Library](https://lurkapi.com/docs/tiktok/ad-library-search.md) | `/v1/tiktok/ad-library/search` | 1 credit | `tiktok_ad_library_search` |
| [TikTok Ad Library ad](https://lurkapi.com/docs/tiktok/ad-library-ad.md) | `/v1/tiktok/ad-library/ad` | 1 credit | `tiktok_ad_library_ad` |
| [Live status](https://lurkapi.com/docs/tiktok/live.md) | `/v1/tiktok/user/live` | 1 credit | `tiktok_live` |
| [Public stories](https://lurkapi.com/docs/tiktok/stories.md) | `/v1/tiktok/user/stories` | 1 credit | `tiktok_stories` |
| [TikTok Shop product](https://lurkapi.com/docs/tiktok/product.md) | `/v1/tiktok/product` | 1 credit | `tiktok_product` |

### Google

| Endpoint | Path | Cost | MCP tool |
| --- | --- | --- | --- |
| [Search Google advertisers](https://lurkapi.com/docs/google/search-advertisers.md) | `/v1/google/adLibrary/advertisers/search` | 1 credit | `google_search_advertisers` |
| [Google ads by company](https://lurkapi.com/docs/google/company-ads.md) | `/v1/google/company/ads` | 1 credit | `google_company_ads` |
| [Google ad details](https://lurkapi.com/docs/google/ad.md) | `/v1/google/ad` | 1 credit | `google_ad` |

### Bluesky

| Endpoint | Path | Cost | MCP tool |
| --- | --- | --- | --- |
| [Profile](https://lurkapi.com/docs/bluesky/profile.md) | `/v1/bluesky/profile` | 1 credit | `bluesky_profile` |
| [User posts](https://lurkapi.com/docs/bluesky/user-posts.md) | `/v1/bluesky/user/posts` | 1 credit | `bluesky_user_posts` |
| [Post](https://lurkapi.com/docs/bluesky/post.md) | `/v1/bluesky/post` | 1 credit | `bluesky_post` |

### Snapchat

| Endpoint | Path | Cost | MCP tool |
| --- | --- | --- | --- |
| [Profile and stories](https://lurkapi.com/docs/snapchat/profile.md) | `/v1/snapchat/profile` | 1 credit | `snapchat_profile` |

### Truth Social

| Endpoint | Path | Cost | MCP tool |
| --- | --- | --- | --- |
| [Profile](https://lurkapi.com/docs/truthsocial/profile.md) | `/v1/truthsocial/profile` | 1 credit | `truthsocial_profile` |
| [User posts](https://lurkapi.com/docs/truthsocial/user-posts.md) | `/v1/truthsocial/user/posts` | 1 credit | `truthsocial_user_posts` |
| [Post](https://lurkapi.com/docs/truthsocial/post.md) | `/v1/truthsocial/post` | 1 credit | `truthsocial_post` |

### Telegram

| Endpoint | Path | Cost | MCP tool |
| --- | --- | --- | --- |
| [Channel](https://lurkapi.com/docs/telegram/channel.md) | `/v1/telegram/channel` | 1 credit | `telegram_channel` |
| [Channel posts](https://lurkapi.com/docs/telegram/channel-posts.md) | `/v1/telegram/channel/posts` | 1 credit | `telegram_channel_posts` |
| [Post](https://lurkapi.com/docs/telegram/post.md) | `/v1/telegram/post` | 1 credit | `telegram_post` |

### X (Twitter)

| Endpoint | Path | Cost | MCP tool |
| --- | --- | --- | --- |
| [Tweet](https://lurkapi.com/docs/twitter/tweet.md) | `/v1/twitter/tweet` | 1 credit | `twitter_tweet` |
| [Profile](https://lurkapi.com/docs/twitter/profile.md) | `/v1/twitter/profile` | 1 credit | `twitter_profile` |
| [User tweets](https://lurkapi.com/docs/twitter/user-tweets.md) | `/v1/twitter/user-tweets` | 1 credit | `twitter_user_tweets` |

### Threads

| Endpoint | Path | Cost | MCP tool |
| --- | --- | --- | --- |
| [Threads profile](https://lurkapi.com/docs/threads/profile.md) | `/v1/threads/profile` | 1 credit | `threads_profile` |
| [Threads account posts](https://lurkapi.com/docs/threads/user-posts.md) | `/v1/threads/user/posts` | 1 credit | `threads_user_posts` |
| [Threads post](https://lurkapi.com/docs/threads/post.md) | `/v1/threads/post` | 1 credit | `threads_post` |

### Instagram

| Endpoint | Path | Cost | MCP tool |
| --- | --- | --- | --- |
| [Profile](https://lurkapi.com/docs/instagram/profile.md) | `/v1/instagram/profile` | 1 credit | `instagram_profile` |
| [User posts](https://lurkapi.com/docs/instagram/user-posts.md) | `/v2/instagram/user/posts` | 1 credit | `instagram_user_posts` |
| [Post](https://lurkapi.com/docs/instagram/post.md) | `/v1/instagram/post` | 1 credit | `instagram_post` |
| [Post comments](https://lurkapi.com/docs/instagram/post-comments.md) | `/v2/instagram/post/comments` | 1 credit | `instagram_post_comments` |
| [User reels](https://lurkapi.com/docs/instagram/user-reels.md) | `/v1/instagram/user/reels` | 1 credit | `instagram_user_reels` |
| [Media transcript](https://lurkapi.com/docs/instagram/media-transcript.md) | `/v2/instagram/media/transcript` | 1 credit; 5 if speech-to-text runs | `instagram_media_transcript` |

### LinkedIn

| Endpoint | Path | Cost | MCP tool |
| --- | --- | --- | --- |
| [LinkedIn company page](https://lurkapi.com/docs/linkedin/company.md) | `/v1/linkedin/company` | 1 credit | `linkedin_company` |
| [LinkedIn company posts](https://lurkapi.com/docs/linkedin/company-posts.md) | `/v1/linkedin/company/posts` | 1 credit | `linkedin_company_posts` |
| [Search LinkedIn ads](https://lurkapi.com/docs/linkedin/search-ads.md) | `/v1/linkedin/ads/search` | 1 credit | `linkedin_search_ads` |
| [LinkedIn ad details](https://lurkapi.com/docs/linkedin/ad.md) | `/v1/linkedin/ad` | 1 credit | `linkedin_ad` |

### Link-in-bio

| Endpoint | Path | Cost | MCP tool |
| --- | --- | --- | --- |
| [Linktree page](https://lurkapi.com/docs/linkinbio/linktree.md) | `/v1/linktree` | 1 credit | `linkinbio_linktree` |

### Account

| Endpoint | Path | Cost | MCP tool |
| --- | --- | --- | --- |
| [Credit balance](https://lurkapi.com/docs/account/credit-balance.md) | `/v1/account/credit-balance` | free | `account_credit_balance` |

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

`GET https://api.lurkapi.com/` returns a JSON index of every endpoint.