Skip to main content
New to Corsair? See API access, authentication, and error handling.

Answers

get

answers.get Search the web and return a written answer with its sources ($0.006; deep $0.055). Risk: read
Input POST /v1/search with outputType sourcedAnswer. Source text is not stored. Output

Credits

get

credits.get Get the account’s remaining credit balance in dollars. Risk: read
Input: empty object GET /v1/credits/balance. Stores the balance. Output

Pages

fetch

pages.fetch Fetch one web page or PDF as markdown, optionally with typed data from a schema ($0.001 to $0.011). Risk: read
Input POST /v1/fetch. Returns markdown and does not store the page. Output

Research

create

research.create Start a multi-step research task ($0.25 to $2.50 by reasoningDepth). Poll research.get for the result. Risk: destructive
Input POST /v1/research. Returns the task; poll research.get. Output

get

research.get Get a research task: status, and the answer or structured data once completed. Risk: read
Input GET /v1/research/{id}. Output

list

research.list List research tasks, newest or oldest first, paged. Risk: read
Input GET /v1/research, paged. Output

Responses

create

responses.create Generate an answer grounded in live web results (OpenAI Responses format). Paid generation. Risk: destructive
Input POST /v1/responses (OpenAI Responses format). Stores id, model, and object. Output

run

search.run Search the web and return results with their text content ($0.005 a call; deep $0.05). Filter by date and domain. Risk: read
Input POST /v1/search with outputType searchResults. Stores name, url, type, and date of each result. Output

structured

search.structured Search the web and return JSON shaped by your JSON Schema, optionally with sources ($0.006; deep $0.055). Risk: read
Input POST /v1/search with outputType structured. The schema is sent as a JSON string. Output

Tasks

create

tasks.create Queue up to 100 search, fetch or research calls to run in the background, each billed like the direct call. Poll tasks.get. Risk: destructive
Input POST /v1/tasks with an array of up to 100 search, fetch or research inputs.
Output

get

tasks.get Get one background task with its status and output. Risk: read
Input GET /v1/tasks/{id}. Output

list

tasks.list List background tasks, filtered by type and status, paged, with the in-flight quota. Risk: read
Input GET /v1/tasks, filtered by type and status, paged. Output