# refetch.cloud

> Web fetching and search API for AI agents and automation.

Refetch retrieves publicly accessible web pages and returns them as clean Markdown, raw HTML, or structured data. It also provides web and news search. All requests are routed through distributed infrastructure so your IP is never exposed to target sites.

## Endpoints

- [GET /md/{url}](https://refetch.cloud/md): Fetch a webpage as clean Markdown
- [GET /html/{url}](https://refetch.cloud/html): Fetch a webpage as raw HTML
- [GET /ld+json/{url}](https://refetch.cloud/ld+json): Extract JSON-LD structured data
- [GET /s/web?q={query}](https://refetch.cloud/s/web): Search the web
- [GET /s/news?q={query}](https://refetch.cloud/s/news): Search news articles
- [GET /company/news?domain={domain}](https://refetch.cloud/company/news): Recent company news classified into buying signals (funding, M&A, leadership changes, breaches, layoffs), with an LLM-ready digest
- [POST /mcp](https://refetch.cloud/mcp): Model Context Protocol server (streamable HTTP)
- [GET /usage](https://refetch.cloud/usage): Check your credit balance and usage
- [GET /limits](https://refetch.cloud/limits): View rate limits and pricing

## Authentication

All fetch and search endpoints require a Bearer token:

```
Authorization: Bearer ftch_xxxxxxxx
```

Sign up at https://www.refetch.cloud to get a key. Every new account receives 500 free requests with no credit card required.

## Pricing

$2.50 per 1,000 credits. Each fetch or search request costs 1 credit. GET /company/news costs 50 credits: one call runs several searches, fetches and reads up to 30 article pages, and classifies plus summarizes the results with per-claim source citations, replacing 30-plus individual fetch and search calls and the model tokens you would spend reading every page. GET /limits lists the current per-endpoint prices.

## Documentation

- [Full integration reference](https://refetch.cloud/llms-full.txt): Complete API reference with error codes, retry strategies, rate limits, response shapes, and code examples
- [API documentation](https://www.refetch.cloud/docs)
- [Pricing](https://www.refetch.cloud/pricing): Detailed pricing information