URL Redirect Checker API
Trace the full redirect chain for any URL — every hop, status code, response time, and final destination.
The Agenty Redirects API traces the complete redirect chain for any URL. It records every hop, HTTP status code, response time, and the final destination, and flags redirect loops or long chains that hurt SEO and user experience.
Features
- Full chain traceUp to 20 hops, configurable per request.
- Status per hopHTTP status code returned at each step.
- Latency per hopResponse time for performance analysis.
- Loop detectionFlag circular redirects automatically.
- Custom User-AgentSimulate Googlebot, mobile, or your own client.
- Final destinationFinal URL and status code for every link.
- CSV exportEvery hop of every URL in one CSV file.
- Bulk checkingPaste a list of URLs and check them in one run.
Use cases
- SEO audits to find chains that dilute link equity
- Verify post-migration 301 redirects after a site move
- Validate affiliate and partner short-links at scale
- Detect cloaking and unexpected redirect targets
- Measure redirect latency for performance budgets
API examples
View full API referencecurl -X POST https://api.agenty.ai/v1/redirects \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "http://github.com"}'curl -X POST https://api.agenty.ai/v1/redirects \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://bit.ly/abc123",
"userAgent": "Mozilla/5.0 (compatible; Googlebot/2.1)"
}'const res = await fetch('https://api.agenty.ai/v1/redirects', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ url: 'http://github.com' }),
});
const chain = await res.json(); // { finalUrl, status, hops, loop, redirects }
chain.redirects.forEach((hop) => console.log(hop.status, hop.url, hop.time));import requests
res = requests.post(
"https://api.agenty.ai/v1/redirects",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"url": "http://github.com"},
)
for hop in res.json()["redirects"]:
print(hop["status"], hop["url"])How Agenty compares
| Feature | Agenty | Redirect-Checker | WhereGoes | HTTPStatus |
|---|---|---|---|---|
| Full chain tracing | Yes (up to 20 hops) | Yes | Yes | Limited |
| Response time per hop | Yes | No | No | No |
| Custom User-Agent | Yes | No | No | No |
| Loop detection | Yes | No | No | No |
| Free tier | Yes | Yes | Yes | Yes |
Frequently asked questions
What is the URL Redirect Checker API?
The Agenty Redirects API traces the complete redirect path for any URL. It records every hop, HTTP status code, response time, and final destination, helping you detect loops and long chains. See the API reference for the full response.
How many hops can it trace?
Up to 20 hops. Each hop includes its status code, response time, and the location it redirects to. To check many URLs, paste them into the tool above and download every hop as CSV. To find the URLs to check, use the link extractor.
Can I check redirects as a specific user agent?
Yes. Pass a userAgent string to simulate mobile browsers, crawlers like Googlebot, or custom clients — some sites serve different redirects based on the user agent.
Does it detect redirect loops?
Yes. We detect circular redirects and flag them in the response. A loop is reported when a URL redirects back to one already seen in the chain.
Is there a free tier?
Yes. All accounts include free credits. See our pricing page for details.