{"uid":"cap_GW6Zjj4uLbgmHrwhGcS_P","slug":"orthogonal-company-search-natural-language-structured-filters-84193209","name":"Orthogonal Company Search (Natural Language + Structured Filters)","description":"Search for companies using natural language queries or structured filters. AI assistant generates appropriate filters from your query.","url":"https://x402.orthogonal.com/tomba/v1/reveal/search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"page":{"type":"integer","description":"Page number for pagination (1-1000, default: 1)"},"query":{"type":"string","description":"Natural language query (8-100 chars). AI generates filters from this. Use only on first request, then use filters for pagination."},"filters":{"type":"object","description":"Structured filters: company, location_country, location_city, location_state, industry, size, type, keywords, founded, technologies, similar, revenue, sic, naics. Each has include/exclude arrays."}}},"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_XtVMY2SSJlL4WT0kxpgkQ","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 for companies using a natural language query or structured filters, with AI-generated filter translation from plain-English queries.","exampleAgentPrompt":"Find me fintech companies headquartered in New York with 50–200 employees that were founded after 2015 — I want to build a prospect list for outreach.","exampleUseCases":[{"title":"B2B sales prospecting by industry","prompt":"Find me SaaS companies in the healthcare industry based in California with fewer than 500 employees — I need a list to start prospecting for our enterprise software."},{"title":"Competitor discovery by technology stack","prompt":"Search for companies that use Salesforce and HubSpot, are in the marketing industry, and have revenue between $10M and $50M — I want to see who our main competitors are targeting."},{"title":"Startup discovery by founding year and location","prompt":"Find startups founded between 2018 and 2022 in Berlin, Germany that are in the fintech space — I'm doing market research on the European fintech scene."}],"resultDescription":"Returns a paginated list of company records matching the query or filters, including fields such as company name, industry, location, size, type, technologies used, revenue, and founding year.","failureModes":["Query shorter than 8 or longer than 100 characters returns a validation error","No matching companies returns an empty result set","Using a query string on pages beyond page 1 may produce inconsistent results — filters should be used for pagination","Invalid filter field names or values may return errors or unexpected results","Rate limiting or payment failure may result in a rejected request"],"whenToPreferThis":"Choose this endpoint when you need to discover or prospect companies using flexible criteria — either a natural language description or structured filters — especially for B2B lead generation, market research, or competitive intelligence. It is particularly well-suited when you want AI-assisted translation of plain-English queries into structured company filters. Prefer it over email-finding endpoints when the goal is company discovery rather than contact lookup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:52:07.707Z","isFirstParty":false}