DocsGet an API key
Get started

Quickstart

crawlfeed reads public data from 26 platforms and returns it in one shape. This page takes you from zero to a working call. Every verified account starts with 100 free credits, which is about 100 calls.

1. Get a key

Create an account and verify your email. A key holding your free credits is waiting under API keys in the dashboard. It is shown once, so copy it somewhere safe, then export it:

shell
export CRAWLFEED_KEY="sk_live_…"

2. Make a call

Read a TikTok profile:

curl -G https://api.crawlfeed.dev/v1/tiktok/profile \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "handle=charlidamelio"

3. Read the response

Every successful response is { data, meta }. data is a unified Profile: the same fields whether it came from TikTok, YouTube or Bluesky. meta tells you what the call cost and where the data came from.

response
{
  "data": { … },            // one object, or an array on paged routes
  "meta": {
    "credits_used": 1,
    "credits_remaining": 2499,
    "cache": "MISS",          // or "HIT"
    "data_age_s": 0,          // seconds since we fetched it upstream
    "request_id": "req_01K5…",
    "next_cursor": "eyJ…"     // paged routes only, absent on the last page
  }
}

4. Change the platform

Swap tiktok for instagram, youtube or bluesky and the same code keeps working. That is the whole idea. Each platform page lists what it serves, what each call costs, and a request you can paste.

Where next