> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pandoragraph.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Busca

> Texto vira id. Ambiguidade vira opção, nunca escolha nossa.

<ParamField query="termo" type="string" required>
  Nome da empresa. Mínimo de 3 caracteres.
</ParamField>

```bash theme={"dark"}
curl "https://brain.pandoragraph.com/api/v1/busca?termo=construtora exemplo" \
  -H "Authorization: Bearer pk_sua_chave"
```

```json theme={"dark"}
{
  "dado": {
    "id": "00000000",
    "nome": "CONSTRUTORA EXEMPLO LTDA",
    "tipo": "empresa",
    "assumido": false,
    "outrosCandidatos": []
  }
}
```

<ResponseField name="id" type="string">
  O id canônico. Reenvie em qualquer outro endpoint.
</ResponseField>

<ResponseField name="assumido" type="boolean">
  `true` quando o casamento foi aproximado — é palpite, não acerto. Confirme
  pelo CNPJ antes de usar, e veja `outrosCandidatos`.
</ResponseField>

## Ambiguidade é 409, não escolha

```json theme={"dark"}
{
  "erro": "ambiguo",
  "mensagem": "\"construtora silva\" casa com mais de uma empresa",
  "opcoes": [
    { "id": "11111111", "nome": "CONSTRUTORA SILVA LTDA" },
    { "id": "22222222", "nome": "CONSTRUTORA SILVA LTDA" }
  ]
}
```

Cada opção já traz o `id` que você reenvia — o erro devolve a saída pronta.

<Warning>
  Nós **não** escolhemos a primeira. Responder fatos corretos sobre a empresa
  errada é pior do que não responder, e num produto de risco é o defeito mais caro
  que existe.
</Warning>

## 404 aqui é sobre o nome, não sobre a base

<Note>
  `nao_encontrado` significa "não localizei **por nome**". Não conclua ausência a
  partir disso: tente o CNPJ antes. A mensagem de erro diz isso explicitamente.
</Note>