Enrichments - SMB Sales Boost API

Enrich a list of website URLs you already have. Each URL is checked against our database first; anything we do not already have is fetched live.

What each URL costs

1 credit: A URL in our database that you have not bought before, including its buying signals and category enrichments.
0.1 credit: A URL we do not have and fetch live for you.
0 credits: A URL you have already exported, one we could not reach, or one without the contact details you asked for.

A URL found in our database is never fetched live, so lowering databaseMatchPercent cannot be used to buy database records at the live price.

Starting a run

POST /api/v1/enrichments with { "urls": [...] }, up to 100,000 URLs after deduplication by host. Send the full URL including any path - a deep link often carries better contact data than the root.

maxCredits: Most credits this run may spend. Omit to allow your whole available balance, which is the default.
databaseMatchPercent: 0-100, default 100. Caps what share of maxCredits may go to NEW database matches. Unused database budget flows to live fetching, never the reverse. Records you have already paid for are always returned free and are not affected by this.
contactTypes: phone, email or either. Default either, meaning a phone number OR an email - the widest setting, not the most restrictive.
emailResults: Email the finished file. Defaults to your account setting. The file is always downloadable, so there is no flag to disable the download.

Runs are asynchronous

Submitting returns a run id immediately and a large list can take hours. Poll GET /api/v1/enrichments/:id until status is completed or partial, then call GET /api/v1/enrichments/:id/download for a short-lived presigned URL.

Credits are charged in two stages - database matches when they are matched, live results when the file is published - so credits.final tells you whether the total is settled.

Every URL is accounted for

The file has one row per URL you submitted, each with a status column. Only the first two cost anything.

matched_paid: In our database, new to you. 1 credit.
scraped: Fetched live. 0.1 credit.
matched_free: In our database, you already bought it. Free.
scrape_failed: We could not reach it. Free.
skipped_db_budget: A database match outside your credit limit. Free.
skipped_scrape_budget: A live result outside your credit limit. Free.
matched_no_contact: Matched, but without the contact type you asked for. Free.
scraped_no_contact: Fetched, but without the contact type you asked for. Free.
skipped_invalid: Not a usable URL. Free.

API Documentation Sections

View Full API Documentation

Ready to Find Your Next Customers? Get access to growing local business leads updated every 5 minutes. See plans starting at $49/mo →