Introduction
API endpoint that allows you to get access to live and historical redirects for a website.
The general access method is as follows -
https://api.builtwith.com/redirect1/api.[xml|json]?KEY=[YOUR KEY]&LOOKUP=[DOMAIN NAME]
Authentication
You must provide your API key in each lookup. See the examples for how this works.
Login or Create a Free Account to get your API key.
Get Domain Example
XML Get Single Domain
https://api.builtwith.com/redirect1/api.xml?KEY=[YOUR KEY]&LOOKUP=hotelscombined.com
JSON Get Single Domain
https://api.builtwith.com/redirect1/api.json?KEY=[YOUR KEY]&LOOKUP=builtwith.com
Reference
Parameters
The following GET parameters can be supplied for lookups
| Name |
Examples |
Required |
| KEY |
00000000-0000-0000-0000-000000000000
Sign up for Free or Login to get a key.
|
Yes |
| LOOKUP |
cnn.com
ycombinator.com
Only root domains work with the Redirect API (not internal pages or subdomains)
|
Yes |
Responses
Redirect is the top level response that identifies the lookup.
| Name |
Example |
Description |
| Lookup |
hotelscombined.com |
The domain that was looked up. |
| Inbound |
See below |
The list of sites that direct towards the Lookup. |
| Outbound |
See below |
The list of sites that Lookup has redirected to. |
Direction
This is the domains that are either Inbound or Outbound to the Lookup with their timings
| Name |
Example |
Description |
| Domain |
The domain of th redirect |
A domain that either redirects from or to the Lookup (depending on if it's in the Inbound or Outbound group). |
| FirstDetected |
2018-02-01 |
The date we first detected the redirect |
| LastDetected |
2024-04-25 |
The date we last detected the redirect |