---
title: "POST /brokenlink"
method: POST
path: "/brokenlink"
tags: ["brokenlink"]
---

# POST /brokenlink

`POST /brokenlink`

Check if a webpage contains broken links

## Request body

- BrokenLinkDto
  - `url` string, required — Target URL
  - `proxyCountry` string — Proxy country code to route the request
  - `followRedirect` boolean — Whether to follow redirects when checking site status

## Response `200`

Successfully checked for broken links

- BrokenLinkResponseDto
  - `timestamp` number, required — Timestamp of the request in milliseconds
  - `apiStatus` 'success' | 'failure', required — API status message
  - `apiCode` number, required — API status code
  - `message` string, required — Human-readable message about the broken link scan result
  - `meta` BrokenLinkMetaDto, required
    - `url` string, required — The target URL checked for broken links
    - `proxyCountry` string, required — Proxy country used for this request
    - `followRedirect` boolean, required — Whether redirection was followed
    - `redirectedURL` string, required — Final URL after redirection (if any)
    - `test` TestMetaDto, required
      - `id` string, required — Unique test identifier
  - `data` string[], required — List of links found on the page and their HTTP status

## Other responses

- `400` — Bad request (invalid parameters)
- `500` — Internal server error

---

[API](https://skmtc.net/geekflare/apis/geekflare-api.md) · [All operations](https://skmtc.net/geekflare/apis/geekflare-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/geekflare/geekflare-api/versions/936993afc936/schema)