Skip to content
Docs
Datasets

Latest values

Each item's newest values with `value_since` (the day they last changed). One credit per call.

GET/v1/datasets/{name}/latest
1 creditTry it

Filter on any of the dataset's `filters (listed by GET /v1/datasets/{name}) with f.<column>=<value>, an exact match, e.g. f.state=OH&f.code=70551` on hospital-prices. Datasets over 250,000 items need at least one filter.

Request

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

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
  • qstringdefault max length 100

    Substring matched against the text columns.

  • limitintegerdefault 100min 1, max 1000
  • offsetintegerdefault 0min 0, max 1000000
  • include_gonebooleandefault false

    Also return items missing from the newest run.

Example request

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

Response

200 — Each item's newest values. Metered responses carry x-credits-charged and x-credits-remaining headers (see credit headers).

200 response
{
  "dataset": "llm-prices",
  "stats": {
    "items": 3905,
    "observations": 3905,
    "first_day": "2027-02-20",
    "last_day": "2027-02-20",
    "built_at": "2026-11-03T04:17:40+00:00"
  },
  "rows": [
    {
      "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
402Payment Required

Not enough credits for this request: the account's credits mode is enforce (mode in GET /v1/billing) and the request costs more than the available credits. Nothing is run or charged.

{"detail":"insufficient credits: this request costs 5, 0 available. Credits renew 2026-11-01."}
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 is a list of problems for schema errors, or a string for semantic checks performed by the endpoint.

{"detail":[{"loc":["body","name"],"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.

Credits

1 credit per successful call. Failed, blocked and empty results are free.

Questions about this page?

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

Email support