Fetch - Documentation

POST

/

fetch

Fetch

curl --request POST \
  --url https://api.istari.ai/v2/fetch \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "domains": [
    "<string>"
  ],
  "columns": [
    "<string>"
  ]
}
'

{
  "data": [
    {}
  ],
  "metadata": {
    "requested": 123,
    "found": 123,
    "missing": [
      "<string>"
    ]
  }
}

Authorizations

x-api-key

string

header

required

Your GOI API key. Create one on the GOI dashboard under API keys.

Body

application/json

domains

string[]

required

Required array length: 1 - 5000 elements

columns

string[]

Response

Successful Response

data

Data · object[]

required

metadata

FetchMetadata · object

required

Diagnostics returned alongside /v1/fetch results.

Show child attributes

Aggregate counts — group by dimension(s) with filtersReturns `COUNT(*)` bucketed by one or two categorical dimensions with optional column filters and an optional date range. No search scoring — pure SQL `GROUP BY`. **Use cases:** NACE distribution by country, org size breakdown, top keywords for a sector, monthly registration trends. **Dimensions (`group_by` / `group_by_secondary`):** continent, country, country_code, state, state_code, region, region_code, district, district_code, municipality, municipality_code, nace_code, organization_type, organization_size, employee_class, revenue_class, summary_keywords (unnested), company_register_date, created_at. `summary_keywords` is automatically unnested — each keyword in the array counts as its own bucket. Date dimensions use `DATE_TRUNC` and are ordered chronologically (ASC). All other dimensions are ordered by count DESC. Monthly request quotas apply by API key tier.

Fetch

curl --request POST \
  --url https://api.istari.ai/v2/fetch \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "domains": [
    "<string>"
  ],
  "columns": [
    "<string>"
  ]
}
'

{
  "data": [
    {}
  ],
  "metadata": {
    "requested": 123,
    "found": 123,
    "missing": [
      "<string>"
    ]
  }
}