# crawlfeed > One API for public social, video, music and commerce data. 26 platforms, 201 endpoints, one response shape. Base URL: https://api.crawlfeed.dev. Auth: `Authorization: Bearer sk_live_…`. Every success is `{ data, meta }`; errors are RFC 9457 problem details with a stable `code`. ## Docs - [Quickstart](https://crawlfeed.dev/docs): first call in a minute - [Authentication](https://crawlfeed.dev/docs/authentication) - [Response shape](https://crawlfeed.dev/docs/responses): envelope, meta, nulls, raw - [Pagination](https://crawlfeed.dev/docs/pagination): meta.next_cursor → ?cursor= - [Credits and pricing](https://crawlfeed.dev/docs/credits) - [Caching](https://crawlfeed.dev/docs/caching) - [Errors](https://crawlfeed.dev/docs/errors) - [Rate limits](https://crawlfeed.dev/docs/rate-limits) - [Search across platforms](https://crawlfeed.dev/docs/search) - [Arabic enrichment](https://crawlfeed.dev/docs/enrichment) - [Unified types](https://crawlfeed.dev/docs/types): every field of every object - [Coverage matrix](https://crawlfeed.dev/docs/coverage) - [OpenAPI spec](https://api.crawlfeed.dev/openapi.json) ## For agents - MCP server (Streamable HTTP): https://mcp.crawlfeed.dev/mcp. Send `Authorization: Bearer sk_live_…`; 9 tools, starting with the free `list_endpoints`. - Agent Skill: `npx skills add ilyasabdul19/crawlfeed-skills` ## Integrations (no-code and agents) - [Zapier](https://crawlfeed.dev/integrations/zapier): Send TikTok, Instagram and YouTube data into 7,000+ apps without code. Status: app coming soon; works today through Webhooks by Zapier → GET. - [Make](https://crawlfeed.dev/integrations/make): Build visual scenarios on public social data, with filters, routers and iterators. Status: app coming soon; works today through HTTP → Make a request. - [n8n](https://crawlfeed.dev/integrations/n8n): Self-hosted or cloud workflows with a node for every crawlfeed endpoint. Status: app coming soon; works today through HTTP Request node. - [MCP](https://crawlfeed.dev/integrations/mcp): A hosted MCP server with 9 tools for Claude, Cursor, VS Code and more. Status: live. - [Agent Skills](https://crawlfeed.dev/integrations/agent-skills): Teach Claude Code, Codex or Cursor the whole API in one command. Status: live. - The crawlfeed apps for Zapier, Make and n8n offer triggers (New post by a profile, New comment on a post, New search result) and actions (Get profile, Get posts, Get comments, Search posts, Get transcript, Enrich Arabic text, Run any endpoint (all 201)). Every trigger check is a billed call, cached or not. - Any other HTTP-capable tool works: send `Authorization: Bearer sk_live_…` to the base URL and read `data`. ## Guides (blog) - [How to Scrape Instagram Data in 2026: Profiles, Posts, Reels, Comments](https://crawlfeed.dev/blog/how-to-scrape-instagram-data): Get public Instagram profiles, posts, reels, comments, hashtags, highlights and transcripts as clean JSON with one REST API: no login, no scraper, no app review. - [How to Scrape LinkedIn Data in 2026: Profiles, Companies, Posts, Ads](https://crawlfeed.dev/blog/how-to-scrape-linkedin-data): Get public LinkedIn profiles, company pages, posts, post search and Ad Library ads as clean JSON with one REST API: no login, no partner approval, 2 credits per call. - [How to Scrape TikTok Data in 2026: Profiles, Videos, Comments](https://crawlfeed.dev/blog/how-to-scrape-tiktok-data): Get public TikTok profiles, videos, comments, hashtags, sounds and transcripts as clean JSON with one REST API: no scraper, no headless browser, no app review. - [How to Scrape X (Twitter) Data in 2026: Profiles, Posts, Replies](https://crawlfeed.dev/blog/how-to-scrape-x-twitter-data): Get public X (Twitter) profiles, posts, replies, Communities and video transcripts as clean JSON with one REST API: no login and no paid API tier. - [How to Scrape YouTube Data in 2026: Channels, Videos, Transcripts](https://crawlfeed.dev/blog/how-to-scrape-youtube-data): Get public YouTube channels, videos, Shorts, comments, playlists, community posts and transcripts as clean JSON with one REST API: no quota units, no Cloud project. - [How to Give AI Agents Social Media Data in 2026: 6 Approaches](https://crawlfeed.dev/blog/social-media-data-for-ai-agents): Browser scraping, official APIs, a data API as a tool, MCP, Agent Skills or llms.txt? How to give AI agents social media data in 2026, compared, with code. - [Social Media Data in Zapier, Make and n8n: A No-Code Guide](https://crawlfeed.dev/blog/social-media-data-zapier-make-n8n): Pull public TikTok, Instagram, YouTube and X data into Zapier, Make or n8n workflows with one API key. Step-by-step setup, pagination, trigger costs and five workflows. - [Social Media MCP Server: Set Up crawlfeed in Claude, Cursor and More](https://crawlfeed.dev/blog/social-media-mcp-server-claude-cursor): Give Claude, Cursor, VS Code, Windsurf or Codex live access to public TikTok, Instagram and YouTube data with the crawlfeed MCP server. Setup, tools, costs, fixes. ## Platforms - [TikTok](https://crawlfeed.dev/docs/platforms/tiktok): 31 endpoints. Profiles, videos, comments, sounds, transcripts, audience, shop and the ad library. - [Instagram](https://crawlfeed.dev/docs/platforms/instagram): 19 endpoints. Profiles, posts, reels, comments, highlights, transcripts and hashtag search. - [X](https://crawlfeed.dev/docs/platforms/x): 9 endpoints. Profiles, tweets, replies, communities and video transcripts. - [YouTube](https://crawlfeed.dev/docs/platforms/youtube): 19 endpoints. Channels, videos, shorts, playlists, community posts, lives and transcripts. - [Snapchat](https://crawlfeed.dev/docs/platforms/snapchat): 5 endpoints. Public profiles, Spotlight snaps and their replies. - [Facebook](https://crawlfeed.dev/docs/platforms/facebook): 21 endpoints. Pages, posts, reels, groups, events, Marketplace and the Meta ad library. - [Threads](https://crawlfeed.dev/docs/platforms/threads): 6 endpoints. Profiles, posts, and search for posts and people. - [LinkedIn](https://crawlfeed.dev/docs/platforms/linkedin): 11 endpoints. People, company pages, posts, post search and the LinkedIn ad library. - [Twitch](https://crawlfeed.dev/docs/platforms/twitch): 4 endpoints. Channels, recent broadcasts and live status. - [Telegram](https://crawlfeed.dev/docs/platforms/telegram): 3 endpoints. Public channels and their posts. - [Linktree](https://crawlfeed.dev/docs/platforms/linktree): 2 endpoints. Link-in-bio pages and every link on them. - [Bluesky](https://crawlfeed.dev/docs/platforms/bluesky): 5 endpoints. Profiles, posts, threads and people search, from the official AT Protocol API. - [Reddit](https://crawlfeed.dev/docs/platforms/reddit): 10 endpoints. Subreddits, posts, full comment trees, search and video transcripts. - [Pinterest](https://crawlfeed.dev/docs/platforms/pinterest): 5 endpoints. Pins, boards and pin search. - [Truth Social](https://crawlfeed.dev/docs/platforms/truthsocial): 3 endpoints. Profiles and posts. - [Kick](https://crawlfeed.dev/docs/platforms/kick): 1 endpoints. Clips. - [Rumble](https://crawlfeed.dev/docs/platforms/rumble): 7 endpoints. Channels, videos, comments, search and transcripts. - [Kwai](https://crawlfeed.dev/docs/platforms/kwai): 3 endpoints. Profiles and videos. - [GitHub](https://crawlfeed.dev/docs/platforms/github): 9 endpoints. Users, repositories, repository search, followers and trending. - [Spotify](https://crawlfeed.dev/docs/platforms/spotify): 9 endpoints. Artists, tracks, albums, playlists, podcasts and search. - [SoundCloud](https://crawlfeed.dev/docs/platforms/soundcloud): 3 endpoints. Artists and their tracks. - [Apple Music](https://crawlfeed.dev/docs/platforms/apple_music): 5 endpoints. Artists, albums, songs and search. - [Google](https://crawlfeed.dev/docs/platforms/google): 4 endpoints. Organic web search and the Ads Transparency Center. - [Amazon](https://crawlfeed.dev/docs/platforms/amazon): 1 endpoints. Creator storefronts and the products they feature. - [Hacker News](https://crawlfeed.dev/docs/platforms/hackernews): 4 endpoints. Users, their submissions, single items and comment threads. - [App Store](https://crawlfeed.dev/docs/platforms/appstore): 2 endpoints. Apps by numeric id or bundle id, and App Store search. ## Optional - [Full docs as one file](https://crawlfeed.dev/llms-full.txt) --- # TikTok · crawlfeed Profiles, videos, comments, sounds, transcripts, audience, shop and the ad library. Base price: 1 credit per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/tiktok/profile` | Profile | 1 | | `GET /v1/tiktok/posts` | Post[] | 1 | | `GET /v1/tiktok/post` | Post | 1 | | `GET /v1/tiktok/comments` | Comment[] | 1 | | `GET /v1/tiktok/search` | SearchResult[] | 1 | | `GET /v1/tiktok/followers` | Profile[] | 1 | | `GET /v1/tiktok/following` | Profile[] | 1 | | `GET /v1/tiktok/audience` | Audience | 26 | | `GET /v1/tiktok/live` | LiveStream | 1 | | `GET /v1/tiktok/trending/profiles` | Profile[] | 1 | | `GET /v1/tiktok/linked-profiles` | LinkedProfile[] | 10 | | `GET /v1/tiktok/hashtag` | Post[] | 1 | | `GET /v1/tiktok/trending` | Post[] | 1 | | `GET /v1/tiktok/transcript` | Transcript | 10 | | `GET /v1/tiktok/summary` | Summary | 13 | | `GET /v1/tiktok/replies` | Comment[] | 1 | | `GET /v1/tiktok/search/posts` | Post[] | 1 | | `GET /v1/tiktok/search/profiles` | Profile[] | 1 | | `GET /v1/tiktok/search/top` | Post[] | 1 | | `GET /v1/tiktok/search/suggestions` | Suggestion[] | 1 | | `GET /v1/tiktok/collection/posts` | Post[] | 1 | | `GET /v1/tiktok/track` | Track | 1 | | `GET /v1/tiktok/track/posts` | Post[] | 1 | | `GET /v1/tiktok/shop/search` | Product[] | 1 | | `GET /v1/tiktok/shop/products` | Product[] | 1 | | `GET /v1/tiktok/shop/product` | Product | 1 | | `GET /v1/tiktok/shop/reviews` | Review[] | 1 | | `GET /v1/tiktok/shop/showcase` | Product[] | 1 | | `GET /v1/tiktok/ads/search` | Ad[] | 1 | | `GET /v1/tiktok/ads` | Ad[] | 1 | | `GET /v1/tiktok/ad` | Ad | 1 | ## Profile Get a public profile by handle. `GET /v1/tiktok/profile` → `Profile` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/profile \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=charlidamelio" ``` ## Posts List a profile's recent posts. `GET /v1/tiktok/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=charlidamelio" ``` ## Post Get a single post by id. `GET /v1/tiktok/post` → `Post` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The post id on that platform. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/post \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Comments List comments on a post. `GET /v1/tiktok/comments` → `Comment[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `post_id` | yes | The post to read comments from. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/comments \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "post_id=" ``` ## Search Search one platform. `GET /v1/tiktok/search` → `SearchResult[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=climate tech" ``` ## Followers Accounts that follow a profile. `GET /v1/tiktok/followers` → `Profile[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @, or the profile URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/followers \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=charlidamelio" ``` ## Following Accounts a profile follows. `GET /v1/tiktok/following` → `Profile[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @, or the profile URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/following \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=charlidamelio" ``` ## Audience Where a creator's audience is, by country. `GET /v1/tiktok/audience` → `Audience` · 26 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @, or the profile URL. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/audience \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=charlidamelio" ``` ## Live Whether a creator is live right now, with viewers and title. `GET /v1/tiktok/live` → `LiveStream` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @, or the profile URL. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/live \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=charlidamelio" ``` ## Trending profiles Popular creators or developers right now. `GET /v1/tiktok/trending/profiles` → `Profile[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `country` | no | ISO country code, e.g. US. | | `language` | no | Programming language (GitHub). | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/trending/profiles \ -H "Authorization: Bearer $CRAWLFEED_KEY" ``` ## Linked profiles The same creator's accounts on other platforms, matched through their public links. `GET /v1/tiktok/linked-profiles` → `LinkedProfile[]` · 10 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/linked-profiles \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=charlidamelio" ``` ## Hashtag Posts using a hashtag. `GET /v1/tiktok/hashtag` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `tag` | yes | Hashtag without the #. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/hashtag \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "tag=coffee" ``` ## Trending What is trending on the platform right now. `GET /v1/tiktok/trending` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `country` | no | ISO country code, e.g. US. | | `language` | no | Programming language (GitHub). | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/trending \ -H "Authorization: Bearer $CRAWLFEED_KEY" ``` ## Transcript The spoken text of a video, with timings when available. `GET /v1/tiktok/transcript` → `Transcript` · 10 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The video or post id, or its URL. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/transcript \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Summary An AI summary of a video: a few sentences, the key points and the topics, written from its transcript. `GET /v1/tiktok/summary` → `Summary` · 13 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The video or post id, or its URL. | | `lang` | no | Language to write the summary in (ISO 639-1, e.g. en, ar). Defaults to the video’s language. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/summary \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Replies Replies to one comment. `GET /v1/tiktok/replies` → `Comment[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `post_id` | yes | The post the comment is on (id or URL). | | `comment_id` | yes | The comment to read replies to. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/replies \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "post_id=" \ --data-urlencode "comment_id=" ``` ## Search posts Posts matching a keyword. `GET /v1/tiktok/search/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/search/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=coffee" ``` ## Search profiles Profiles matching a keyword. `GET /v1/tiktok/search/profiles` → `Profile[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/search/profiles \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=coffee" ``` ## Top results The platform's Top tab for a keyword: videos and photo carousels, ranked. `GET /v1/tiktok/search/top` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/search/top \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=coffee" ``` ## Search suggestions What the search box suggests as someone types: terms, and on YouTube, channels. `GET /v1/tiktok/search/suggestions` → `Suggestion[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | The start of a search. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/search/suggestions \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=coffee" ``` ## Collection posts The posts in a playlist, board, highlight or podcast. `GET /v1/tiktok/collection/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Playlist, board, highlight or podcast id, or its URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/collection/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Track One track or sound. `GET /v1/tiktok/track` → `Track` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Track or sound id, or its URL. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/track \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Posts using a sound Videos that use a sound. `GET /v1/tiktok/track/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Sound or audio id, or its URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/track/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Search products Products matching a keyword. `GET /v1/tiktok/shop/search` → `Product[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/shop/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=coffee" ``` ## Shop products A shop's or creator storefront's products. `GET /v1/tiktok/shop/products` → `Product[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `shop` | yes | The shop or storefront URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/shop/products \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "shop=" ``` ## Product One product, with price, stock and rating. `GET /v1/tiktok/shop/product` → `Product` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The product URL. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/shop/product \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Product reviews Reviews of one product. `GET /v1/tiktok/shop/reviews` → `Review[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The product URL or id. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/shop/reviews \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Creator showcase Products a creator features. `GET /v1/tiktok/shop/showcase` → `Product[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @, or the profile URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/shop/showcase \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=charlidamelio" ``` ## Search ads Ads in the public ad library matching a keyword. `GET /v1/tiktok/ads/search` → `Ad[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `country` | no | ISO country code. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/ads/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=coffee" ``` ## An advertiser's ads Every ad an advertiser is running or ran. `GET /v1/tiktok/ads` → `Ad[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `advertiser` | yes | Advertiser name, page id or domain. | | `country` | no | ISO country code. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/ads \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "advertiser=nike.com" ``` ## Ad One ad from the ad library. `GET /v1/tiktok/ad` → `Ad` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Ad id or ad-library URL. | ```bash curl -G https://api.crawlfeed.dev/v1/tiktok/ad \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # Instagram · crawlfeed Profiles, posts, reels, comments, highlights, transcripts and hashtag search. Base price: 1 credit per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/instagram/profile` | Profile | 1 | | `GET /v1/instagram/posts` | Post[] | 1 | | `GET /v1/instagram/post` | Post | 1 | | `GET /v1/instagram/comments` | Comment[] | 1 | | `GET /v1/instagram/search` | SearchResult[] | 1 | | `GET /v1/instagram/linked-profiles` | LinkedProfile[] | 10 | | `GET /v1/instagram/reels` | Post[] | 1 | | `GET /v1/instagram/tagged` | Post[] | 1 | | `GET /v1/instagram/hashtag` | Post[] | 1 | | `GET /v1/instagram/trending` | Post[] | 1 | | `GET /v1/instagram/transcript` | Transcript | 1 | | `GET /v1/instagram/summary` | Summary | 4 | | `GET /v1/instagram/replies` | Comment[] | 1 | | `GET /v1/instagram/search/posts` | Post[] | 1 | | `GET /v1/instagram/search/profiles` | Profile[] | 1 | | `GET /v1/instagram/topic` | Post[] | 1 | | `GET /v1/instagram/collections` | Collection[] | 1 | | `GET /v1/instagram/collection/posts` | Post[] | 1 | | `GET /v1/instagram/track/posts` | Post[] | 1 | ## Profile Get a public profile by handle. `GET /v1/instagram/profile` → `Profile` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | ```bash curl -G https://api.crawlfeed.dev/v1/instagram/profile \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=natgeo" ``` ## Posts List a profile's recent posts. `GET /v1/instagram/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/instagram/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=natgeo" ``` ## Post Get a single post by id. `GET /v1/instagram/post` → `Post` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The post id on that platform. | ```bash curl -G https://api.crawlfeed.dev/v1/instagram/post \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Comments List comments on a post. `GET /v1/instagram/comments` → `Comment[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `post_id` | yes | The post to read comments from. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/instagram/comments \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "post_id=" ``` ## Search Search one platform. `GET /v1/instagram/search` → `SearchResult[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/instagram/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=climate tech" ``` ## Linked profiles The same creator's accounts on other platforms, matched through their public links. `GET /v1/instagram/linked-profiles` → `LinkedProfile[]` · 10 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/instagram/linked-profiles \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=natgeo" ``` ## Reels and shorts A profile's short-form videos: reels, shorts. `GET /v1/instagram/reels` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @, or the profile URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/instagram/reels \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=natgeo" ``` ## Tagged posts Posts a profile is tagged in. `GET /v1/instagram/tagged` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Numeric user id or username. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/instagram/tagged \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=natgeo" ``` ## Hashtag Posts using a hashtag. `GET /v1/instagram/hashtag` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `tag` | yes | Hashtag without the #. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/instagram/hashtag \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "tag=coffee" ``` ## Trending What is trending on the platform right now. `GET /v1/instagram/trending` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `country` | no | ISO country code, e.g. US. | | `language` | no | Programming language (GitHub). | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/instagram/trending \ -H "Authorization: Bearer $CRAWLFEED_KEY" ``` ## Transcript The spoken text of a video, with timings when available. `GET /v1/instagram/transcript` → `Transcript` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The video or post id, or its URL. | ```bash curl -G https://api.crawlfeed.dev/v1/instagram/transcript \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Summary An AI summary of a video: a few sentences, the key points and the topics, written from its transcript. `GET /v1/instagram/summary` → `Summary` · 4 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The video or post id, or its URL. | | `lang` | no | Language to write the summary in (ISO 639-1, e.g. en, ar). Defaults to the video’s language. | ```bash curl -G https://api.crawlfeed.dev/v1/instagram/summary \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Replies Replies to one comment. `GET /v1/instagram/replies` → `Comment[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `post_id` | yes | The post the comment is on (id or URL). | | `comment_id` | yes | The comment to read replies to. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/instagram/replies \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "post_id=" \ --data-urlencode "comment_id=" ``` ## Search posts Posts matching a keyword. `GET /v1/instagram/search/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/instagram/search/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=coffee" ``` ## Search profiles Profiles matching a keyword. `GET /v1/instagram/search/profiles` → `Profile[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/instagram/search/profiles \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=coffee" ``` ## Topic Posts the platform curates for a topic, most popular first. `GET /v1/instagram/topic` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | A topic, e.g. basketball. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/instagram/topic \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=basketball" ``` ## Collections A profile's playlists, boards or story highlights. `GET /v1/instagram/collections` → `Collection[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @, or the profile URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/instagram/collections \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=natgeo" ``` ## Collection posts The posts in a playlist, board, highlight or podcast. `GET /v1/instagram/collection/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Playlist, board, highlight or podcast id, or its URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/instagram/collection/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Posts using a sound Videos that use a sound. `GET /v1/instagram/track/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Sound or audio id, or its URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/instagram/track/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # X · crawlfeed Profiles, tweets, replies, communities and video transcripts. Base price: 1 credit per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/x/profile` | Profile | 1 | | `GET /v1/x/posts` | Post[] | 1 | | `GET /v1/x/post` | Post | 1 | | `GET /v1/x/comments` | Comment[] | 1 | | `GET /v1/x/linked-profiles` | LinkedProfile[] | 10 | | `GET /v1/x/transcript` | Transcript | 1 | | `GET /v1/x/summary` | Summary | 4 | | `GET /v1/x/community` | Profile | 1 | | `GET /v1/x/community/posts` | Post[] | 1 | ## Profile Get a public profile by handle. `GET /v1/x/profile` → `Profile` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | ```bash curl -G https://api.crawlfeed.dev/v1/x/profile \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=nasa" ``` ## Posts List a profile's recent posts. `GET /v1/x/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/x/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=nasa" ``` ## Post Get a single post by id. `GET /v1/x/post` → `Post` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The post id on that platform. | ```bash curl -G https://api.crawlfeed.dev/v1/x/post \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Comments List comments on a post. `GET /v1/x/comments` → `Comment[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `post_id` | yes | The post to read comments from. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/x/comments \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "post_id=" ``` ## Linked profiles The same creator's accounts on other platforms, matched through their public links. `GET /v1/x/linked-profiles` → `LinkedProfile[]` · 10 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/x/linked-profiles \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=nasa" ``` ## Transcript The spoken text of a video, with timings when available. `GET /v1/x/transcript` → `Transcript` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The video or post id, or its URL. | ```bash curl -G https://api.crawlfeed.dev/v1/x/transcript \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Summary An AI summary of a video: a few sentences, the key points and the topics, written from its transcript. `GET /v1/x/summary` → `Summary` · 4 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The video or post id, or its URL. | | `lang` | no | Language to write the summary in (ISO 639-1, e.g. en, ar). Defaults to the video’s language. | ```bash curl -G https://api.crawlfeed.dev/v1/x/summary \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Community A community (subreddit, group) as a profile. `GET /v1/x/community` → `Profile` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Community name or URL. | ```bash curl -G https://api.crawlfeed.dev/v1/x/community \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Community posts Posts in a community, or a channel’s community tab. `GET /v1/x/community/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Community name or URL, or a YouTube channel handle. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/x/community/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # YouTube · crawlfeed Channels, videos, shorts, playlists, community posts, lives and transcripts. Base price: 1 credit per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/youtube/profile` | Profile | 1 | | `GET /v1/youtube/posts` | Post[] | 1 | | `GET /v1/youtube/post` | Post | 1 | | `GET /v1/youtube/comments` | Comment[] | 1 | | `GET /v1/youtube/search` | SearchResult[] | 1 | | `GET /v1/youtube/linked-profiles` | LinkedProfile[] | 10 | | `GET /v1/youtube/reels` | Post[] | 1 | | `GET /v1/youtube/live/videos` | Post[] | 1 | | `GET /v1/youtube/hashtag` | Post[] | 1 | | `GET /v1/youtube/trending` | Post[] | 1 | | `GET /v1/youtube/transcript` | Transcript | 1 | | `GET /v1/youtube/summary` | Summary | 4 | | `GET /v1/youtube/search/posts` | Post[] | 1 | | `GET /v1/youtube/search/suggestions` | Suggestion[] | 1 | | `GET /v1/youtube/collections` | Collection[] | 1 | | `GET /v1/youtube/collection` | Collection | 1 | | `GET /v1/youtube/collection/posts` | Post[] | 1 | | `GET /v1/youtube/community/posts` | Post[] | 1 | | `GET /v1/youtube/community/post` | Post | 1 | ## Profile Get a public profile by handle. `GET /v1/youtube/profile` → `Profile` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | ```bash curl -G https://api.crawlfeed.dev/v1/youtube/profile \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=MrBeast" ``` ## Posts List a profile's recent posts. `GET /v1/youtube/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/youtube/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=MrBeast" ``` ## Post Get a single post by id. `GET /v1/youtube/post` → `Post` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The post id on that platform. | ```bash curl -G https://api.crawlfeed.dev/v1/youtube/post \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Comments List comments on a post. `GET /v1/youtube/comments` → `Comment[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `post_id` | yes | The post to read comments from. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/youtube/comments \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "post_id=" ``` ## Search Search one platform. `GET /v1/youtube/search` → `SearchResult[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/youtube/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=climate tech" ``` ## Linked profiles The same creator's accounts on other platforms, matched through their public links. `GET /v1/youtube/linked-profiles` → `LinkedProfile[]` · 10 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/youtube/linked-profiles \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=MrBeast" ``` ## Reels and shorts A profile's short-form videos: reels, shorts. `GET /v1/youtube/reels` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @, or the profile URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/youtube/reels \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=MrBeast" ``` ## Live videos A channel's live and past live streams. `GET /v1/youtube/live/videos` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @, or the profile URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/youtube/live/videos \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=MrBeast" ``` ## Hashtag Posts using a hashtag. `GET /v1/youtube/hashtag` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `tag` | yes | Hashtag without the #. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/youtube/hashtag \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "tag=coffee" ``` ## Trending What is trending on the platform right now. `GET /v1/youtube/trending` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `country` | no | ISO country code, e.g. US. | | `language` | no | Programming language (GitHub). | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/youtube/trending \ -H "Authorization: Bearer $CRAWLFEED_KEY" ``` ## Transcript The spoken text of a video, with timings when available. `GET /v1/youtube/transcript` → `Transcript` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The video or post id, or its URL. | ```bash curl -G https://api.crawlfeed.dev/v1/youtube/transcript \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Summary An AI summary of a video: a few sentences, the key points and the topics, written from its transcript. `GET /v1/youtube/summary` → `Summary` · 4 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The video or post id, or its URL. | | `lang` | no | Language to write the summary in (ISO 639-1, e.g. en, ar). Defaults to the video’s language. | ```bash curl -G https://api.crawlfeed.dev/v1/youtube/summary \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Search posts Posts matching a keyword. `GET /v1/youtube/search/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/youtube/search/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=coffee" ``` ## Search suggestions What the search box suggests as someone types: terms, and on YouTube, channels. `GET /v1/youtube/search/suggestions` → `Suggestion[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | The start of a search. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/youtube/search/suggestions \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=coffee" ``` ## Collections A profile's playlists, boards or story highlights. `GET /v1/youtube/collections` → `Collection[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @, or the profile URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/youtube/collections \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=MrBeast" ``` ## Collection One playlist, album or podcast. `GET /v1/youtube/collection` → `Collection` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Playlist, album or podcast id, or its URL. | ```bash curl -G https://api.crawlfeed.dev/v1/youtube/collection \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Collection posts The posts in a playlist, board, highlight or podcast. `GET /v1/youtube/collection/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Playlist, board, highlight or podcast id, or its URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/youtube/collection/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Community posts Posts in a community, or a channel’s community tab. `GET /v1/youtube/community/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Community name or URL, or a YouTube channel handle. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/youtube/community/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Community post One community-tab post. `GET /v1/youtube/community/post` → `Post` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The post URL. | ```bash curl -G https://api.crawlfeed.dev/v1/youtube/community/post \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # Snapchat · crawlfeed Public profiles, Spotlight snaps and their replies. Base price: 2 credits per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/snapchat/profile` | Profile | 2 | | `GET /v1/snapchat/posts` | Post[] | 2 | | `GET /v1/snapchat/post` | Post | 2 | | `GET /v1/snapchat/comments` | Comment[] | 2 | | `GET /v1/snapchat/search` | SearchResult[] | 2 | ## Profile Get a public profile by handle. `GET /v1/snapchat/profile` → `Profile` · 2 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | ```bash curl -G https://api.crawlfeed.dev/v1/snapchat/profile \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=khaby.lame" ``` ## Posts List a profile's recent posts. `GET /v1/snapchat/posts` → `Post[]` · 2 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/snapchat/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=khaby.lame" ``` ## Post Get a single post by id. `GET /v1/snapchat/post` → `Post` · 2 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The post id on that platform. | ```bash curl -G https://api.crawlfeed.dev/v1/snapchat/post \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Comments List comments on a post. `GET /v1/snapchat/comments` → `Comment[]` · 2 credits | Param | Required | Description | | --- | --- | --- | | `post_id` | yes | The post to read comments from. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/snapchat/comments \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "post_id=" ``` ## Search Search one platform. `GET /v1/snapchat/search` → `SearchResult[]` · 2 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/snapchat/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=climate tech" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # Facebook · crawlfeed Pages, posts, reels, groups, events, Marketplace and the Meta ad library. Base price: 1 credit per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/facebook/profile` | Profile | 1 | | `GET /v1/facebook/posts` | Post[] | 1 | | `GET /v1/facebook/post` | Post | 1 | | `GET /v1/facebook/comments` | Comment[] | 1 | | `GET /v1/facebook/linked-profiles` | LinkedProfile[] | 10 | | `GET /v1/facebook/reels` | Post[] | 1 | | `GET /v1/facebook/photos` | Post[] | 1 | | `GET /v1/facebook/transcript` | Transcript | 1 | | `GET /v1/facebook/summary` | Summary | 4 | | `GET /v1/facebook/community` | Profile | 1 | | `GET /v1/facebook/community/posts` | Post[] | 1 | | `GET /v1/facebook/marketplace/search` | Product[] | 1 | | `GET /v1/facebook/marketplace/item` | Product | 1 | | `GET /v1/facebook/ads/search` | Ad[] | 1 | | `GET /v1/facebook/ads` | Ad[] | 1 | | `GET /v1/facebook/ad` | Ad | 1 | | `GET /v1/facebook/ad/transcript` | Transcript | 1 | | `GET /v1/facebook/advertisers/search` | Advertiser[] | 1 | | `GET /v1/facebook/events` | Event[] | 1 | | `GET /v1/facebook/events/search` | Event[] | 1 | | `GET /v1/facebook/event` | Event | 1 | ## Profile Get a public profile by handle. `GET /v1/facebook/profile` → `Profile` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | ```bash curl -G https://api.crawlfeed.dev/v1/facebook/profile \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=nike" ``` ## Posts List a profile's recent posts. `GET /v1/facebook/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/facebook/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=nike" ``` ## Post Get a single post by id. `GET /v1/facebook/post` → `Post` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The post id on that platform. | ```bash curl -G https://api.crawlfeed.dev/v1/facebook/post \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Comments List comments on a post. `GET /v1/facebook/comments` → `Comment[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `post_id` | yes | The post to read comments from. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/facebook/comments \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "post_id=" ``` ## Linked profiles The same creator's accounts on other platforms, matched through their public links. `GET /v1/facebook/linked-profiles` → `LinkedProfile[]` · 10 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/facebook/linked-profiles \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=nike" ``` ## Reels and shorts A profile's short-form videos: reels, shorts. `GET /v1/facebook/reels` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @, or the profile URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/facebook/reels \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=nike" ``` ## Photos A page's photos. `GET /v1/facebook/photos` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @, or the profile URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/facebook/photos \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=nike" ``` ## Transcript The spoken text of a video, with timings when available. `GET /v1/facebook/transcript` → `Transcript` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The video or post id, or its URL. | ```bash curl -G https://api.crawlfeed.dev/v1/facebook/transcript \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Summary An AI summary of a video: a few sentences, the key points and the topics, written from its transcript. `GET /v1/facebook/summary` → `Summary` · 4 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The video or post id, or its URL. | | `lang` | no | Language to write the summary in (ISO 639-1, e.g. en, ar). Defaults to the video’s language. | ```bash curl -G https://api.crawlfeed.dev/v1/facebook/summary \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Community A community (subreddit, group) as a profile. `GET /v1/facebook/community` → `Profile` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Community name or URL. | ```bash curl -G https://api.crawlfeed.dev/v1/facebook/community \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Community posts Posts in a community, or a channel’s community tab. `GET /v1/facebook/community/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Community name or URL, or a YouTube channel handle. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/facebook/community/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Marketplace search Marketplace listings near a location. `GET /v1/facebook/marketplace/search` → `Product[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `lat` | yes | Latitude. | | `lng` | yes | Longitude. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/facebook/marketplace/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=coffee" \ --data-urlencode "lat=40.7128" \ --data-urlencode "lng=-74.006" ``` ## Marketplace item One marketplace listing. `GET /v1/facebook/marketplace/item` → `Product` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Listing id or URL. | ```bash curl -G https://api.crawlfeed.dev/v1/facebook/marketplace/item \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Search ads Ads in the public ad library matching a keyword. `GET /v1/facebook/ads/search` → `Ad[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `country` | no | ISO country code. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/facebook/ads/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=coffee" ``` ## An advertiser's ads Every ad an advertiser is running or ran. `GET /v1/facebook/ads` → `Ad[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `advertiser` | yes | Advertiser name, page id or domain. | | `country` | no | ISO country code. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/facebook/ads \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "advertiser=nike.com" ``` ## Ad One ad from the ad library. `GET /v1/facebook/ad` → `Ad` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Ad id or ad-library URL. | ```bash curl -G https://api.crawlfeed.dev/v1/facebook/ad \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Ad transcript The spoken text of a video ad. `GET /v1/facebook/ad/transcript` → `Transcript` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Ad id or ad-library URL. | ```bash curl -G https://api.crawlfeed.dev/v1/facebook/ad/transcript \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Search advertisers Find an advertiser, and the id its ads are filed under. `GET /v1/facebook/advertisers/search` → `Advertiser[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/facebook/advertisers/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=coffee" ``` ## Events A page's upcoming and past events, or a streamer's schedule. `GET /v1/facebook/events` → `Event[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @, or the profile URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/facebook/events \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=nike" ``` ## Search events Public events matching a keyword. `GET /v1/facebook/events/search` → `Event[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/facebook/events/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=coffee" ``` ## Event One event. `GET /v1/facebook/event` → `Event` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Event id or URL. | ```bash curl -G https://api.crawlfeed.dev/v1/facebook/event \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # Threads · crawlfeed Profiles, posts, and search for posts and people. Base price: 1 credit per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/threads/profile` | Profile | 1 | | `GET /v1/threads/posts` | Post[] | 1 | | `GET /v1/threads/post` | Post | 1 | | `GET /v1/threads/search` | SearchResult[] | 1 | | `GET /v1/threads/search/posts` | Post[] | 1 | | `GET /v1/threads/search/profiles` | Profile[] | 1 | ## Profile Get a public profile by handle. `GET /v1/threads/profile` → `Profile` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | ```bash curl -G https://api.crawlfeed.dev/v1/threads/profile \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=zuck" ``` ## Posts List a profile's recent posts. `GET /v1/threads/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/threads/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=zuck" ``` ## Post Get a single post by id. `GET /v1/threads/post` → `Post` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The post id on that platform. | ```bash curl -G https://api.crawlfeed.dev/v1/threads/post \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Search Search one platform. `GET /v1/threads/search` → `SearchResult[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/threads/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=climate tech" ``` ## Search posts Posts matching a keyword. `GET /v1/threads/search/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/threads/search/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=coffee" ``` ## Search profiles Profiles matching a keyword. `GET /v1/threads/search/profiles` → `Profile[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/threads/search/profiles \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=coffee" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # LinkedIn · crawlfeed People, company pages, posts, post search and the LinkedIn ad library. Base price: 2 credits per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/linkedin/profile` | Profile | 2 | | `GET /v1/linkedin/posts` | Post[] | 2 | | `GET /v1/linkedin/post` | Post | 2 | | `GET /v1/linkedin/company` | Profile | 2 | | `GET /v1/linkedin/company/posts` | Post[] | 2 | | `GET /v1/linkedin/transcript` | Transcript | 2 | | `GET /v1/linkedin/summary` | Summary | 5 | | `GET /v1/linkedin/search/posts` | Post[] | 2 | | `GET /v1/linkedin/ads/search` | Ad[] | 2 | | `GET /v1/linkedin/ads` | Ad[] | 2 | | `GET /v1/linkedin/ad` | Ad | 2 | ## Profile Get a public profile by handle. `GET /v1/linkedin/profile` → `Profile` · 2 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | ```bash curl -G https://api.crawlfeed.dev/v1/linkedin/profile \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=satyanadella" ``` ## Posts List a profile's recent posts. `GET /v1/linkedin/posts` → `Post[]` · 2 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/linkedin/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=satyanadella" ``` ## Post Get a single post by id. `GET /v1/linkedin/post` → `Post` · 2 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The post id on that platform. | ```bash curl -G https://api.crawlfeed.dev/v1/linkedin/post \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Company A company page as a profile. `GET /v1/linkedin/company` → `Profile` · 2 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Company slug or page URL. | ```bash curl -G https://api.crawlfeed.dev/v1/linkedin/company \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=satyanadella" ``` ## Company posts A company page's posts. `GET /v1/linkedin/company/posts` → `Post[]` · 2 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Company slug or page URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/linkedin/company/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=satyanadella" ``` ## Transcript The spoken text of a video, with timings when available. `GET /v1/linkedin/transcript` → `Transcript` · 2 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The video or post id, or its URL. | ```bash curl -G https://api.crawlfeed.dev/v1/linkedin/transcript \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Summary An AI summary of a video: a few sentences, the key points and the topics, written from its transcript. `GET /v1/linkedin/summary` → `Summary` · 5 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The video or post id, or its URL. | | `lang` | no | Language to write the summary in (ISO 639-1, e.g. en, ar). Defaults to the video’s language. | ```bash curl -G https://api.crawlfeed.dev/v1/linkedin/summary \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Search posts Posts matching a keyword. `GET /v1/linkedin/search/posts` → `Post[]` · 2 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/linkedin/search/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=ai agents" ``` ## Search ads Ads in the public ad library matching a keyword. `GET /v1/linkedin/ads/search` → `Ad[]` · 2 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `country` | no | ISO country code. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/linkedin/ads/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=ai agents" ``` ## An advertiser's ads Every ad an advertiser is running or ran. `GET /v1/linkedin/ads` → `Ad[]` · 2 credits | Param | Required | Description | | --- | --- | --- | | `advertiser` | yes | Advertiser name, page id or domain. | | `country` | no | ISO country code. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/linkedin/ads \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "advertiser=nike.com" ``` ## Ad One ad from the ad library. `GET /v1/linkedin/ad` → `Ad` · 2 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Ad id or ad-library URL. | ```bash curl -G https://api.crawlfeed.dev/v1/linkedin/ad \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # Twitch · crawlfeed Channels, recent broadcasts and live status. Base price: 1 credit per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/twitch/profile` | Profile | 1 | | `GET /v1/twitch/posts` | Post[] | 1 | | `GET /v1/twitch/live` | LiveStream | 1 | | `GET /v1/twitch/events` | Event[] | 1 | ## Profile Get a public profile by handle. `GET /v1/twitch/profile` → `Profile` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | ```bash curl -G https://api.crawlfeed.dev/v1/twitch/profile \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=shroud" ``` ## Posts List a profile's recent posts. `GET /v1/twitch/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/twitch/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=shroud" ``` ## Live Whether a creator is live right now, with viewers and title. `GET /v1/twitch/live` → `LiveStream` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @, or the profile URL. | ```bash curl -G https://api.crawlfeed.dev/v1/twitch/live \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=shroud" ``` ## Events A page's upcoming and past events, or a streamer's schedule. `GET /v1/twitch/events` → `Event[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @, or the profile URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/twitch/events \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=shroud" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # Telegram · crawlfeed Public channels and their posts. Base price: 2 credits per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/telegram/profile` | Profile | 2 | | `GET /v1/telegram/posts` | Post[] | 2 | | `GET /v1/telegram/search` | SearchResult[] | 2 | ## Profile Get a public profile by handle. `GET /v1/telegram/profile` → `Profile` · 2 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | ```bash curl -G https://api.crawlfeed.dev/v1/telegram/profile \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=durov" ``` ## Posts List a profile's recent posts. `GET /v1/telegram/posts` → `Post[]` · 2 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/telegram/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=durov" ``` ## Search Search one platform. `GET /v1/telegram/search` → `SearchResult[]` · 2 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/telegram/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=climate tech" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # Linktree · crawlfeed Link-in-bio pages and every link on them. Base price: 1 credit per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/linktree/profile` | Profile | 1 | | `GET /v1/linktree/search` | SearchResult[] | 1 | ## Profile Get a public profile by handle. `GET /v1/linktree/profile` → `Profile` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | ```bash curl -G https://api.crawlfeed.dev/v1/linktree/profile \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=selenagomez" ``` ## Search Search one platform. `GET /v1/linktree/search` → `SearchResult[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/linktree/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=climate tech" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # Bluesky · crawlfeed Profiles, posts, threads and people search, from the official AT Protocol API. Base price: 1 credit per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/bluesky/profile` | Profile | 1 | | `GET /v1/bluesky/posts` | Post[] | 1 | | `GET /v1/bluesky/post` | Post | 1 | | `GET /v1/bluesky/comments` | Comment[] | 1 | | `GET /v1/bluesky/search` | SearchResult[] | 1 | ## Profile Get a public profile by handle. `GET /v1/bluesky/profile` → `Profile` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | ```bash curl -G https://api.crawlfeed.dev/v1/bluesky/profile \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=jay.bsky.team" ``` ## Posts List a profile's recent posts. `GET /v1/bluesky/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/bluesky/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=jay.bsky.team" ``` ## Post Get a single post by id. `GET /v1/bluesky/post` → `Post` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The post id on that platform. | ```bash curl -G https://api.crawlfeed.dev/v1/bluesky/post \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Comments List comments on a post. `GET /v1/bluesky/comments` → `Comment[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `post_id` | yes | The post to read comments from. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/bluesky/comments \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "post_id=" ``` ## Search Search one platform. `GET /v1/bluesky/search` → `SearchResult[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/bluesky/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=climate tech" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # Reddit · crawlfeed Subreddits, posts, full comment trees, search and video transcripts. Base price: 1 credit per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/reddit/profile` | Profile | 1 | | `GET /v1/reddit/posts` | Post[] | 1 | | `GET /v1/reddit/post` | Post | 1 | | `GET /v1/reddit/comments` | Comment[] | 1 | | `GET /v1/reddit/search` | SearchResult[] | 1 | | `GET /v1/reddit/transcript` | Transcript | 1 | | `GET /v1/reddit/search/posts` | Post[] | 1 | | `GET /v1/reddit/community` | Profile | 1 | | `GET /v1/reddit/community/posts` | Post[] | 1 | | `GET /v1/reddit/community/search` | Post[] | 1 | ## Profile Get a public profile by handle. `GET /v1/reddit/profile` → `Profile` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | ```bash curl -G https://api.crawlfeed.dev/v1/reddit/profile \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=r/coffee" ``` ## Posts List a profile's recent posts. `GET /v1/reddit/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/reddit/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=r/coffee" ``` ## Post Get a single post by id. `GET /v1/reddit/post` → `Post` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The post id on that platform. | ```bash curl -G https://api.crawlfeed.dev/v1/reddit/post \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Comments List comments on a post. `GET /v1/reddit/comments` → `Comment[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `post_id` | yes | The post to read comments from. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/reddit/comments \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "post_id=" ``` ## Search Search one platform. `GET /v1/reddit/search` → `SearchResult[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/reddit/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=espresso" ``` ## Transcript The spoken text of a video, with timings when available. `GET /v1/reddit/transcript` → `Transcript` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The video or post id, or its URL. | ```bash curl -G https://api.crawlfeed.dev/v1/reddit/transcript \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Search posts Posts matching a keyword. `GET /v1/reddit/search/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/reddit/search/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=espresso" ``` ## Community A community (subreddit, group) as a profile. `GET /v1/reddit/community` → `Profile` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Community name or URL. | ```bash curl -G https://api.crawlfeed.dev/v1/reddit/community \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=r/coffee" ``` ## Community posts Posts in a community, or a channel’s community tab. `GET /v1/reddit/community/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Community name or URL, or a YouTube channel handle. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/reddit/community/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Search a community Posts matching a keyword inside one community. `GET /v1/reddit/community/search` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Community name or URL. | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/reddit/community/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=r/coffee" \ --data-urlencode "q=espresso" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # Pinterest · crawlfeed Pins, boards and pin search. Base price: 1 credit per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/pinterest/post` | Post | 1 | | `GET /v1/pinterest/search` | SearchResult[] | 1 | | `GET /v1/pinterest/search/posts` | Post[] | 1 | | `GET /v1/pinterest/collections` | Collection[] | 1 | | `GET /v1/pinterest/collection/posts` | Post[] | 1 | ## Post Get a single post by id. `GET /v1/pinterest/post` → `Post` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The post id on that platform. | ```bash curl -G https://api.crawlfeed.dev/v1/pinterest/post \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Search Search one platform. `GET /v1/pinterest/search` → `SearchResult[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/pinterest/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=climate tech" ``` ## Search posts Posts matching a keyword. `GET /v1/pinterest/search/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/pinterest/search/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=coffee" ``` ## Collections A profile's playlists, boards or story highlights. `GET /v1/pinterest/collections` → `Collection[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @, or the profile URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/pinterest/collections \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=nasa" ``` ## Collection posts The posts in a playlist, board, highlight or podcast. `GET /v1/pinterest/collection/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Playlist, board, highlight or podcast id, or its URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/pinterest/collection/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # Truth Social · crawlfeed Profiles and posts. Base price: 1 credit per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/truthsocial/profile` | Profile | 1 | | `GET /v1/truthsocial/posts` | Post[] | 1 | | `GET /v1/truthsocial/post` | Post | 1 | ## Profile Get a public profile by handle. `GET /v1/truthsocial/profile` → `Profile` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | ```bash curl -G https://api.crawlfeed.dev/v1/truthsocial/profile \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=realDonaldTrump" ``` ## Posts List a profile's recent posts. `GET /v1/truthsocial/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/truthsocial/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=realDonaldTrump" ``` ## Post Get a single post by id. `GET /v1/truthsocial/post` → `Post` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The post id on that platform. | ```bash curl -G https://api.crawlfeed.dev/v1/truthsocial/post \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # Kick · crawlfeed Clips. Base price: 1 credit per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/kick/post` | Post | 1 | ## Post Get a single post by id. `GET /v1/kick/post` → `Post` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The post id on that platform. | ```bash curl -G https://api.crawlfeed.dev/v1/kick/post \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # Rumble · crawlfeed Channels, videos, comments, search and transcripts. Base price: 1 credit per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/rumble/posts` | Post[] | 1 | | `GET /v1/rumble/post` | Post | 1 | | `GET /v1/rumble/comments` | Comment[] | 1 | | `GET /v1/rumble/search` | SearchResult[] | 1 | | `GET /v1/rumble/transcript` | Transcript | 1 | | `GET /v1/rumble/summary` | Summary | 4 | | `GET /v1/rumble/search/posts` | Post[] | 1 | ## Posts List a profile's recent posts. `GET /v1/rumble/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/rumble/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=Bongino" ``` ## Post Get a single post by id. `GET /v1/rumble/post` → `Post` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The post id on that platform. | ```bash curl -G https://api.crawlfeed.dev/v1/rumble/post \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Comments List comments on a post. `GET /v1/rumble/comments` → `Comment[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `post_id` | yes | The post to read comments from. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/rumble/comments \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "post_id=" ``` ## Search Search one platform. `GET /v1/rumble/search` → `SearchResult[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/rumble/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=climate tech" ``` ## Transcript The spoken text of a video, with timings when available. `GET /v1/rumble/transcript` → `Transcript` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The video or post id, or its URL. | ```bash curl -G https://api.crawlfeed.dev/v1/rumble/transcript \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Summary An AI summary of a video: a few sentences, the key points and the topics, written from its transcript. `GET /v1/rumble/summary` → `Summary` · 4 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The video or post id, or its URL. | | `lang` | no | Language to write the summary in (ISO 639-1, e.g. en, ar). Defaults to the video’s language. | ```bash curl -G https://api.crawlfeed.dev/v1/rumble/summary \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Search posts Posts matching a keyword. `GET /v1/rumble/search/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/rumble/search/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=coffee" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # Kwai · crawlfeed Profiles and videos. Base price: 1 credit per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/kwai/profile` | Profile | 1 | | `GET /v1/kwai/posts` | Post[] | 1 | | `GET /v1/kwai/post` | Post | 1 | ## Profile Get a public profile by handle. `GET /v1/kwai/profile` → `Profile` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | ```bash curl -G https://api.crawlfeed.dev/v1/kwai/profile \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=kwai" ``` ## Posts List a profile's recent posts. `GET /v1/kwai/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/kwai/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=kwai" ``` ## Post Get a single post by id. `GET /v1/kwai/post` → `Post` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | The post id on that platform. | ```bash curl -G https://api.crawlfeed.dev/v1/kwai/post \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # GitHub · crawlfeed Users, repositories, repository search, followers and trending. Base price: 1 credit per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/github/profile` | Profile | 1 | | `GET /v1/github/posts` | Post[] | 1 | | `GET /v1/github/post` | Post | 1 | | `GET /v1/github/search` | SearchResult[] | 1 | | `GET /v1/github/followers` | Profile[] | 1 | | `GET /v1/github/following` | Profile[] | 1 | | `GET /v1/github/trending/profiles` | Profile[] | 1 | | `GET /v1/github/pull-requests` | Post[] | 1 | | `GET /v1/github/trending` | Post[] | 1 | ## Profile Get a public profile by handle. `GET /v1/github/profile` → `Profile` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | GitHub username. | ```bash curl -G https://api.crawlfeed.dev/v1/github/profile \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=torvalds" ``` ## Posts List a profile's recent posts. `GET /v1/github/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | GitHub username. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/github/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=torvalds" ``` ## Post Get a single post by id. `GET /v1/github/post` → `Post` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | owner/repository | ```bash curl -G https://api.crawlfeed.dev/v1/github/post \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Search Search one platform. `GET /v1/github/search` → `SearchResult[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/github/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=vector database" ``` ## Followers Accounts that follow a profile. `GET /v1/github/followers` → `Profile[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @, or the profile URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/github/followers \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=torvalds" ``` ## Following Accounts a profile follows. `GET /v1/github/following` → `Profile[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @, or the profile URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/github/following \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=torvalds" ``` ## Trending profiles Popular creators or developers right now. `GET /v1/github/trending/profiles` → `Profile[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `country` | no | ISO country code, e.g. US. | | `language` | no | Programming language (GitHub). | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/github/trending/profiles \ -H "Authorization: Bearer $CRAWLFEED_KEY" ``` ## Pull requests Pull requests a developer opened, newest first. `GET /v1/github/pull-requests` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | GitHub username or profile URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/github/pull-requests \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=torvalds" ``` ## Trending What is trending on the platform right now. `GET /v1/github/trending` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `country` | no | ISO country code, e.g. US. | | `language` | no | Programming language (GitHub). | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/github/trending \ -H "Authorization: Bearer $CRAWLFEED_KEY" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # Spotify · crawlfeed Artists, tracks, albums, playlists, podcasts and search. Base price: 1 credit per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/spotify/profile` | Profile | 1 | | `GET /v1/spotify/posts` | Post[] | 1 | | `GET /v1/spotify/post` | Post | 1 | | `GET /v1/spotify/search` | SearchResult[] | 1 | | `GET /v1/spotify/collection` | Collection | 1 | | `GET /v1/spotify/collection/posts` | Post[] | 1 | | `GET /v1/spotify/collection/tracks` | Track[] | 1 | | `GET /v1/spotify/track` | Track | 1 | | `GET /v1/spotify/tracks` | Track[] | 1 | ## Profile Get a public profile by handle. `GET /v1/spotify/profile` → `Profile` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Spotify artist ID (22 characters). | ```bash curl -G https://api.crawlfeed.dev/v1/spotify/profile \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02" ``` ## Posts List a profile's recent posts. `GET /v1/spotify/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Spotify artist ID (22 characters). | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/spotify/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02" ``` ## Post Get a single post by id. `GET /v1/spotify/post` → `Post` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Spotify album ID (22 characters). | ```bash curl -G https://api.crawlfeed.dev/v1/spotify/post \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Search Search one platform. `GET /v1/spotify/search` → `SearchResult[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/spotify/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=lofi" ``` ## Collection One playlist, album or podcast. `GET /v1/spotify/collection` → `Collection` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Playlist, album or podcast id, or its URL. | ```bash curl -G https://api.crawlfeed.dev/v1/spotify/collection \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Collection posts The posts in a playlist, board, highlight or podcast. `GET /v1/spotify/collection/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Playlist, board, highlight or podcast id, or its URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/spotify/collection/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Collection tracks The tracks in a playlist or album. `GET /v1/spotify/collection/tracks` → `Track[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Playlist or album id, or its URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/spotify/collection/tracks \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Track One track or sound. `GET /v1/spotify/track` → `Track` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Track or sound id, or its URL. | ```bash curl -G https://api.crawlfeed.dev/v1/spotify/track \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Tracks An artist's tracks. `GET /v1/spotify/tracks` → `Track[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Artist handle, id or URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/spotify/tracks \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # SoundCloud · crawlfeed Artists and their tracks. Base price: 1 credit per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/soundcloud/profile` | Profile | 1 | | `GET /v1/soundcloud/track` | Track | 1 | | `GET /v1/soundcloud/tracks` | Track[] | 1 | ## Profile Get a public profile by handle. `GET /v1/soundcloud/profile` → `Profile` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | ```bash curl -G https://api.crawlfeed.dev/v1/soundcloud/profile \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=flume" ``` ## Track One track or sound. `GET /v1/soundcloud/track` → `Track` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Track or sound id, or its URL. | ```bash curl -G https://api.crawlfeed.dev/v1/soundcloud/track \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Tracks An artist's tracks. `GET /v1/soundcloud/tracks` → `Track[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Artist handle, id or URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/soundcloud/tracks \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=flume" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # Apple Music · crawlfeed Artists, albums, songs and search. Base price: 1 credit per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/apple_music/profile` | Profile | 1 | | `GET /v1/apple_music/search` | SearchResult[] | 1 | | `GET /v1/apple_music/collection` | Collection | 1 | | `GET /v1/apple_music/collection/tracks` | Track[] | 1 | | `GET /v1/apple_music/track` | Track | 1 | ## Profile Get a public profile by handle. `GET /v1/apple_music/profile` → `Profile` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Username without the @. | ```bash curl -G https://api.crawlfeed.dev/v1/apple_music/profile \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=https://music.apple.com/us/artist/taylor-swift/159260351" ``` ## Search Search one platform. `GET /v1/apple_music/search` → `SearchResult[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/apple_music/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=lofi" ``` ## Collection One playlist, album or podcast. `GET /v1/apple_music/collection` → `Collection` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Playlist, album or podcast id, or its URL. | ```bash curl -G https://api.crawlfeed.dev/v1/apple_music/collection \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Collection tracks The tracks in a playlist or album. `GET /v1/apple_music/collection/tracks` → `Track[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Playlist or album id, or its URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/apple_music/collection/tracks \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Track One track or sound. `GET /v1/apple_music/track` → `Track` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Track or sound id, or its URL. | ```bash curl -G https://api.crawlfeed.dev/v1/apple_music/track \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # Google · crawlfeed Organic web search and the Ads Transparency Center. Base price: 1 credit per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/google/search` | SearchResult[] | 1 | | `GET /v1/google/ads` | Ad[] | 1 | | `GET /v1/google/ad` | Ad | 1 | | `GET /v1/google/advertisers/search` | Advertiser[] | 1 | ## Search Search one platform. `GET /v1/google/search` → `SearchResult[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/google/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=unified social data api" ``` ## An advertiser's ads Every ad an advertiser is running or ran. `GET /v1/google/ads` → `Ad[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `advertiser` | yes | Advertiser name, page id or domain. | | `country` | no | ISO country code. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/google/ads \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "advertiser=nike.com" ``` ## Ad One ad from the ad library. `GET /v1/google/ad` → `Ad` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Ad id or ad-library URL. | ```bash curl -G https://api.crawlfeed.dev/v1/google/ad \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Search advertisers Find an advertiser, and the id its ads are filed under. `GET /v1/google/advertisers/search` → `Advertiser[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/google/advertisers/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=unified social data api" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # Amazon · crawlfeed Creator storefronts and the products they feature. Base price: 1 credit per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/amazon/shop/products` | Product[] | 1 | ## Shop products A shop's or creator storefront's products. `GET /v1/amazon/shop/products` → `Product[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `shop` | yes | The shop or storefront URL. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/amazon/shop/products \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "shop=" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # Hacker News · crawlfeed Users, their submissions, single items and comment threads. Base price: 1 credit per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/hackernews/profile` | Profile | 1 | | `GET /v1/hackernews/posts` | Post[] | 1 | | `GET /v1/hackernews/post` | Post | 1 | | `GET /v1/hackernews/comments` | Comment[] | 1 | ## Profile Get a public profile by handle. `GET /v1/hackernews/profile` → `Profile` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Hacker News username. | ```bash curl -G https://api.crawlfeed.dev/v1/hackernews/profile \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=charlidamelio" ``` ## Posts List a profile's recent posts. `GET /v1/hackernews/posts` → `Post[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Hacker News username. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/hackernews/posts \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=charlidamelio" ``` ## Post Get a single post by id. `GET /v1/hackernews/post` → `Post` · 1 credits | Param | Required | Description | | --- | --- | --- | | `id` | yes | Numeric Hacker News item ID. | ```bash curl -G https://api.crawlfeed.dev/v1/hackernews/post \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "id=" ``` ## Comments List comments on a post. `GET /v1/hackernews/comments` → `Comment[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `post_id` | yes | The post to read comments from. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/hackernews/comments \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "post_id=" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`. --- # App Store · crawlfeed Apps by numeric id or bundle id, and App Store search. Base price: 1 credit per call. Auth: `Authorization: Bearer $CRAWLFEED_KEY`. Base URL: https://api.crawlfeed.dev | Endpoint | Returns | Credits | | --- | --- | --- | | `GET /v1/appstore/profile` | Profile | 1 | | `GET /v1/appstore/search` | SearchResult[] | 1 | ## Profile Get a public profile by handle. `GET /v1/appstore/profile` → `Profile` · 1 credits | Param | Required | Description | | --- | --- | --- | | `handle` | yes | Numeric app ID or bundle ID. | ```bash curl -G https://api.crawlfeed.dev/v1/appstore/profile \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "handle=123456789" ``` ## Search Search one platform. `GET /v1/appstore/search` → `SearchResult[]` · 1 credits | Param | Required | Description | | --- | --- | --- | | `q` | yes | What to search for. | | `cursor` | no | Continue from a previous page. | ```bash curl -G https://api.crawlfeed.dev/v1/appstore/search \ -H "Authorization: Bearer $CRAWLFEED_KEY" \ --data-urlencode "q=climate tech" ``` Every response is `{ data, meta }`. `meta` has `credits_used`, `credits_remaining`, `cache`, `data_age_s`, `request_id` and, on paged routes, `next_cursor`.