Data API

The Data API base URL is:

https://api.soriaanalytics.com/v1

Authenticate with a Soria API key as a bearer token. Treat the key like a password: never share it, commit it, or expose it in browser code.

curl "https://api.soriaanalytics.com/v1/catalog" \
  --header "Authorization: Bearer $SORIA_API_KEY"

Endpoints

Method	Path	Purpose
`GET`	`/catalog`	Searches or lists datasets available to the account.
`GET`	`/catalog/{dataset}`	Returns schema, grain, methodology, cadence, and source lineage.
`GET`	`/catalog/{dataset}/metadata`	Returns compact dataset metadata.
`POST`	`/datasets/{dataset}/query`	Selects, filters, sorts, and paginates rows.
`GET`	`/datasets/{dataset}/stats`	Counts rows and optionally profiles one column.
`GET`	`/datasets/{dataset}/files`	Lists source files contributing to a dataset.
`GET`	`/datasets/{dataset}/files/{file_id}`	Returns a temporary original-file download URL.
`POST`	`/datasets/{dataset}/exports`	Queues a CSV or Parquet export.
`GET`	`/exports/{export_id}`	Returns export status.
`GET`	`/exports/{export_id}/download`	Redirects to a temporary export URL.
`POST`	`/search/documents`	Searches public source documents.

API reference

Browse the endpoint reference for parameters, schemas, responses, and request examples. The OpenAPI schema (JSON) is also available directly.

Query a dataset

Use a dataset and columns returned by the catalog:

curl --request POST \
  "https://api.soriaanalytics.com/v1/datasets/<dataset>/query" \
  --header "Authorization: Bearer $SORIA_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "columns": ["<column_1>", "<column_2>"],
    "filters": [
      {"column": "<column_1>", "operator": "eq", "value": "<value>"}
    ],
    "order_by": [{"column": "<column_2>", "direction": "desc"}],
    "limit": 100,
    "offset": 0
  }'

For source files, see Download a source file.

⌘I