# Cercetare (/ro/docs/api/gateway/research)

Cercetare aprofundată asincronă: un raport cu citări, din mai multe căutări și citiri de pagini.

`POST /v1/research` pornește un job care planifică mai multe căutări, citește cele mai bune pagini și scrie un raport în care fiecare afirmație își citează sursa ca `[S1]`..`[Sn]` (sau, cu `output_schema`, un `answer` JSON). Cererea așteaptă cel mult `wait_s` secunde (implicit 0) și răspunde 200 cu jobul terminat sau 202 cât timp este `queued` / `running`; interoghezi `GET /v1/research/{id}` până când `status` devine `done` sau `failed`. Același `Idempotency-Key` trimis din nou întoarce jobul existent. Admiterea este aceeași ca la [tool-uri](./tools.mdx) — regulile tale îl văd ca `web_search`. Preț: 0,20 $ per job plus tokenii lui de model; joburile din alocarea gratuită lunară sau dintr-o tură de agent codai nu plătesc taxa de job.

SDK-urile se ocupă de interogare: `codai.research.run({ question })` (TypeScript) și `codai.research.run("…")` (Python) pornesc jobul și îl așteaptă. Același motor este tool-ul `deep_research` din VS Code, desktop, telefon, headless și MCP-ul găzduit. Detalii: [ghidul de tool-uri](../../agents/tools.mdx#cercetare-aprofundată--v1research).

<OpenAPIPage document="./openapi/ro/gateway.yaml" operations={[{path: '/v1/research',method: 'post'},{path: '/v1/research/{id}',method: 'get'}]} />