{"uid":"cap_vPIvEdraKPHJ1Nu6ske6d","slug":"icypeas-find-companies-38e4ee8e","name":"Icypeas Find Companies","description":"Search the lead database for companies matching filters. Returns paginated results. Filters: name, lid, urn, companyId, companyType, industry, location, headcount (range), headcountGrowth, revenue (range), keyword, website.","url":"https://x402.orthogonal.com/icypeas/api/find-companies","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"query":{"type":"object","description":"Query with include/exclude filters or range operators"},"pagination":{"type":"object","description":"Pagination with size and token"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XRMefNZPiuY900dcVbPjj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search the Icypeas lead database for companies matching filters such as name, industry, location, headcount, revenue, and keywords, returning paginated results.","exampleAgentPrompt":"Search the Icypeas company database for SaaS companies in the United States with 50 to 500 employees and revenue between $1M and $50M — give me the first page of results.","exampleUseCases":[{"title":"B2B lead list by industry and size","prompt":"Find me companies in the healthcare industry with between 100 and 1000 employees based in the UK — I need a list of leads to reach out to."},{"title":"Competitor landscape research","prompt":"Search the company database for firms in the fintech industry with fast headcount growth and revenue over $10M — I'm trying to map the competitive landscape."},{"title":"Targeted outreach by keyword and location","prompt":"Look up companies in the Icypeas database that match the keyword 'cybersecurity' and are located in Germany, with fewer than 200 employees — show me the first page."}],"resultDescription":"Returns a paginated list of company records matching the specified filters, including details such as company name, ID, URN, type, industry, location, headcount, revenue, and website. A pagination token is included to retrieve subsequent pages.","failureModes":["Invalid or unsupported filter fields return a validation error","Out-of-range or malformed headcount/revenue range values cause request failure","Invalid pagination token results in an error or empty response","Payment failure (insufficient USDC balance) blocks the request","No matching companies returns an empty result set","Overly broad queries may hit result limits requiring pagination"],"whenToPreferThis":"Choose this endpoint when you need to search or filter a structured lead database for companies based on firmographic criteria such as industry, location, headcount, revenue, or keywords. It is ideal for B2B prospecting, market research, and building targeted outreach lists. Prefer this over general web search when you need structured, filterable company data with pagination support.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:58:07.039Z","isFirstParty":false}