Data API

Everything Search does is one HTTP call you can make yourself. Base URL: https://api.datasocial.ai

Get a key

Sign in, open the API keys tab and create a key. It looks like ds_live_… and is shown once, so copy it somewhere safe. Send it as a bearer token. Queries with a key are charged to your credits, exactly like Search.

Without a key the API still answers, with the free limits (1,000 rows, 10 seconds, 20 queries a minute per address).

Run a query

curl https://api.datasocial.ai/v1/data/sql \
  -H "Authorization: Bearer $DATASOCIAL_KEY" \
  -H 'content-type: application/json' \
  -d '{"sql": "SELECT username, followers FROM tiktok.creators WHERE country = '\''US'\'' ORDER BY followers DESC LIMIT 3"}'

The response

{
  "columns": [{ "name": "username", "type": "String" }, { "name": "followers", "type": "UInt32" }],
  "rows": [["khaby.lame", 162989705], ["charlidamelio", 160221160], ["tiktok", 95949280]],
  "row_cap": 1000,
  "capped": false,
  "rows_read": 5029786,
  "bytes_read": 65283020,
  "elapsed_ms": 187
}

• rows are arrays in the order of columns. 64-bit integers (ids) arrive as strings.
• capped is true when the result hit the row cap (row_cap).
• With a key, credits says what the query cost and what is left: {"charged": 3, "balance": 997}.

Errors

A failed query answers with a status and {"error": "…"} in plain words. Errors are free.

Endpoints