Web Search Services API Reference
Curated REST API endpoints for all 4 core services. For full documentation, visit each service's official docs.
Authentication Summary
| Service | Auth Header | Key Format | Docs |
|---|---|---|---|
| Firecrawl | Authorization: Bearer KEY |
fc-xxx |
https://docs.firecrawl.dev |
| Exa | x-api-key: KEY (also accepts Authorization: Bearer KEY) |
UUID string | https://exa.ai/docs |
| Perplexity | Authorization: Bearer KEY |
String | https://docs.perplexity.ai |
| Jina | Authorization: Bearer KEY |
jina_xxx |
https://jina.ai/reader |
Service Endpoints
Firecrawl — https://api.firecrawl.dev
| Method | Path | Description |
|---|---|---|
| POST | /v2/scrape |
Scrape single URL |
| POST | /v2/search |
Web search with content |
| POST | /v2/crawl |
Start site crawl |
| GET | /v2/crawl/{id} |
Check crawl status |
| POST | /v2/crawl/params-preview |
Preview crawler options from a natural-language prompt |
| POST | /v2/map |
Map site URLs |
| POST | /v2/extract |
LLM structured extraction |
| POST | /v2/batch/scrape |
Batch scrape multiple URLs |
| POST | /v2/agent |
Autonomous research agent |
| POST | /v2/browser |
Create browser session |
| POST | /v2/parse |
Parse files (PDF, DOCX, …) into LLM-ready output |
| POST / GET | /v2/monitor |
Create / list page-change monitors (CRUD + run + checks) |
| GET | /v2/developer/search |
Search the developer index (GitHub issues, PRs, READMEs, docs) |
| POST | /v2/research/papers/search |
Search academic papers |
See references/firecrawl-api.md for curl examples.
Exa — https://api.exa.ai
| Method | Path | Description |
|---|---|---|
| POST | /search |
Semantic web search (single powerful endpoint) |
| POST | /contents |
Get text/highlights/summary for URLs or result ids |
| POST | /findSimilar |
Find pages similar to a URL |
| POST | /answer |
Direct answer with citations |
| POST | /agent/runs |
Start an Exa Agent run (multi-step research) |
| GET | /agent/runs/{id} |
Poll an agent run |
Exa also offers Websets and Monitors APIs — see https://exa.ai/docs for details.
See references/exa-api.md for curl examples.
Perplexity — https://api.perplexity.ai
| Method | Path | Description |
|---|---|---|
| POST | /v1/agent |
Agent API (third-party models + web search) |
| POST | /search |
Web search (no /v1 prefix) |
| POST | /v1/sonar |
Chat completion with web grounding |
| POST | /v1/embeddings |
Text embeddings (pplx-embed-v1-0.6b/4b; contextualized variants via the contextualized embeddings endpoint) |
| POST | /router/v1/chat/completions |
Gateway API (OpenAI-compatible) |
See references/perplexity-api.md for curl examples.
Jina — Multiple base URLs
| Method | URL Pattern | Description |
|---|---|---|
| GET | https://r.jina.ai/{URL} |
Read any URL as markdown |
| GET | https://s.jina.ai/?q={QUERY} |
Web search |
| POST | https://api.jina.ai/v1/embeddings |
Text embeddings |
| POST | https://api.jina.ai/v1/rerank |
Rerank documents |
| POST | https://api.jina.ai/v1/classify |
Text classification |
See references/jina-api.md for curl examples.