One key, every platform, and what you can do with it

Onekey is one API for public data. These pages cover the parts around the endpoints: how an assistant connects, how a question spans platforms, how change reaches you, and what to expect when things fail. Anything that is not enabled yet says so.

What one call replaces

Many integrations become one request, and a report shows what happens inside it, including a source that fails.

12 calls become 1

Before: 12 integrations

your code12 clientsRedditHacker NewsBlueskyMastodonGitHubGitLabDEV CommunityYouTubeTwitchLobstersX (Twitter)Instagram

12 keys to rotate, 12 response shapes to map, 12 sets of limits and retries to handle yourself.

After: 1 call

your code1 clientone request12 platforms, 1 keyone shapesuccess, data

GET /v1/search/multi with platforms=: one key, one response shape, and a platform that fails shows in coverage and is refunded.

The after side is the multi-platform search route (api.onekey.dev/v1/search/multi), up to 20 platforms per call. Read how it bills and what a partial answer looks like.

one call, four legs, one receipt

1 request

GET /v1/reports/creator-vet
?handle=torvalds
&platforms=github,bluesky,reddit

4 legs, in parallel

  • github.profile...2001 credit
  • bluesky.profile...2001 credit
  • bluesky.posts...2001 credit
  • reddit.user_about...502 UPSTREAM_BLOCKED1 credit
join coverage: answered 3, failed 1 (Reddit). The failed platform is null, never 0.

1 receipt

github.profile1

bluesky.profile1

bluesky.posts1

reddit.user_about0 refunded

total charged3

Timing is illustrative. The report, its legs, their prices and the 502 are from the creator vet report: only legs that answered are charged, a failed leg is refunded and named in coverage, and dry_run=true shows these prices for 0 credits.

Connect

Reach the data from an assistant, a workflow tool or your own code.

Ask and watch

Questions and jobs that span platforms, on demand or on a schedule.

Understand and trust

What comes back, what happens when things fail, and how to evaluate us.

Browse the rest

The catalog, worked examples, free tools and the reference.