arrow_back All endpoints

Broken Link Checker

POST/api/v1/tools/broken-links10 credits per callbroken linksseoauditcrawl404

Downloads a page, pulls out every unique outbound link and checks each one, returning the status of all of them and flagging failures. This is the most expensive tool in the catalogue because it makes one request per link found.

receipt_long
Why 10 credits?

Fetches the page and then up to 30 more URLs, five at a time - about 31 outbound requests for a single call. Priced to reflect that fan-out. Lower maxLinks when you only need a spot check; the price is flat, so a smaller crawl is simply better value per link.

Any HTTP client works. Replace the key with one from your dashboard.

bash
curl -X POST https://toolkitbackend-j69m.onrender.com/api/v1/tools/broken-links \
  -H "Authorization: Bearer tb_live_<your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://example.com",
  "maxLinks": 10
}'

Input

FieldTypeRequiredDefaultDescription
urlstringrequired- Absolute URL of the page whose links should be checked.
maxLinksintegeroptional30 How many links to check, newest first. Defaults to 30, which is also the maximum.

Output

FieldTypeDescription
urlstringThe page that was crawled.
totalFoundintegerHow many unique links the page contains.
checkedintegerHow many of them were actually checked.
linksarrayEach checked link with its status code and whether it is broken.
elapsedMsintegerTotal crawl duration.

Try it

Sends a real POST /api/v1/tools/broken-links from your browser and charges 10 credits to your account.

Sign in to run this endpoint. New accounts start with free credits.