Docs · Getting started

Authentication

Every call needs an Authorization header with your API key.

GET /v1/me

DataSonar uses Bearer token authentication. Your API key starts with osk_ and is a 192-bit random token shown to you once at signup. Treat it like a password — do not commit it, do not log it, rotate it if it leaks.

Request

curl https://api.datasonar.dev/v1/me \
  -H "Authorization: Bearer osk_..."

Response

{
  "user": {
    "email": "you@example.com",
    "plan": "pro",
    "limit": 100000
  },
  "usage": {
    "requests_this_month": 4127,
    "requests_today": 281,
    "avg_response_ms": 412,
    "success_rate": 99.4
  }
}

Errors

Code Meaning
401 Missing or invalid Authorization header, or the key has been revoked.

Related

POST /v1/scrape
Quickstart
GET /v1/me
Rate limits and quotas