Map API
Discover same-origin links on a public webpage with the AIHackr Map API. Learn page-level discovery limits and when to use a recursive crawl.
On this page
Discover links on one page
POST /v2/map reads links from the submitted public page, resolves relative URLs, removes fragments, deduplicates URLs and returns links matching the submitted origin. It does not recursively scan the entire site or promise a full sitemap.
curl --fail-with-body https://aihackr.com/v2/map \
-H "Authorization: Bearer $AIHACKR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com",
"limit": 20
}'Parameters
| Field | Type | Behavior |
|---|---|---|
| url | string, required | One public HTTP(S) URL. |
| limit | integer | Returned link limit, 1–100. Default: 20. |
Use the results
The response has success, a links array, the engine and a scope explanation. Each link has url and may have text. truncated: true means more matching links were discovered than the requested limit returned.
A page with few or no same-origin links can legitimately return an empty list. A rendered menu, a different final origin or a site built around non-link interactions can affect what is discoverable.
From map to crawl
Use Map to inspect a page’s navigation, then select the section that matters. For example, start from a documentation overview, inspect its links, then submit a specific guide section to Crawl. Avoid treating every discovered link as useful content: remove account pages, sorting variations and repetitive navigation in your application.
Usage
Map is one browser operation and reserves one trial page. Its link limit controls returned links, not the number of pages fetched. A 20-link map is not a 20-page crawl.