Skip to main content
Use it to discover organizations (keyword, semantic description, similarity to known domains, or filters alone), look up known domains in bulk, and (on eligible tiers) run aggregations and read filter option lists.
Interactive reference: try endpoints in the API Playground.
Don’t have a key yet? Create one under API keys in the GOI dashboard.

​
Base URL

All GOI API paths are under: 
https://api.istari.ai/v2/
Examples:
  • POST https://api.istari.ai/v2/search
  • POST https://api.istari.ai/v2/fetch

​
Authentication

Every request must include your API key: 
x-api-key: <your-api-key>
Keys are issued for GOI access tiers (tier_1 or tier_2). Quotas and rate limits depend on the tier assigned to your key (see Reference).

​
Quick example : search

curl --location 'https://api.istari.ai/v2/search' \
  --header 'Accept: application/json' \
  --header 'x-api-key: your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "describe": "SaaS organizations in the US",
    "keywords": {
      "must_all": [],
      "must_any": [],
      "must_not": []
    },
    "filters": {
      "country": ["United States"],
      "state": [],
      "region": [],
      "organization_type": [],
      "organization_size": [],
      "nace_code": []
    },
    "excludes": [],
    "columns": ["domain"],
    "size": 50
  }'

​
Endpoints at a glance

Paths are relative to https://api.istari.ai/v2.
MethodPathPurpose
POST/searchSearch and rank organisations (modes described in Search)
POST/fetchBulk lookup by domain list: no scoring (Fetch, stats & utilities)
POST/statsAggregations (COUNT by dimension); monthly quota by tier
GET/filters/optionsAllowed values for categorical filters (scoped to your key)
GET/healthLiveness / database check

​
Documentation map