Skip to content
GET /api/v1/trace-redirects

Redirect Tracer

Follow a URL's redirect chain and report each hop with status code

Parameters

name in type required description
url query string required Url

Request

Send your key in the X-API-Key header. More languages and patterns live on the code examples page.

curl -s "https://apixies.io/api/v1/trace-redirects?url=https%3A%2F%2Fgithub.com" \
  -H "X-API-Key: YOUR_API_KEY"

Response

The result sits under data in the standard envelope. See the response format guide for errors and status codes.

returns

data.final_url
Where the redirect chain ends up.
data.hops
Each hop with its URL, status code and next location.
data.total_hops
Number of requests in the chain, including the last one.
data.original_url
The URL you started from.
example response 200
{
    "status": "success",
    "http_code": 200,
    "code": "SUCCESS",
    "message": "Redirect trace completed",
    "data": {
        "original_url": "http://github.com",
        "final_url": "https://github.com/",
        "total_hops": 2,
        "hops": [
            {
                "hop": 1,
                "url": "http://github.com",
                "status_code": 301,
                "status_text": "Moved Permanently",
                "redirects_to": "https://github.com/"
            },
            {
                "hop": 2,
                "url": "https://github.com/",
                "status_code": 200,
                "status_text": "OK"
            }
        ],
        "traced_at": "2026-09-18T12:00:00+00:00"
    }
}

Authentication and limits

This endpoint needs an API key. Use the sandbox ("try it" above) to test it without registering. See the authentication guide for details.

Standard rate limits apply to this endpoint.

Common use cases

SEO redirect auditing

Verify that redirect chains are clean and efficient. Detect redirect loops, excessive hops, and mixed HTTP/HTTPS redirects that hurt SEO rankings.

Link shortener analysis

Trace shortened URLs to their final destination before clicking. Useful for security screening and understanding where links actually lead.

Website migration validation

After a site migration, batch-verify that all old URLs correctly redirect to their new locations with the right status codes (301 vs 302).

More documentation

Get a free API key

A temporary key takes one click and no signup. Register and you get 75 requests/day. Free tier is for development & small projects.

cookies

We use analytics cookies to see how the site gets used. Nothing loads until you accept. Privacy policy