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 Recommendation Example
XML Get Single Domain
https://api.builtwith.com/rec1/api.xml?KEY=[YOUR KEY]&LOOKUP=hotelscombined.com
JSON Get Single Domain
https://api.builtwith.com/rec1/api.json?KEY=[YOUR KEY]&LOOKUP=builtwith.com
JSON Get Multiple Domain
https://api.builtwith.com/rec1/api.json?KEY=[YOUR KEY]&LOOKUP=builtwith.com,wayfair.com,hotelscombined.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 |
wayfair.com
builtwith.com
The root domain you'd like to do a lookup for. This can be CSV of up to 16 root domains max.
|
Yes |
Responses
The Recommendations API will respond with a document in the format -
rec[Recommendations->tech]
tech
tech is the sub-option in the Recommendations array.
Name |
Example |
Description |
name |
Hotjar |
The name of the technology |
link |
https://hotjar.com |
The link to the recommended technology |
tag |
cms |
The top level technology category |
categories[string] |
Ticketing System |
String array of sub-categories for the technology |
stars |
3 |
Value between 0 and 4 - where 4 is a more relevant technology |
match |
0.0234332 |
Value generally less than 0.5 allows sorting of results beyond star rating - the higher the more relevant recommendation |
rec
rec is the top level object.
Name |
Example |
Description |
Domain |
tjoos.com |
The domain name of the match |
Compiled |
2023-07-23T13:52:29.335Z |
The date the recommendation was compiled |
Code Examples
JSON/XML have integrations in all modern programming languages. Here's some StackOverflow topics for various languages - Python, C#, Java, PHP, C++, TSQL and Ruby.
Error Codes
Note error messages in this format cannot be guaranteed, your implementation should also consider non-200 response codes as errors. The Lookup property will be null (json) or not provided (xml) if the error is server related. View all potential well-formed error codes.
Terms of Use
Our standard terms cover the use all of our APIs.
In general, you can use the API to enhance your product in many ways. The only limitation is you cannot resell the data as-is or provide duplicate functionality to builtwith.com and its associated services.