Using the API

Search across platforms

One query over several platforms, with per-platform outcomes.

GET /v1/search?q=… runs one query on several platforms at once and returns SearchResults, each tagged with a kind (profile, post, and so on). Choose platforms with platforms=tiktok,youtube,x.

shell

curl -G https://api.crawlfeed.dev/v1/search \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "q=specialty coffee" \
  --data-urlencode "platforms=tiktok,youtube,bluesky"

Per-platform outcomes

meta.platforms reports each platform you asked for as ok, error or pending. A platform that fails is refunded and marked error; the others still return.

Slow platforms and jobs

If some platforms have not answered within the time budget, the response is 202 with what is ready plus meta.job_id. Poll GET /v1/jobs/{job_id} (free) until it returns 200.

Cost

The sum of each requested platform’s search price. Platforms that fail are refunded.

To search one platform, use its own /v1/{platform}/search route instead. Several platforms also have narrower searches, such as search/posts and search/profiles; see each platform page.