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
POST /v1/search with outputType sourcedAnswer. Source text is not stored.
Output
sources full type
sources full type
Credits
get
credits.get
Get the account’s remaining credit balance in dollars.
Risk: read
GET /v1/credits/balance. Stores the balance.
Output
credit full type
credit full type
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
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
POST /v1/research. Returns the task; poll research.get.
Output
task full type
task full type
get
research.get
Get a research task: status, and the answer or structured data once completed.
Risk: read
GET /v1/research/{id}.
Output
task full type
task full type
list
research.list
List research tasks, newest or oldest first, paged.
Risk: read
GET /v1/research, paged.
Output
tasks full type
tasks full type
meta full type
meta full type
quota full type
quota full type
Responses
create
responses.create
Generate an answer grounded in live web results (OpenAI Responses format). Paid generation.
Risk: destructive
POST /v1/responses (OpenAI Responses format). Stores id, model, and object.
Output
response full type
response full type
Search
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
POST /v1/search with outputType searchResults. Stores name, url, type, and date of each result.
Output
results full type
results full type
structured
search.structured
Search the web and return JSON shaped by your JSON Schema, optionally with sources ($0.006; deep $0.055).
Risk: read
POST /v1/search with outputType structured. The schema is sent as a JSON string.
Output
sources full type
sources full type
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
POST /v1/tasks with an array of up to 100 search, fetch or research inputs.
tasks full type
tasks full type
tasks full type
tasks full type
meta full type
meta full type
quota full type
quota full type
get
tasks.get
Get one background task with its status and output.
Risk: read
GET /v1/tasks/{id}.
Output
task full type
task full type
list
tasks.list
List background tasks, filtered by type and status, paged, with the in-flight quota.
Risk: read
GET /v1/tasks, filtered by type and status, paged.
Output
tasks full type
tasks full type
meta full type
meta full type
quota full type
quota full type