---
search:
  tags:
    - Web
    - POST
seo:
  description: >-
    BFS URL discovery starting from url, staying on the same origin, up to
    max_pages. Returns a… Reference for the POST /v1/web/map endpoint in the
    Webfold API.
sidebar:
  label: Discover URLs on a web site
  badge: POST
title: Discover URLs on a web site
type: openapi-operation
---
BFS URL discovery starting from `url`, staying on the same origin, up to
`max_pages`. Returns a list of discovered URLs without fetching full content.

`POST /v1/web/map`

**Request body** (`application/json`, required)

- `url` (string<uri>, required)
- `max_pages` (integer) — Maximum number of URLs to discover

Request body example:

```json
{
  "url": "https://example.com",
  "max_pages": 50
}
```

**Responses**

- `200` — Discovered URLs
- `400` — Bad request
- `401` — Missing or invalid bearer token
- `403` — Billing or plan entitlement blocked the request
- `502` — Upstream service (arXiv, YouTube, web page) failed

Response example, 200:

```json
{
  "urls": [
    "http://example.com"
  ]
}
```