Skip to main content
GET
Find a domain from a name

Overview

Every other endpoint takes a URL. /resolve is how you get one when all you have is a name: Stripe โ†’ stripe.com, Delta โ†’ delta.com, The Coca-Cola Company โ†’ coca-cola.com. Results are ranked, one per domain, and each carries a confidence from 0 to 1. Only the first result can reach 0.8 โ€” when it does, that is the answer; anything lower is a candidate to check. Case, accents, punctuation and legal suffixes donโ€™t matter: โ€œThe Coca-Cola Companyโ€, โ€œcoca-colaโ€ and โ€œCoca Colaโ€ are the same query. Answers come from two places:
  • The name index โ€” about 550,000 brands, companies, websites, software products and publications, in milliseconds. Reviewed brand data always ranks first.
  • A live lookup โ€” only with live=true, and only when the index has no answer at 0.8 or above. Candidate domains are proposed and each is checked against its own homepage: the site has to call itself by the name you asked for. Parked and for-sale domains never pass. It takes a few seconds, and the verified answer is added to the index, so the next lookup of that name is instant.

Example requests

Example response

Reading the response

Nothing matched is still a 200 with an empty results list.

Credits

Typeahead

/resolve also completes partial names โ€” stri returns Stripe first โ€” which makes it usable behind a search box. Completions are always below 0.8: they are suggestions, not answers. Leave live off for typeahead, and debounce keystrokes: each request counts against your rate limit.

GET /enrich

Everything about the company behind the domain you just found. 12 credits.

GET /brand

Colors, fonts and logos for it. 10 credits.

Authorizations

X-API-Key
string
header
required

Your Prefetch API key. Obtain one from the dashboard.

Query Parameters

name
string
required

The company, brand or product name (1โ€“100 characters). Case, accents, punctuation and legal suffixes are ignored: "The Coca-Cola Company" and "coca cola" are the same query.

Required string length: 1 - 100
limit
integer
default:5

Maximum number of results.

Required range: 1 <= x <= 10
live
boolean
default:false

When no answer reaches 0.8, look the name up live: candidate domains are verified against their own homepages. Takes a few seconds; billed 3 credits when the live lookup runs.

Response

Matches, best first. Empty when nothing matched.

success
enum<boolean>
required
Available options:
true
data
object
required
meta
object
required