Grep API v2 Reference — Grep AI
DevelopersAPI ReferenceAPI v2

Grep API v2

Run research jobs and read their results. Pin the effort tier or expert, fetch the rendered report and any files it produced, and check your credit balance before each call.

OpenAPI JSONMarkdown Reference
POST/api/v2/research

Start a Grep research job.

GET/api/v2/research

List research jobs.

GET/api/v2/research/{job_id_or_slug}

Fetch job status, report, and structured output.

GET/api/v2/research/{job_id_or_slug}/files

List generated research files.

GET/api/v2/research/{job_id_or_slug}/timeline

Fetch the research timeline.

GET/api/v2/quota

Read API quota and credit balance.