---
title: "Ask in plain words (AI)"
method: GET
path: "/api/v1/find"
---

# Ask in plain words (AI)

`GET /api/v1/find`

## Request

- Base URL: `https://api.datagalactica.com`
- URL: `https://api.datagalactica.com/api/v1/find`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`
  - API key in header `Ocp-Apim-Subscription-Key`
  - OAuth 2 (authorization code, authorization URL `https://datagalactica.com/oauth/authorize`, token URL `https://datagalactica.com/oauth/token`, scopes: `api`)

A name or a question in plain English, read by a language model into the /search filters, matched, and topped up with records close in meaning. data.understood shows the reading; a plain name is matched without the model.

## Query parameters

- `q` string, required
- `type` 'all' | 'company' | 'person'
- `limit` integer
- `offset` integer

## Response `200`

ok

- object
  - `ok` unknown, required
  - `data` object, required
    - `understood` object, nullable: The filters the question was read into, plus about (a topic matched by meaning)
    - `count` integer
    - `next` string, nullable
    - `results` Hit[]
      - `id` string, required: Galactica ID
      - `name` string, required
      - `slug` string
      - `url` string, required: Page URL
      - `type` 'company' | 'person', required
      - `kind` string
      - `quality` 'bronze' | 'silver' | 'gold' | 'verified': Overall: verified = claimed by the owner; gold = an e-mail and a phone, both verified or deliverable; silver = an e-mail and a phone; bronze = less. In quality.sections, the grade says how well that section is sourced.
      - `sub` string: One-line subtitle
      - `matched` 'name' | 'alias' | 'text' | 'meaning': What the words matched on; meaning = close in meaning (/find)
      - `city` string
      - `country` string: Country name
    - `related` Hit[]
      - `id` string, required: Galactica ID
      - `name` string, required
      - `slug` string
      - `url` string, required: Page URL
      - `type` 'company' | 'person', required
      - `kind` string
      - `quality` 'bronze' | 'silver' | 'gold' | 'verified': Overall: verified = claimed by the owner; gold = an e-mail and a phone, both verified or deliverable; silver = an e-mail and a phone; bronze = less. In quality.sections, the grade says how well that section is sourced.
      - `sub` string: One-line subtitle
      - `matched` 'name' | 'alias' | 'text' | 'meaning': What the words matched on; meaning = close in meaning (/find)
      - `city` string
      - `country` string: Country name
  - `meta` Meta
    - `api` string
    - `standard` string
    - `docs` string
    - `note` string

## Other responses

- `400`: Bad request
- `401`: api_key_required, invalid_key, key_revoked or account_required: send an account key
- `429`: Rate limited; see the retry-after header

---

[API](https://skmtc.dev/datagalactica/apis/data-galactica-api.md) · [All operations](https://skmtc.dev/datagalactica/apis/data-galactica-api/llms.txt) · [OpenAPI document](https://skmtc.dev/datagalactica/apis/data-galactica-api/revisions/0d024b0a280b?raw)