API Documentation

Programmatic access to RedirectCheck Pro's redirect analysis engine

Getting Started

The RedirectCheck Pro API allows you to programmatically analyze URL redirects, trace redirect chains, and detect common issues.

Base URL: https://redirectcheck.io

Rate Limiting

The API enforces rate limits to ensure fair usage:

  • 30 requests per minute per IP address
  • 3,000 requests per day across all endpoints
  • Rate limit information is included in response headers
  • Exceeding a limit returns a 429 Too Many Requests response with retry details

X-RateLimit-Limit: 30
X-RateLimit-Remaining: 24
X-RateLimit-Reset: 1731436800

💡 Need more API endpoints? For comprehensive web analysis APIs, explore SitemapForge to generate xml sitemaps in seconds for any site.

Endpoint: Analyze URL

HTTP METHOD

GET

ENDPOINT

/api/analyze

Query Parameters

urlrequired

The URL to analyze (must be a valid HTTP/HTTPS URL)

userAgentoptional

Custom user agent string (default: RedirectCheck Pro/1.0)

maxHopsoptional

Maximum redirect chain length (default: 10, range: 1-20)

timeoutoptional

Request timeout in milliseconds (default: 10000, range: 1000-30000)

Example Request 

curl "https://redirectcheck.io/api/analyze?url=https://example.com"

Try It Now

Example Response 

{
  "success": true,
  "url": "https://example.com",
  "chain": [
    {
      "url": "https://example.com",
      "status": 301,
      "statusText": "Moved Permanently",
      "responseTime": 234,
      "headers": {
        "location": "https://www.example.com/",
        "cache-control": "max-age=3600"
      }
    },
    {
      "url": "https://www.example.com/",
      "status": 200,
      "statusText": "OK",
      "responseTime": 156,
      "headers": {
        "content-type": "text/html; charset=UTF-8"
      }
    }
  ],
  "summary": {
    "totalHops": 2,
    "finalUrl": "https://www.example.com/",
    "finalStatus": 200,
    "totalTime": 390,
    "hasLoop": false,
    "issues": []
  },
  "rateLimit": {
    "limit": 30,
    "remaining": 24,
    "reset": 1731436800
  }
}

Response Fields

success

Boolean indicating if analysis was successful

url

The original URL that was analyzed

chain

Array of redirect hops with status, headers, and timing information

summary

Summary statistics including total hops, final URL, and detected issues

rateLimit

Current rate limit status for your IP address

Error Responses

400 Bad Request

Missing or invalid parameters (url, maxHops, timeout)

429 Too Many Requests

Rate limit exceeded (30 requests per minute or 3,000 per day)

500 Internal Server Error

Analysis failed due to network error or timeout

Use Cases

  • Automated redirect monitoring and testing
  • Site migration validation
  • SEO auditing tools integration
  • CI/CD pipeline redirect checks
  • Bulk URL redirect validation

Need more tools? Check out loadtime.dev