Quickstart
Make a key, then get your first company.
Make a test key
Sign up, make a workspace, and open API keys. Choose
Make a test key and copy it: it's shown once, when it's made. A test key starts with
hyd_test_, costs nothing, and reads the sandbox: eleven well-known companies.
export HYDRANT_API_KEY=hyd_test_...Get a company
curl "https://api.hydrantapi.com/v1/companies/enrich?domain=stripe.com" \
-H "Authorization: Bearer $HYDRANT_API_KEY"The answer is the company's record: each field with its value, a confidence from 0 to 1, and the sources that back it.
{
"domain": "stripe.com",
"hq_location": {
"value": { "city": "South San Francisco", "region": "US-CA", "country": "US" },
"confidence": 0.4886,
"sources": ["wikidata", "gleif", "website"]
},
"founded_year": { "value": 2010, "confidence": 0.57, "sources": ["wikidata"] }
}Add include=evidence to see what each source said, and where.
Switch to a live key
A live key (hyd_live_) reads and enriches any company. Make one on the same page. Your plan
includes credits: an enrichment costs 10 and reading a stored record 1,
and an enrichment that finds no company costs nothing.
curl "https://api.hydrantapi.com/v1/companies/enrich?domain=your-customer.com" \
-H "Authorization: Bearer $HYDRANT_API_KEY"A company we haven't seen in the last 30 days is enriched while you wait, usually in 20 to 30
seconds. If it takes longer than 30 seconds, the answer is a 202 with the enrichment to
follow: see one call.