Overview

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>

Each key has an API tier. New keys get tier_1; tier_2 is available on request. Quotas and rate limits depend on your key’s tier (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.

Method	Path	Purpose
`POST`	`/search`	Search and rank organisations (modes described in Search)
`POST`	`/fetch`	Bulk lookup by domain list: no scoring (Fetch, stats & utilities)
`POST`	`/stats`	Aggregations (`COUNT` by dimension); monthly quota by tier
`GET`	`/filters/options`	Allowed values for categorical filters (scoped to your key)
`GET`	`/locations`	Browse administrative areas for geographic filters
`GET`	`/locations/search`	Find the exact place name for a geographic filter
`GET`	`/health`	Liveness / database check

Documentation map

Search: request body, auto-detected modes, keywords, similar_to, describe, filters, pagination, deduplication
Fetch, stats & utilities: /fetch, /stats, /filters/options, /locations, and health
Reference: columns, filters, limits & errors: response fields, quotas, HTTP errors

Getting Started

Global Organization Index

GOI API

GOI MCP

Research Data

Base URL

Authentication

Quick example : search

Endpoints at a glance

Documentation map

​Base URL

​Authentication

​Quick example : search

​Endpoints at a glance

​Documentation map

Base URL

Authentication

Quick example : search

Endpoints at a glance

Documentation map