Crawl link graph
GET /api/v1/crawl/{jobId}/links
The site's internal link-graph — every crawled page with its inlink/outlink counts, crawl depth (clicks from the start URL) and internal PageRank score. The site-wide view single-page tools can't give you.
Path & query
| Name | Type | Description |
|---|---|---|
jobId required | string | The crawl job id returned by Start a crawl (POST /api/v1/crawl). Path parameter. |
limit | number | Max pages to return, sorted by PageRank (highest first). Default 200, max 1000. |
Request
Response
200 · application/json
- {
- "jobId": "crw_7Hk29fQ",
- "startUrl": "https://example.com",
- "host": "example.com",
- "status": "done",
- "maxPages": 50,
- "createdAt": "2026-06-02T13:24:49.414Z",
- "finishedAt": "2026-06-02T13:24:52.055Z",
- "totalPages": 42,
- "maxDepth": 3,
- "count": 42,
- "items": [
- { "url": "https://example.com/", "statusCode": 200, "inlinks": 41, "outlinks": 38, "depth": 0, "pageRank": 100 },
- { "url": "https://example.com/blog", "statusCode": 200, "inlinks": 12, "outlinks": 25, "depth": 1, "pageRank": 47.2 }
- ]
- }
Response fields
| Field | Type | Description |
|---|---|---|
totalPages | number | Total number of pages in the crawl's link graph. |
maxDepth | number | Deepest crawl depth reached (max clicks from the start URL). |
items[].inlinks | number | Internal links pointing to the page. |
items[].outlinks | number | Internal links leaving the page. |
items[].depth | number | Clicks from the start page; 0 = start page, null = unreachable. |
items[].pageRank | number | Internal link-equity score (0–100), normalised so the top page = 100. |
See Errors for status codes.