---
title: "Map a site"
method: POST
path: "/web/map"
tags: ["Web"]
---

# Map a site

`POST /web/map`

## Request

- Base URL: `https://api.crevio.co/v1`
- URL: `https://api.crevio.co/v1/web/map`
- Auth: API key in header `Authorization`

Discovers URLs on a site without fetching content. Fast. Synchronous. Charges credits on success.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `url` string, required: Site entry point.
  - `limit` integer: Maximum URLs to return (default 50).

## Response `200`

OK

- object
  - `url` string
  - `total_urls` integer
  - `urls` string[]
  - `categorized_urls` object
  - `timestamp` string

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `402`: Insufficient credits
- `422`: Validation error
- `429`: Rate limit exceeded — 600 requests per minute per credential. Retry after the number of seconds in `Retry-After`.
- `500`: Internal server error

---

[API](https://skmtc.dev/crevio/apis/crevio-api-v1.md) · [All operations](https://skmtc.dev/crevio/apis/crevio-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/crevio/apis/crevio-api-v1/revisions/2219f18ad651?raw)