# Map a website's pages: POST /v1/web/map

A site's pages from its sitemaps, optionally only those matching a search.

- Base URL: https://api.magistermarketing.com
- Auth: `Authorization: Bearer $MAGISTER_API_KEY` (a full key)
- Cost: about 1 per map
- Answers at once.

## Parameters

| Name | In | Type | Required | Notes |
| --- | --- | --- | --- | --- |
| url | body | string | yes | The site's address, such as https://example.com.; at most 2000 characters |
| search | body | string | no | Keep only the pages whose address contains this word.; at most 200 characters |
| limit | body | integer | no | 1 to 500; default 100 |

## Request

```bash
curl -X POST https://api.magistermarketing.com/v1/web/map \
  -H "Authorization: Bearer $MAGISTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://tally.so","limit":20}'
```

## Response (a real call, 2026-11-12, trimmed)

```json
{
  "data": {
    "url": "https://tally.so",
    "domain": "tally.so",
    "search": null,
    "pages": [
      {
        "url": "https://tally.so",
        "title": null,
        "description": null
      },
      {
        "url": "https://tally.so/create",
        "title": null,
        "description": null
      },
      {
        "url": "https://tally.so/pricing",
        "title": null,
        "description": null
      },
      {
        "url": "https://tally.so/templates",
        "title": null,
        "description": null
      },
      {
        "url": "https://tally.so/signup",
        "title": null,
        "description": null
      }
    ],
    "count": 20
  },
  "credits_charged": 0.95,
  "request_id": "f915bae2-247b-40f5-9d5e-942810e370d0"
}
```

The whole API reference, for an agent: https://magistermarketing.com/docs/api.md