Recommendations API

BuiltWith Recommendations API

Technologies we recommend websites to install based on similar profile websites.

Introduction

Get XML and JSON results of recommendations for technologies for websites. Learn more about our Future Customer recommendation system.

The general access method is as follows -
https://api.builtwith.com/rec1/api.[xml|json]?KEY=[YOUR KEY]&LOOKUP=[DOMAINS,]

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.