Agency API

Redirect QA from your automation workflow.

The API is built for scripts, QA tools, migration workflows, and dashboards that need redirect intelligence without using the browser UI. Sitemap audits and CSV exports stay available when SEO work needs a background job or client-ready spreadsheet.

View plans Log in

Authentication

Use a Bearer token.

Agency and Enterprise accounts can generate a token from the dashboard. Treat it like a password.

Authorization: Bearer YOUR_API_TOKEN

X-Api-Token: YOUR_API_TOKEN is also accepted for same-origin tools and password-protected staging. Legacy ?token=YOUR_API_TOKEN still works, but headers are preferred because they avoid exposing credentials in URLs and logs.

OpenAPI

Machine-readable spec.

Use the static OpenAPI file to wire a client, document the API internally, or import into API tooling.

View openapi.json

Rate limits

Limits count URL units.

One single check costs 1 unit. A bulk API request with 20 URLs costs 20 units. The monthly allowance is shared with sitemap and CSV jobs.

60 units / minute
1,000 units / hour
10,000 units / day
100,000 units / month

Responses include rate-limit headers and paid API JSON includes an api_usage object when the limiter is active.

Single URL

Check one redirect chain.

Returns the redirect chain, final destination, hop count, loop detection, timing, and status data.

GET /api.php?action=check&url=https%3A%2F%2Fexample.com

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
"https://redirects.pro/api.php?action=check&url=https%3A%2F%2Fexample.com"

{
  "success": true,
  "input_url": "https://example.com",
  "final_url": "https://www.example.com/",
  "hop_count": 1,
  "loop_detected": false,
  "chain": [],
  "api_usage": {
    "units": 1,
    "remaining": 59,
    "window": "minute"
  }
}

Bulk API

Check up to 100 URLs synchronously.

The bulk API is for small automation batches. Larger list work should use background jobs such as sitemap audit, CSV upload, and export.

POST /api.php?action=bulk

curl -X POST -H "Authorization: Bearer YOUR_API_TOKEN" \
-d "urls[]=https://example.com" \
-d "urls[]=https://redirects.pro" \
"https://redirects.pro/api.php?action=bulk"

{
  "success": true,
  "total": 2,
  "api_usage": {
    "units": 2,
    "remaining": 58,
    "window": "minute"
  },
  "results": [
    {
      "url": "https://example.com",
      "result": {}
    }
  ]
}

Errors

Stable failure shapes.

Every error returns JSON with success: false, a human-readable error, and when relevant a machine-readable type.

401

Missing, invalid, or expired API token.

403

Valid account, but the active plan does not include the requested API or bulk feature.

429

API usage window exceeded. The response includes retry_after, reset_at, limit, remaining, and window.

400 / 502

Invalid URL, unsupported scheme, target connection failure, or target redirect check failure.