Schema

POST /v1/scry/query

The synchronous SQL-over-HTTPS endpoint for Scry: send bounded read-only SQL (ClickHouse dialect) as text and receive one JSON document or a typed HTTP error within the advertised execution ceiling.

Contract

  • ObjectPOST /v1/scry/query
  • Typeendpoint
  • Pathhttps://api.scry.io/v1/scry/query

Best for

agent tool calls
bounded research jobs
reproducible public-data queries

Fields

  • Authorization
  • Content-Type: text/plain
  • SQL body
  • JSON rows
  • long queries first-class: ~2000s execution ceiling

SQL

Minimal SQL call

Send a bounded read-only SQL query over HTTPS.

curl https://api.scry.io/v1/scry/query \
  -H "Authorization: Bearer $SCRY_API_KEY" \
  -H "Content-Type: text/plain" \
  --data "SELECT hn_id, title, original_author, original_timestamp, uri FROM hackernews.items WHERE title != '' ORDER BY hn_id DESC LIMIT 20"

Related sources

Hacker News hackernews.items