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.
- Cookie forwardingPreserve cookies across hops.
- HTTPS validationCertificate checks for each hop.
- Bulk checkingSubmit arrays of URLs in one call.
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
curl -X GET "https://api.agenty.ai/v1/redirects?url=https://bit.ly/abc123" \
-H "Authorization: Bearer YOUR_API_KEY"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?url=https://bit.ly/abc123',
{ headers: { 'Authorization': 'Bearer YOUR_API_KEY' } },
);
const chain = await res.json();
chain.redirects.forEach((hop) => console.log(hop.status, hop.url));import requests
res = requests.get(
"https://api.agenty.ai/v1/redirects",
headers={"Authorization": "Bearer YOUR_API_KEY"},
params={"url": "https://bit.ly/abc123"},
)
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.
How many hops can it trace?
Up to 20 hops by default. If a chain exceeds this limit it is flagged as a potential loop. Configure the limit via the maxHops parameter.
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.