{"uid":"cap_p6K-qxvve8RxoF-cH4c2L","slug":"crustdata-withzero-xyz-crustdata-company-enrich-49e3f6a8","name":"Crustdata Company Enrich","description":"Core workflow route: hydrate up to 25 selected accounts per call with company headcount, industry, taxonomy, people, and other detailed firmographics after identify or search. For large lists, chunk identifiers into groups of 25 so each group uses one payment instead of one payment per company. Defaults to basic_info only to prevent unexpectedly large headcount-history and people payloads; request other documented sections explicitly. Default pricing is $0.10 per Crustdata credit with a $0.01 minimum successful-call settlement. Upstream Crustdata errors settle $0. DB company enrich costs two Crustdata credits per identifier, plus two credits for each returned technographics section.","url":"https://crustdata.withzero.xyz/api/v1/company/enrich?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","example":{"fields":["basic_info"],"domains":["browserbase.com"],"exact_match":true},"required":["fields"],"properties":{"names":{"type":"array","items":{"type":"string","minLength":1},"example":["OpenAI"],"maxItems":25,"minItems":1,"description":"Company names to identify or enrich."},"fields":{"type":"array","items":{"enum":["basic_info","headcount","funding","locations","taxonomy","revenue","hiring","followers","seo","competitors","social_profiles","web_traffic","employee_reviews","people","news","software_reviews","public_launches","market_intel","technographics","reviews"],"type":"string"},"default":["basic_info"],"example":["basic_info"],"description":"Documented company enrich sections to include. Defaults to basic_info only to keep payloads lean; request headcount, taxonomy, people, or other sections explicitly."},"domains":{"type":"array","items":{"type":"string","minLength":1},"example":["openai.com"],"maxItems":25,"minItems":1,"description":"Website domains to identify or enrich."},"exact_match":{"type":"boolean","example":true,"description":"Restrict matching to exact domain/name behavior when supported by Crustdata. Recommended for domain-sensitive account lookups."},"crustdata_company_ids":{"type":"array","items":{"type":"integer","maximum":9007199254740991,"exclusiveMinimum":0},"example":[12345],"maxItems":25,"minItems":1,"description":"Crustdata company IDs."},"professional_network_profile_urls":{"type":"array","items":{"type":"string","minLength":1},"example":["https://www.linkedin.com/company/openai"],"maxItems":25,"minItems":1,"description":"Company professional-network profile URLs."}},"additionalProperties":false},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["data","people"],"properties":{"data":{"description":"Raw JSON response returned by Crustdata."},"people":{"type":"array","items":{"type":"object","required":["inputIndex","matchIndex","people"],"properties":{"people":{"description":"Raw Crustdata company_data.people object, commonly including decision_makers, founders, and cxos."},"matchType":{"type":"string","description":"Provider-reported match type, when returned by Crustdata."},"matchedOn":{"type":"string","description":"Provider-reported match key, when returned by Crustdata."},"inputIndex":{"type":"integer","maximum":9007199254740991,"minimum":0,"description":"Index of the requested company identifier in the raw Crustdata response."},"matchIndex":{"type":"integer","maximum":9007199254740991,"minimum":0,"description":"Index of the matched company within the raw Crustdata matches array."},"companyName":{"type":"string","description":"Matched company name from basic_info, when present."},"companyDomain":{"type":"string","description":"Matched company primary domain from basic_info, when present."}},"additionalProperties":false},"description":"Convenience extraction of nested company_data.people blocks from each Crustdata match so callers can find decision_makers/founders/cxos without traversing the raw payload."},"billing":{"type":"object","required":["apiCredits","minimumCallUsdcMicro","pricePerCreditUsdcMicro","settledUsdcMicro"],"properties":{"apiCredits":{"type":"number","example":0.06,"description":"Estimated Crustdata API credits charged for this request."},"settledUsdcMicro":{"type":"string","example":"10000","description":"USDC micro-units settled for this request."},"minimumCallUsdcMicro":{"type":"string","example":"10000","description":"Configured minimum successful-call settlement in USDC micro-units."},"pricePerCreditUsdcMicro":{"type":"string","example":"100000","description":"Configured USDC micro-units charged per Crustdata API credit."}},"additionalProperties":false}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.250000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":3,"rating":{"score":"0.83","successRate":"0.91","reviews":3,"stars":"4.3","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":{"amountUsd":"0.00","asset":"USDC"},"pricing":{"kind":"session","summary":"$0.2/call","primary":{"kind":"session","protocol":"mpp","network":"tempo","amountUsd":"0.2","per":"call","confidence":"exact","depositUsd":"0.00"},"accepted":[{"kind":"session","protocol":"mpp","network":"tempo","amountUsd":"0.2","per":"call","confidence":"exact","depositUsd":"0.00"},{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_v_76d_lblvUV7qJKRXfe4","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"session","costAmount":"0.2","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":10,"planRef":null},{"uid":"pm_1Mq5GaoMqOq3QNkt3gJ2V","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.2","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"crustdata.withzero.xyz","brandSlug":"crustdata-withzero-xyz-mpp","brandBaseUrl":"https://crustdata.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Hydrates company accounts with detailed Crustdata company profiles given domains, names, LinkedIn URLs, or Crustdata IDs","exampleAgentPrompt":"Can you pull detailed Crustdata company profiles for openai.com and anthropic.com — I need company name, HQ country, and latest employee count?","exampleUseCases":[{"title":"Enrich prospect list with firmographics","prompt":"I have a list of 20 company domains from our latest outbound campaign — can you pull headcount, HQ country, and industry for all of them so our sales team has the full picture before reaching out?"},{"title":"Fill missing fields after account search","prompt":"We just ran a company search and got back a bunch of Crustdata IDs — can you hydrate those accounts with employee metrics, location, and taxonomy so we can prioritize which ones to target first?"},{"title":"Look up company details by LinkedIn URL","prompt":"I've got LinkedIn URLs for a handful of companies we're evaluating as potential partners — can you fetch their Crustdata profiles so I can see their latest headcount and where they're headquartered?"}],"resultDescription":"Returns the raw Crustdata JSON company profile(s) for each matched identifier, including any requested fields (e.g. company_name, hq_country, employee_metrics.latest_count), plus a billing object showing Crustdata credits consumed and USDC micro-units settled.","failureModes":["Upstream Crustdata error returns $0 settlement and error details in data field","No match found for provided domain or name returns empty data array","Invalid field path in fields array causes partial or failed enrichment","Exceeding 25 identifiers per request returns validation error","Malformed domain or LinkedIn URL may return no match"],"whenToPreferThis":"Use this endpoint after identifying or searching for target accounts (via company search or identify routes) when you need to hydrate those accounts with full firmographic detail from Crustdata. Prefer this over repeated identify calls when you already have domains, LinkedIn URLs, or Crustdata IDs and need structured profile fields like employee metrics, HQ country, or other Crustdata-native data points.","instructions":"## Workflow\nEnriches ONE company. Siblings:\n- resolve an ambiguous name/URL first: POST /api/v1/company/identify → pass returned IDs as crustdata_company_ids\n- more decision-makers at this account: POST /api/v1/person/search/role-cluster (company_domain = this domain)\n- find a SET of accounts instead: POST /api/v1/company/search","reviewSummary":"Enriches up to 25 accounts per call with firmographics including headcount, industry, taxonomy, and people data. Accurate schema matching and billing settlement are consistently confirmed at 2 credits per identifier, with clean people-block exposure of executives and founders. One case of blocked enrichment occurred due to spend-cap enforcement when pricing scaled across a full 25-company batch, returning no data.","reviewSummaryHighlights":["Accurate firmographic and people data including executives, decision-makers, and founders","Billing settles at documented 2 credits per identifier with confirmed schema compliance","Fast enrichment turnaround with verified identifier matching"],"reviewSummaryConcerns":["Spend caps can block full 25-company batch requests, returning no enrichment data"],"reviewSummaryGeneratedAt":"2026-08-24T22:15:05.417Z","activationCount":15,"lastUsedAt":"2026-08-18T16:51:17.255Z","lastSuccessfullyRanAt":"2026-07-23T23:32:26.406Z","lastHealthCheckAt":"2026-10-12T06:30:29.904Z","isFirstParty":true,"canonicalSlug":"crustdata-withzero-xyz-crustdata-company-enrich-49e3f6a8"}