{"uid":"cap_H8K9fCwWVkGGg0dadNC1G","slug":"crustdata-withzero-xyz-crustdata-company-search-cb35ea69","name":"Crustdata Company Search","description":"Core workflow route: build a target account page from the cached Crustdata company dataset using provider-native filters, fields, sorts, cursor, aggregations, and limit. Default pricing is $0.10 per Crustdata credit with a $0.01 minimum successful-call settlement. Upstream Crustdata errors settle $0. CompanyDB search is priced at 0.03 Crustdata credits per returned company.","url":"https://crustdata.withzero.xyz/api/v1/company/search","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","example":{"limit":10,"fields":["basic_info.name","basic_info.primary_domain","headcount.total"],"filters":{"op":"and","conditions":[{"type":"=","field":"basic_info.primary_domain","value":"browserbase.com"}]}},"properties":{"limit":{"type":"integer","example":10,"maximum":100,"minimum":1,"description":"Maximum records to return. Max 100."},"sorts":{"type":"array","items":{"type":"object","required":["field","order"],"properties":{"field":{"type":"string","example":"headcount.total","minLength":1,"description":"Provider-native field path. The live 2025-11-01 API expects field even though some Crustdata examples use column."},"order":{"enum":["asc","desc"],"type":"string","example":"desc","description":"Sort direction."}},"additionalProperties":{}},"example":[{"field":"headcount.total","order":"desc"}],"description":"Crustdata sort descriptors using the live API field/order contract."},"cursor":{"type":"string","example":"eyJwYWdlIjoyfQ","minLength":1,"description":"Cursor returned by the previous page."},"fields":{"type":"array","items":{"type":"string","minLength":1},"example":["basic_info.name","basic_info.primary_domain","headcount.total"],"description":"Response field sections or dot-paths to include."},"filters":{"example":{"op":"and","conditions":[{"type":"=","field":"basic_info.primary_domain","value":"browserbase.com"}]},"description":"Crustdata provider-native filter condition or condition group."},"preview":{"type":"boolean","example":false,"description":"Return preview metadata when supported by the endpoint."},"aggregations":{"example":{"field":"taxonomy.professional_network_industry"},"description":"Provider-native aggregation request for endpoints that support it."}},"additionalProperties":{}},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["data"],"properties":{"data":{"description":"Raw JSON response returned by Crustdata."},"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":{"request":{"limit":10,"fields":["basic_info.name","basic_info.primary_domain","headcount.total"],"filters":{"op":"and","conditions":[{"type":"=","field":"basic_info.primary_domain","value":"example.com"}]}},"response":{"data":{"companies":[{"headcount":{"total":94},"basic_info":{"name":"coming up","primary_domain":"example.com"}},{"headcount":{"total":23},"basic_info":{"name":"UAPe All Around Super Cool Company Page","primary_domain":"example.com"}},{"headcount":{"total":null},"basic_info":{"name":"Galene Advisory Sàrl","primary_domain":"Example.com"}},{"headcount":{"total":625},"basic_info":{"name":"Shipyard","primary_domain":"example.com"}},{"headcount":{"total":2},"basic_info":{"name":"Talent Rover Middleware Test Company","primary_domain":"example.com"}},{"headcount":{"total":8},"basic_info":{"name":"AVAHI LAB","primary_domain":"example.com"}},{"headcount":{"total":11},"basic_info":{"name":"LifeFlow","primary_domain":"example.com"}},{"headcount":{"total":452},"basic_info":{"name":"PGE Systemy S.A","primary_domain":"example.com"}},{"headcount":{"total":921},"basic_info":{"name":"Mobilink","primary_domain":"example.com"}},{"headcount":{"total":2},"basic_info":{"name":"Fyutura","primary_domain":"example.com"}}],"next_cursor":"H4sIAOOKK2oC_xXMMQ7CMAxA0atUmRnsJHZrroJQ5biOOiAi2nRAiLtT1v-k_wmvw7f3vOq-husQqFiSlMCFmawuLEgqxXAsYMQRSwXVaSKz6mPMkhfBCg7G7FE9XIawt62frxsmFsh4P1NvXR-zteP5l5z5-wN_t2jyeQAAAA==","total_count":446},"billing":{"apiCredits":0.3,"settledUsdcMicro":"30000","minimumCallUsdcMicro":"10000","pricePerCreditUsdcMicro":"100000"}}},"exampleRequest":{"limit":10,"fields":["basic_info.name","basic_info.primary_domain","headcount.total"],"filters":{"op":"and","conditions":[{"type":"=","field":"basic_info.primary_domain","value":"example.com"}]}},"tags":[],"displayCostAmount":"0.3","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":{"amountUsd":"0.30","asset":"USDC"},"pricing":{"kind":"session","summary":"$0.003/result","primary":{"kind":"session","protocol":"mpp","network":"tempo","amountUsd":"0.003","per":"result","confidence":"exact","depositUsd":"0.30"},"accepted":[{"kind":"session","protocol":"mpp","network":"tempo","amountUsd":"0.003","per":"result","confidence":"exact","depositUsd":"0.30"},{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.3","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_S7F0N6YfOxLzWDRJTeNR7","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"session","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"result","depositMicros":300000,"planRef":"crustdata.company_search:4"},{"uid":"pm_YWBtXvyktmV6wGsFua0RX","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.3","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":"Search and filter the cached Crustdata company dataset to build target account lists using native filters, fields, sorts, cursor pagination, aggregations, and limit.","exampleAgentPrompt":"Search Crustdata for up to 50 US-headquartered companies, returning their company name, HQ country, and LinkedIn profile URL, filtered where hq_country equals USA and sorted by employee count descending.","exampleUseCases":[{"title":"Build SaaS prospect list for outbound","prompt":"Find me 100 SaaS companies in the US with between 50 and 500 employees, sorted by headcount descending. Return their name, LinkedIn URL, and employee count so I can target them for our sales campaign."},{"title":"Filter tech companies by location and size","prompt":"Search Crustdata for companies in the enterprise software space headquartered in Europe with over 1000 employees. Give me the top 75 results with company name, HQ country, and total headcount, sorted by employees descending."},{"title":"Segment accounts for ICP matching","prompt":"I need to build a target list of 200 fintech companies across North America and Europe with 20 to 200 employees. Return their name, industry, HQ country, and LinkedIn profile so I can filter this into my sales workflow."}],"resultDescription":"Returns a raw Crustdata JSON response containing matching company records with the requested fields, plus billing metadata including API credits consumed, USDC micro-units settled, price per credit, and minimum call settlement amount.","failureModes":["Invalid filter syntax returns upstream Crustdata error with $0 settlement","Cursor token expired or malformed causes pagination failure","Requesting fields that don't exist in the schema returns empty or partial results","Limit exceeding 1000 is rejected with a validation error","Network or upstream Crustdata outage returns error with $0 settlement","Malformed JSON body returns 400-level error"],"whenToPreferThis":"Use this endpoint when you need to build or filter target account lists from Crustdata's cached company dataset using firmographic filters like country, industry, or employee count. Prefer this over the live LinkedIn search route when freshness is not critical and cost efficiency matters, since cached data is cheaper. Use this before the company enrichment route to identify accounts, then enrich selected ones.","instructions":"## Workflow\nOne page of a cached query. Siblings:\n- discover valid filter-field values: POST /api/v1/company/search/autocomplete\n- next page: re-call with the returned cursor\n- hydrate a hit's full profile: POST /api/v1/company/enrich\n- need fresh/live data: POST /api/v1/company/professional-network/search/live\n\n## Contract\n- The live sibling above takes a flat [{field,type,value}] array, NOT this cap's {op, conditions} group shape — rebuild filters when switching.","reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:43:32.975Z","isFirstParty":true}