# Chuger API

## Documentation

- [Introduction](https://docs.chuger.com/introduction.md): Chuger is a single HTTP API for scraping, content extraction, SERP, and LLM prompts — one token, one credit balance, predictable JSON.
- [Authentication](https://docs.chuger.com/authentication.md): Create an API token in the Chuger dashboard and authenticate every request with a Bearer header.
- [Rate limits & quotas](https://docs.chuger.com/rate-limits.md): Per-minute rate limits and monthly credit quotas by plan, response headers, and how to handle 429s.
- [Credits](https://docs.chuger.com/credits.md): How Chuger bills usage in credits — per-endpoint cost, monthly allowance, top-ups, and the credit-management endpoints.
- [Errors](https://docs.chuger.com/errors.md): HTTP status codes, JSON error shapes, response headers, and when it's safe to retry.
- [Concurrency & best practices](https://docs.chuger.com/concurrency.md): Throughput sizing, retry strategies, idempotency, webhook reliability, and tips for keeping cost predictable.
- [MCP server](https://docs.chuger.com/mcp.md): Connect Claude, Cursor, or any MCP-capable AI client to Chuger's web extraction tools.
- [Agent skill](https://docs.chuger.com/skills.md): Install the Chuger skill so AI agents know how to extract web content as markdown, search, and map sites efficiently.

## API Reference

- [GET /v1/scrape](https://docs.chuger.com/endpoints/scrape.md): Fetch the raw HTML of a public web page. Returns the target site's status code and the full HTML body.
- [GET /v1/content](https://docs.chuger.com/endpoints/content.md): Extract clean HTML, Markdown, and structured metadata from any public URL. Ideal for AI pipelines, content monitoring, and indexing.
- [POST /v1/content/bulk](https://docs.chuger.com/endpoints/content-bulk.md): Extract content from many URLs (or a sitemap) in one request. Results are delivered asynchronously by email or webhook.
- [GET /v1/map](https://docs.chuger.com/endpoints/map.md): Discover the URLs under a domain. Returns a deduplicated list of URLs found in the site's sitemaps.
- [GET /v1/serp](https://docs.chuger.com/endpoints/serp.md): Run a search query and get the organic results, related questions, and related searches.
- [GET /v1/serp/content](https://docs.chuger.com/endpoints/serp-content.md): Run a search and extract the content of the top results in one call. Returns SERP results with content blocks attached.
- [POST /v1/prompt](https://docs.chuger.com/endpoints/prompt.md): Run an LLM prompt and get back text. Optionally pass a URL to ground the prompt on a live web page.
- [Get credit balance](https://docs.chuger.com/endpoints/credits-balance.md): Inspect your current credit balance, monthly limit, used amount, and low-balance status.
- [List credit transactions](https://docs.chuger.com/endpoints/credits-transactions.md): Paginated list of credit-consuming actions on your account, newest first.
- [Preview cost](https://docs.chuger.com/endpoints/credits-preview-cost.md): Preview how many credits a service call (or batch of calls) would cost, without deducting anything.
- [Check affordability](https://docs.chuger.com/endpoints/credits-can-afford.md): Confirm whether your current balance covers an upcoming request.
- [Usage stats](https://docs.chuger.com/endpoints/credits-usage-stats.md): Compact summary of your current period's credit usage — same shape as the status object on /v1/credits.
- [Purchase credits](https://docs.chuger.com/endpoints/credits-purchase.md): Create a Stripe Checkout session for a one-time credit top-up. Top-ups persist beyond the monthly reset.
- [GET /user](https://docs.chuger.com/endpoints/user.md): Return the authenticated user's account record. Useful as a token health-check.

## Changelog

- [Release notes](https://docs.chuger.com/changelog.md): What's new in the Chuger API — features, behavior changes, and improvements, newest first.