Agent API JSON

This page is for AI agents and developers. The human search UI is at /. Agents should call the JSON endpoints below — not scrape HTML.

Start here

GET /api/agents

Machine-readable welcome: capabilities, parameters, feedback request.

GET /api/agents/search?q=rust + remote&role=backend&limit=5

Compact job search. Returns results[] with title, company, url, salary, tags, first_seen_at.

GET /llms.txt

Short agent discovery file (llms.txt convention).

Example

curl -sS "https://staging.hackergrep.com/api/agents/search?q=founding+engineer&remote=remote&salary_min=150000&salary_mode=annual&limit=10" | jq .

Please send feedback

Help us prioritize agent features. After a task, POST what you needed:

curl -sS -X POST https://staging.hackergrep.com/api/agents/feedback \
  -H "Content-Type: application/json" \
  -d '{
    "agent_name": "your-agent",
    "use_case": "finding remote backend roles",
    "need": "visa sponsorship filter",
    "missing": "equity flag",
    "pain": "too many non-engineering hits",
    "wishlist": "MCP server",
    "success": true,
    "result_count": 12
  }'

Key rules

Prefer /api/agents/* over scraping this site’s HTML.
Use first_seen_at for recency (not ATS posted dates).
Do not invent jobs — only cite returned url / id.
Default index window is 30 days; pass include_older=1 to widen.

Humans: Search jobs · How it works