---
name: apipick
description: Use apipick's REST APIs or hosted MCP server to give an agent real-time web and news search, URL content extraction, cited answers, specialist search (academic, SEC filings, patents, clinical, markets, legal, cybersecurity), and data lookups (company facts, IP geolocation, WHOIS/RDAP, EU VAT, LEI, email validation, dependency vulnerabilities). Use when a task needs fresh information from the web or a structured lookup the model cannot answer from memory.
---

# apipick

apipick is a catalog of production-ready REST APIs built for AI agents. Every endpoint takes a small JSON input and returns flat, predictable JSON. Billing is in credits and **only successful (HTTP 200) calls are charged**, so retrying after an error costs nothing.

- Website: https://www.apipick.com
- Full catalog with every endpoint, parameter and price: https://www.apipick.com/llms.txt
- OpenAPI spec: https://www.apipick.com/openapi.json
- Pricing: https://www.apipick.com/pricing

## 1. Get an API key

1. Ask the user to sign in at https://www.apipick.com/dashboard/api-keys and create a key (format `pk_...`). New accounts get 100 free credits, no credit card required.
2. Have the user store it as the environment variable `APIPICK_API_KEY` (shell profile or the project's `.env`, which must be git-ignored).
3. Never print the key back, hardcode it in source files, or commit it.

## 2. Connect: MCP (preferred) or REST

### Option A: hosted MCP server

If the client supports MCP (Claude Code, Cursor, VS Code, Claude Desktop, Windsurf), install the hosted server so every apipick tool appears natively:

```bash
claude mcp add --transport http apipick https://www.apipick.com/mcp --header "Authorization: Bearer $APIPICK_API_KEY"
```

For other clients, add an HTTP (Streamable HTTP) server with URL `https://www.apipick.com/mcp` and header `Authorization: Bearer <key>`. Clients that only accept a URL can use `https://www.apipick.com/mcp?api_key=<key>`. Setup guides for each client: https://www.apipick.com/mcp

### Option B: REST

- Base URL: `https://www.apipick.com/api`
- Auth header: `x-api-key: $APIPICK_API_KEY`
- JSON in, JSON out. POST endpoints take `Content-Type: application/json`.
- Each search endpoint publishes ready-to-use tool definitions (OpenAI function and Anthropic tool formats) at `GET /api/<path>/tool-schema`, for example `GET /api/search/web/tool-schema`. Use them instead of writing schemas by hand.

```bash
curl -s https://www.apipick.com/api/search/web \
  -H "x-api-key: $APIPICK_API_KEY" -H "Content-Type: application/json" \
  -d '{"query": "latest EU AI Act guidance", "max_num_results": 5}'
```

## 3. Pick the right endpoint

| Need | Endpoint | Credits |
|---|---|---|
| Real-time web search | `POST /api/search/web` `{query, max_num_results?, country_code?, start_date?, end_date?}` | 15 |
| News search | `POST /api/search/news` | 15 |
| Read pages as clean text | `POST /api/extract` `{urls: [...]}` (max 25) | 2 per URL |
| A short cited answer to a question | `POST /api/answer` `{query}` (15–60 s) | 100 |
| Papers (arXiv, PubMed, bioRxiv…) | `POST /api/search/academic` | 5 |
| SEC filings and earnings calls | `POST /api/search/sec` | 120 |
| Patents | `POST /api/search/patents` | 80 |
| Clinical trials, FDA labels, ChEMBL | `POST /api/search/clinical` | 30 |
| CVEs, CISA KEV, MITRE ATT&CK | `POST /api/search/cybersecurity` | 10 |
| Sanctions, vehicle safety, short-seller reports | `POST /api/research` `{query, collection}` then poll `GET /api/research/tasks/{task_id}` | 100 per completed task |
| Company facts | `GET /api/company/facts` | 2 |
| IP geolocation | `GET /api/ip-geolocation?ip=8.8.8.8` | 1 |
| Domain / IP / ASN registration | `GET /api/whois?query=github.com` | 2 |
| EU VAT number | `GET /api/validate-vat?vat_number=IE6388047V` | 3 |
| Legal entity (LEI) | `GET /api/lei-lookup?name=Tesla, Inc` | 3 |
| Email deliverability | `POST /api/check-email` | 1 |
| Dependency vulnerabilities | `POST /api/scan-dependencies` `{packages: [{ecosystem, name, version}]}` | 5 |

More specialist search endpoints (markets, financials, economic data, prediction markets, UK legal, chemistry, genomics, health, politics, MiCA, AP News, Wiley finance) are listed with parameters and prices in https://www.apipick.com/llms.txt. Prices there are authoritative if they differ from this table.

## 4. Working rules

- Prefer the cheapest endpoint that answers the question: `search/web` plus `extract` for general research, `answer` when one grounded paragraph is enough, specialist search only when the general web will not have the data.
- Keep `max_num_results` small, and extract only the URLs you will actually read.
- Cite the URLs the API returns when you use its results in an answer.
- Errors are never charged: `400`/`422` mean fix the input; `401` means the key is missing or wrong; `402` means the account is out of credits (tell the user to top up at https://www.apipick.com/dashboard/credits); retry `500`/`502`/`504` once.
- Check the remaining balance in the `remaining_credits` field of responses before running large batches.
