Skip to main content

Map API

POST /v1/map — Discover all URLs on a site instantly without scraping content.

Request Body

FieldTypeRequiredDescription
urlstringyesAbsolute URL to start from
maxDepthintnoMaximum link depth (0-100). Default: 2
useSitemapboolnoSeed with sitemap.xml and robots.txt sitemaps. Default: true
timeoutintnoOperation timeout in ms (1-600000). Default: 30000

Example Request

{
"url": "https://www.mabud.dev/",
"maxDepth": 2,
"useSitemap": true,
"timeout": 30000
}

Response

{
"success": true,
"data": {
"links": [
"https://www.mabud.dev/blog",
"https://www.mabud.dev/projects",
"https://www.mabud.dev/resume"
]
}
}

Error Responses

StatusCodeCause
400invalid_requestMissing url, non-http(s) scheme, params out of range
500internal_errorServer error