Discovery

Search the catalog

Full-text and semantic search over dataset metadata. Works in any language (this is the multilingual arm — resolution below is English-only). Never metered.

get/v1/search

Request

  • Base URL: https://api.stackdata.io
  • URL: https://api.stackdata.io/v1/search
  • Auth: one of:
    • none
    • API key in header X-API-Key

Query parameters

qstring required

The search query, in any language.

limitinteger

Clamped to 5..200 — retrieval never returns fewer than a top-5 candidate set, so limit=1 yields 5 results.

countrystring

Filter to datasets scoped to this country.

kindstring

Filter by resource kind (e.g. a statistical dataflow vs. a document).

open_onlyboolean

Return only datasets under an open licence.

Response

Ranked results.

querystring
applied_filtersobject

Echo of the filters that actually ran (a filter that could not run is a 400, never a silent drop).

resultsobject[]

Example response

{
  "returned": {
    "value": 2807,
    "exact": true
  },
  "meta": {
    "harvest": {
      "ilo": "2026-08-10 03:14:22",
      "wb": "2026-08-10 03:15:01"
    },
    "api_version": "0.1"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.