Skip to main content

What is Parse?

Parse lets you create structured APIs from any website. Give it a URL and describe the data you need — Parse builds a working API with typed endpoints, parameters, and response schemas. What you can do:
  • Create APIs — Submit a URL via POST /dispatch and Parse generates a full API with endpoints, input parameters, and structured responses
  • Browse your APIs — List all your APIs with GET /dispatch/tasks and get full specs via GET /dispatch/tasks/{id}
  • Execute endpoints — Call any generated endpoint directly via POST /scraper/{scraper_id}/{endpoint_name}
  • Revise and extend — Request changes to existing APIs with POST /dispatch/tasks/{id}/revise
  • Export specs — Get OpenAPI 3.1 or MCP tool definitions for any completed API
  • Connect AI agents — Point any MCP-compatible agent at POST /mcp and it gets all your APIs as tools automatically

How it works

1. POST /dispatch with a URL + optional task description

2. Parse checks for an existing matching API
   → If found: returns it instantly (matched=true)
   → If not: queues a build job (matched=false)

3. Poll GET /dispatch/tasks/{task_id} until status="completed"

4. Use the generated_api spec to call endpoints
   POST /scraper/{scraper_id}/{endpoint_name}

Authentication

All API requests require an X-API-Key header. See the Authentication guide to get your key.

Base URL

All API requests should be made to:
https://api.parse.bot

For AI agents

Parse exposes a hosted MCP server at POST /mcp. Any MCP-compatible client (Claude Code, Cursor, etc.) can connect with your API key and immediately get all your APIs as callable tools — no configuration needed. You can also point your agent at https://parse.bot/llms.txt for a machine-readable overview of the API.

Next steps