{"uid":"cap_aqFyy-ePRlCpeME-spZvB","slug":"crustdata-withzero-xyz-crustdata-person-search-03138f11","name":"Crustdata Person Search","description":"Core workflow route: find a page of people and prospects from the cached Crustdata person 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. PersonDB search is priced at 0.03 Crustdata credits per returned profile.","url":"https://crustdata.withzero.xyz/api/v1/person/search","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","example":{"limit":10,"fields":["basic_profile.name","basic_profile.current_title","social_handles.professional_network_identifier.profile_url","experience.employment_details.current.name"],"filters":{"op":"and","conditions":[{"type":"=","field":"experience.employment_details.current.company_website_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":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.300000","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_OszNpuNqZChWm0UwX_I6y","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"session","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"result","depositMicros":300000,"planRef":"crustdata.person_search:4"},{"uid":"pm_THI3OToInTSVq-nNgHi6R","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 person dataset to find people and prospects using provider-native filters, fields, sorts, and aggregations","exampleAgentPrompt":"Search Crustdata for up to 25 people at US-headquartered companies, returning their company name, HQ country, and LinkedIn profile URL — filter by hq_country = USA and sort by employee count descending.","exampleUseCases":null,"resultDescription":"Returns a raw Crustdata JSON response containing matching person profiles with requested fields, plus a billing object showing API credits used, USDC micro-units settled, and the per-credit price and minimum settlement amounts. Includes a cursor for fetching subsequent pages.","failureModes":["Invalid filter syntax returns upstream Crustdata error with $0 settlement","Limit exceeds 1000 results in validation error","Invalid cursor string causes pagination failure","Unsupported field name causes provider-native error","Network timeout to Crustdata upstream returns error with $0 settlement","Empty result set returns data array with zero profiles and minimum settlement charge"],"whenToPreferThis":"Use this endpoint when you need to search across the full cached Crustdata person dataset with complex filter logic, multi-field selection, sorting, or aggregations. Prefer this over live professional-network search routes when freshness is not critical and cost efficiency matters. Use when building prospect lists, filtering by company attributes, or paginating through large result sets.","instructions":"## Workflow\nOne page of a cached query. Siblings:\n- discover valid filter-field values: POST /api/v1/person/search/autocomplete\n- next page: re-call with the returned cursor\n- roles at ONE employer (cheaper, one-param): POST /api/v1/person/search/role-cluster\n- hydrate a profile: POST /api/v1/person/enrich\n- need fresh/live data: POST /api/v1/person/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-14T12:37:27.704Z","isFirstParty":true}