# 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 [Introduction](/docs/api/introduction) | [Programmatic Purchase](/docs/api/programmatic-purchase) | [Authentication](/docs/api/authentication) | [Rate Limits](/docs/api/rate-limits) | [User Profile](/docs/api/user-profile) | **Enrichments** | [Leads](/docs/api/leads) | [Filter Presets](/docs/api/filter-presets) | [Keyword Lists](/docs/api/keyword-lists) | [Email Schedules](/docs/api/email-schedules) | [Export Formats](/docs/api/export-formats) | [Export History](/docs/api/export-history) | [Account Settings](/docs/api/account-settings) | [AI Features](/docs/api/ai-features) | [Export Blacklist](/docs/api/export-blacklist) | [Error Handling](/docs/api/error-handling) | [Credits & Subscription](/docs/api/credits-subscription) | [MCP Server](/docs/api/mcp-server) | [Integrations](/docs/api/integrations) [View Full API Documentation](/docs/api) --- **Ready to Find Your Next Customers?** Get access to growing local business leads updated every 5 minutes. [See plans starting at $49/mo →](/?utm%5Fsource=content&utm%5Fmedium=cta)