API reference

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.

bash
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

FieldTypeBehavior
urlstring, requiredOne public HTTP(S) URL.
limitintegerReturned 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.

START WITH ONE PUBLIC PAGE

Make the web useful to your application.

20 trial pages per verified account. No credit card required.

Try the playground →