FlashData API V2

Quickstart

Create a scoped test key, submit one realtime query, and trace the response with its request ID.

1. Create a test API key

Sign in, create a key with queries:read and queries:write, and store the one-time secret immediately. Never place it in browser code.

2. Run a realtime query

The source schema owns every parameter. Retry the same request with the same idempotency key.

Terminal

curl 'https://data.flashdata.dev/v2/queries/realtime' \
  --header 'X-API-Key: fd_test_REPLACE_ONCE' \
  --header 'Idempotency-Key: first_query_01' \
  --header 'Content-Type: application/json' \
  --data '{
    "source": "google_search",
    "params": { "query": "distributed systems" }
  }'

3. Trace the result

Keep the response requestId, query ID, status, and charged microcredits together in application logs.

Read error and retry semantics