Skip to content
Docs
Datasets

One dataset and its columns

Column documentation, freshness and the first 20 current rows. Free.

GET/v1/datasets/{name}
FreeTry it

Datasets over `BIG_ITEMS omit the sample (an unfiltered scan is too slow); query /latest` with a filter instead.

Request

GEThttps://api.scrapercompany.com/v1/datasets/{name}

Authenticate with your API key in the x-api-key header (see Authentication).

Run this request on your own API key from this page, with the values you type. Signed out? Sign in or get an API key.

Parameters

  • namestringpathrequired

Example request

curl "https://api.scrapercompany.com/v1/datasets/llm-prices" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY"

Response

200 — Columns, freshness and a sample.

200 response
{
  "name": "llm-prices",
  "title": "LLM token prices",
  "description": "Input, output and cache prices per million tokens.",
  "refresh_every_hours": 6,
  "sources": [
    "openrouter.ai/api/v1/models"
  ],
  "attribution": "",
  "tags": [
    "ai",
    "pricing"
  ],
  "columns": {
    "items": {
      "model": {
        "type": "TEXT",
        "doc": "the host's own model id"
      }
    },
    "observations": {
      "input_usd_per_1m": {
        "type": "REAL",
        "doc": "input price, USD per 1M tokens"
      }
    }
  },
  "stats": {
    "items": 3905,
    "observations": 3905,
    "first_day": "2027-02-20",
    "last_day": "2027-02-20",
    "built_at": "2026-11-03T04:17:40+00:00"
  },
  "sample": [
    {
      "item_id": "openrouter/openai/gpt-6.1-terra",
      "host": "openrouter",
      "model": "openai/gpt-6.1-terra",
      "vendor": "openai",
      "name": "OpenAI: GPT-6.1 Terra",
      "mode": "chat",
      "modality": "text+image+file->text",
      "context_tokens": 1050000,
      "max_output_tokens": 128000,
      "input_usd_per_1m": 1,
      "output_usd_per_1m": 5,
      "cache_read_usd_per_1m": 0.05,
      "cache_write_usd_per_1m": 1.25,
      "long_context_input_usd_per_1m": 2,
      "source": "openrouter",
      "value_since": "2027-02-20",
      "last_seen": "2027-02-20"
    }
  ]
}

Errors

Errors return a JSON body with a detail field. Failed requests are not charged. See Errors for the full list and retry advice.

StatusMeaningRetry?
401Unauthorized

Missing or invalid API key.

{"detail":"missing or invalid API key"}		No, fix the request
404Not Found

The property, stay, job or record was not found.

{"detail":"job not found"}		No, fix the request
422Unprocessable Content

Request validation failed.

{"detail":[{"loc":["body","token"],"msg":"Field required","type":"missing"}]}		No, fix the request
429Too Many Requests

Too many requests: the key's requests-per-minute limit was exceeded, or (in enforce credits mode) the plan's concurrent-request limit. No rate-limit or Retry-After headers are sent; back off and retry.

{"detail":"rate limit 60/min exceeded"}		Yes, with backoff
503Service Unavailable

Temporarily unavailable: a dependency of this endpoint is down, or the upstream source changed its contract. Retry later.

{"detail":"database unavailable: OperationalError"}		Yes, with backoff

Try it

Press Try it above to run this request on your own key, with the values you type (sign in first). For a no-code walkthrough, use the workspace’s guided Try it.

  1. Export your key: export SCRAPERCOMPANY_API_KEY=sk_... (no key yet? start a free trial).
  2. Copy the cURL example above and run it in a terminal.

Questions about this page?

Send the page link and your question, and the team will answer.

Email support