{"uid":"cap_Of8BELOPq1zOk7jVUojS3","slug":"fullenrich-company-search-183a3fbd","name":"FullEnrich Company Search","description":"FullEnrich Company Search — by name, industry, headcount, HQ. Requires names, industries, or headquarters_locations; limit/page alone → 400. Paginate via search_after (page ignored on cache). Legal names not brands (Anysphere≠Cursor). Software Development not SaaS; Research Services not AI. exact_match string-only — check domain for ElevenLabs, Runway.","url":"https://stable-enrich-git-shafu-stableenrich-compa-a1ba99-merit-systems.vercel.app/api/fullenrich/company-search","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["limit","page"],"properties":{"page":{"type":"integer","default":0,"maximum":9007199254740991,"minimum":0,"description":"Legacy page index — may be silently ignored on cached responses (page 2 can equal page 0). Use search_after instead."},"limit":{"type":"integer","default":3,"maximum":100,"minimum":1,"description":"Max companies to return. Default 3; raise when you need more (flat $0.05/query regardless of limit)."},"names":{"type":"array","items":{"type":"object","required":["value"],"properties":{"value":{"type":"string"},"exact_match":{"type":"boolean","description":"String match only — does not resolve brand intent. For ambiguous names (ElevenLabs, Runway), verify domain/headcount in results; rank #1 may be wrong entity."}},"additionalProperties":false},"description":"Search by legal entity name, not product/brand name (e.g. Anysphere, not Cursor). Provide at least one of names, industries, or headquarters_locations — limit/page alone returns 400."},"headcounts":{"type":"array","items":{"type":"object","properties":{"max":{"type":"number"},"min":{"type":"number"}},"additionalProperties":false},"description":"Employee count range filter [{ min?, max? }]."},"industries":{"type":"array","items":{"type":"object","required":["value"],"properties":{"value":{"type":"string","description":"FullEnrich company industry enum. Use Software Development for SaaS, Research Services for AI labs — not free-text labels. See docs.fullenrich.com/api/v2/general/enums#company-industry."},"exact_match":{"type":"boolean"}},"additionalProperties":false},"description":"Exact FullEnrich industry enum strings. Examples: Software Development (not SaaS), Research Services (not Artificial Intelligence). Free-text or shorthand returns 400."},"search_after":{"type":"string","description":"Cursor from metadata.search_after — only reliable company-search pagination method."},"excludeFields":{"type":"array","items":{"type":"string"}},"headquarters_locations":{"type":"array","items":{"type":"object","required":["value"],"properties":{"value":{"type":"string"},"exact_match":{"type":"boolean","description":"String match only — does not resolve brand intent. For ambiguous names (ElevenLabs, Runway), verify domain/headcount in results; rank #1 may be wrong entity."}},"additionalProperties":false},"description":"Filter by HQ location (e.g. United States, San Francisco). Provide at least one of names, industries, or headquarters_locations — limit/page alone returns 400."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Yz46OyCfnOxofpPRSBjoC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search for companies by name, industry, headcount, or headquarters location to retrieve enriched firmographic data","exampleAgentPrompt":"Search FullEnrich for software development companies headquartered in San Francisco with between 50 and 500 employees — give me the first 10 results with their legal names and domains.","exampleUseCases":[{"title":"Lead list for B2B sales outreach","prompt":"Find me 20 software development companies headquartered in Austin, Texas with 100 to 500 employees — I need their legal names and domains for a sales prospecting list."},{"title":"Identify legal name behind a brand","prompt":"I know the AI coding tool 'Cursor' but need to find its legal company name and domain — can you search FullEnrich for the company behind it?"},{"title":"Market research by industry and region","prompt":"Pull me a list of Research Services companies headquartered in the United Kingdom — I want to page through all results starting from the beginning for a market sizing exercise."}],"resultDescription":"Returns a list of company records matching the search criteria, each containing the legal company name, industry classification, employee headcount range, headquarters location, and company domain. Also includes a search_after cursor for paginating through large result sets.","failureModes":["400 error if only limit/page is provided without names, industries, or headquarters_locations","Incorrect results if brand names (e.g. Cursor) are used instead of legal names (e.g. Anysphere)","Wrong industry classification if SaaS is used instead of Software Development, or AI is used instead of Research Services","Empty results if exact_match is used on a domain mismatch (e.g. searching ElevenLabs by brand instead of domain)","Pagination may not work with page parameter on cached results — must use search_after cursor"],"whenToPreferThis":"Use this endpoint when you need to search or discover companies by firmographic attributes such as industry, headcount, or HQ location, especially when building lead lists, doing market research, or resolving brand names to legal entity names. Prefer this over contact enrichment endpoints when the goal is company-level discovery rather than individual person data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:37:39.100Z","isFirstParty":false}