{"endpoint":{"id":"treg.companies.similar","provider":"treg","provider_display":"treg","name":"companies.similar — routed: best of 3 providers, own keys first","summary":"Find companies similar to a seed domain","method":"POST","path":"/companies.similar","scope":"","tier":"core","kind":"routed","domain":"companies","call_template":"treg call treg.companies.similar --method POST --data '{\"domain\":\"stripe.com\"}'","cost":{"type":"per_success","value":0.0089,"currency":"USD","per":1,"unit":"call","source":"inferred","confidence":"documented","checked":null,"varies":true,"note":"NOT free: misses are billed too. the children's range $0.0089–$0.049 per hit, 0% markup; you pay the child that served AND every child tried before it that bills a miss (3 of 3 do), up to X-Treg-Route-Max-Cost (default $1 a call). X-Treg-Route-Exclude them, or X-Treg-Route-Waterfall: 0, to pay for one provider only","usd":0.0089},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":{"status":200,"means":"output.companies == []"},"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":null,"docs_url":"","has_example":false,"input":{"bodyType":"json","body":{"domain":{"type":"str","required":false,"note":"identity key (part of domain)"}},"note":"Send everything you know about the subject — treg derives the rest (full_name ⇄ first+last), matches each provider on the variants it accepts ({domain}) and sends each provider only the fields it wants. On a miss treg keeps trying providers, cheapest first, within X-Treg-Route-Max-Cost (default $1 per call; misses on per-success providers are free). Options ride as headers, never in the body: X-Treg-Route-Waterfall: 0 (stop at the first miss), X-Treg-Route-Max-Cost: <usd>, X-Treg-Route-Prefer / X-Treg-Route-Exclude: <provider>. The response is {output, raw, _treg: {served_by, tried}}; X-Treg-Served-By names the child."},"test_request":{"body":{"domain":"stripe.com"}},"routed_children":["companyenrich.companies.similar","oceanio.companies.lookalike","tomba.companies.similar"],"capability":"companies.similar","capability_description":"Find companies similar to a seed company or domain","platform":"companies","platform_label":"Company data","observed":{"samples":433,"decided":413,"ok_rate":0.9588,"p50_ms":null,"p95_ms":null,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},"provider":{"service":"treg","display_name":"treg"},"siblings":[{"id":"companyenrich.companies.similar","provider":"companyenrich","provider_display":"CompanyEnrich","name":"Lookalike companies for a seed domain or id","summary":"Finds similar companies to the given company by id or domain — at most 100 companies are returned per request","method":"POST","path":"/companies/similar","scope":"any_account","tier":"core","kind":"data","domain":"companies","call_template":"treg call companyenrich.companies.similar --method POST --data '{\"domains\":[\"stripe.com\"],\"pageSize\":1,\"page\":1}'","cost":{"type":"per_result","value":5,"currency":"credit","per":1,"unit":"record","source":"docs","source_url":"https://companyenrich.com/pricing","checked":"2026-08-20","confidence":"verified","note":"5 credits PER COMPANY RETURNED, and 5 credits even when nothing matches. VERIFIED 2026-08-20: pageSize 1 moved the credit meter by exactly 5.","usd":0.049},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-08-20","added":"2026-08-20","docs_url":"https://docs.companyenrich.com/reference/post_companies-similar","has_example":true,"input":{"body":{"domains":{"type":"array[string]","required":false,"note":"1-10 seed domains; the result is similar to the SET, so several seeds sharpen the profile","example":["stripe.com"]},"domain":{"type":"string","required":false,"note":"DEPRECATED single-seed form — use `domains`"},"page":{"type":"integer","required":false,"note":"1-based page number","example":1},"pageSize":{"type":"integer","required":false,"note":"1-100. THIS IS THE PRICE — 5 credits per company returned","example":1},"similarityWeight":{"type":"number","required":false,"note":"-1 to 1, default 0; higher weights raw similarity over the structured filters"},"minScore":{"type":"number","required":false,"note":"0-1 floor on the similarity score"},"countries":{"type":"array[string]","required":false,"note":"narrow the lookalikes by geography — every companyenrich.companies.search filter is accepted here too"},"employees":{"type":"array[string]","required":false,"note":"narrow by size bucket"}},"note":"THE MOST EXPENSIVE ROW-PRICED ROUTE — 5 credits per company, so a default pageSize of 10 is 50 credits. Call companyenrich.companies.similar.count first (free) and set pageSize explicitly, every time."},"test_request":{"body":{"domains":["stripe.com"],"pageSize":1,"page":1}},"observed":{"samples":154,"decided":123,"ok_rate":1.0,"p50_ms":996,"p95_ms":2233,"last_ok_days":2,"hit_rate":1.0,"hit_samples":123}},{"id":"companyenrich.companies.similar.scroll","provider":"companyenrich","provider_display":"CompanyEnrich","name":"Scroll lookalike-company results past 10,000 rows","summary":"Finds similar companies with cursor-based pagination — allows paginating into more than 10.000 results","method":"POST","path":"/companies/similar/scroll","scope":"any_account","tier":"core","kind":"data","domain":"companies","call_template":"treg call companyenrich.companies.similar.scroll --method POST --data '{\"domains\":[\"stripe.com\"],\"pageSize\":1}'","cost":{"type":"per_result","value":5,"currency":"credit","per":1,"unit":"record","source":"docs","source_url":"https://companyenrich.com/pricing","checked":"2026-08-20","confidence":"verified","note":"5 credits per company returned, 5 on an empty page. VERIFIED live 2026-08-20.","usd":0.049},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-08-20","added":"2026-08-20","docs_url":"https://docs.companyenrich.com/reference/post_companies-similar-scroll","has_example":true,"input":{"body":{"domains":{"type":"array[string]","required":false,"note":"1-10 seed domains","example":["stripe.com"]},"pageSize":{"type":"integer","required":false,"note":"1-100. THIS IS THE PRICE — 5 credits per company returned","example":1},"cursor":{"type":"string","required":false,"note":"omit for the first page, then pass `next_cursor` from the previous response"}},"note":"same filters and same 5-credit-per-row price as companyenrich.companies.similar; only the pagination differs. At 5 credits a row, walking a lookalike list this way gets expensive fast — the async export job reserves credits up front and is the safer shape for large pulls."},"test_request":{"body":{"domains":["stripe.com"],"pageSize":1}},"observed":{"samples":1,"decided":1,"ok_rate":null,"p50_ms":null,"p95_ms":null,"last_ok_days":null,"hit_rate":null,"hit_samples":0}},{"id":"findymail.lookalike.search","provider":"findymail","provider_display":"Findymail","name":"Find lookalike companies from a seed domain","summary":"Build a list of companies that look like a seed company, optionally constrained to the same country or size","method":"POST","path":"/lookalike/search","scope":"any_account","tier":"core","kind":"data","domain":"companies","call_template":"treg call findymail.lookalike.search --method POST --data '{\"seed\":\"stripe.com\",\"limit\":10}'","cost":{"type":"per_result","value":1,"currency":"credit","per":10,"unit":"call","source":"docs","source_url":"https://app.findymail.com/docs/","checked":"2026-08-20","confidence":"documented","note":"1 finder credit per 10 results, rounded up — so the minimum useful call is 1 credit. The response echoes `credits_used`.","usd":0.00198},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":null,"added":"2026-08-20","docs_url":"https://app.findymail.com/docs/","has_example":false,"input":{"body":{"seed":{"type":"string","required":true,"note":"the seed company's domain","example":"stripe.com"},"same_country":{"type":"boolean","required":false,"note":"restrict results to the seed's country"},"same_size":{"type":"boolean","required":false,"note":"restrict results to the seed's headcount band"},"limit":{"type":"integer","required":false,"note":"max companies to return, up to 10000 — THIS IS THE PRICE DIAL","example":10},"exclusion_list_ids":{"type":"array[integer]","required":false,"note":"ids of saved exclusion lists whose domains should be dropped from the results"}},"note":"returns {companies: [{domain, name, linkedin_url, company_size, country}], total, credits_used} — `credits_used` reports the actual charge back to you"},"test_request":{"body":{"seed":"stripe.com","limit":10}},"observed":{"samples":9296,"decided":5182,"ok_rate":0.8198,"p50_ms":1282,"p95_ms":10879,"last_ok_days":0,"hit_rate":null,"hit_samples":0},"reviews":{"teams":0,"samples":[{"usefulness":"useful","reason":"Returned real US trucking compliance/title/permit service peers (Eclipse DOT, Sage DOT, CNS, JST permits, Automotive Titling, Transreg) that match On The Go profile","client":"mcp","month":"2026-09"}]}},{"id":"leadsforge.companies.lookalike.preview","provider":"leadsforge","provider_display":"LeadsForge","name":"Preview lookalike companies for seed domains (free)","summary":"Free, uncharged preview of companies similar to the provided domains.","method":"POST","path":"/lookalikes/preview","scope":"any_account","tier":"core","kind":"data","domain":"companies","call_template":"treg call leadsforge.companies.lookalike.preview --method POST --data '{\"domains\":[\"stripe.com\"],\"employeeRanges\":[\"201-500\"]}'","cost":{"type":"free","value":0,"currency":"USD","unit":"call","source":"docs","source_url":"https://www.leadsforge.ai/pricing","checked":"2026-08-20","confidence":"verified","note":"documented as free and confirmed live — balance unchanged at 89 across the call","usd":0.0},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-08-20","added":"2026-08-20","docs_url":"https://api.leadsforge.ai/public/swagger/doc.json","has_example":true,"input":{"body":{"domains":{"type":"array","required":true,"note":"seed company domains","example":["stripe.com"]},"employeeRanges":{"type":"array","required":false,"note":"values from leadsforge.companies.lookalike.filters.employee_ranges","example":["201-500"]},"categories":{"type":"array","required":false,"note":"industry categories"},"fundingStages":{"type":"array","required":false,"note":"funding stage filter"},"locations":{"type":"array","required":false,"note":"country ISO 3166-1 alpha-2 codes or region ids from leadsforge.companies.lookalike.filters.locations","example":[{"id":"US","type":"country"}]}},"note":"returns company metadata only — no people, no credits. Use it to shape the filter set before paying for the same query on the search route."},"test_request":{"body":{"domains":["stripe.com"],"employeeRanges":["201-500"]}},"observed":{"samples":43103,"decided":30321,"ok_rate":0.9815,"p50_ms":804,"p95_ms":10524,"last_ok_days":0,"hit_rate":null,"hit_samples":0},"reviews":{"teams":5,"samples":[{"usefulness":"partly","reason":"Free lookalikes for three small inference-API seeds returned the same famous top 25 (Hugging Face, Mistral, Together, Groq...) even with size filters; few long-tail companies.","client":"mcp","month":"2026-10"},{"usefulness":"useful","reason":"Free 25 lookalikes for siamaccountingsolutions.com were highly relevant - Bench, Pilot, Acuity, Bookkeeper360 etc, perfect seed pool for bookkeeping competitors","client":"mcp","month":"2026-10"},{"usefulness":"partly","reason":"Free, 25 lookalikes with descriptions; good for pharma/agro seeds, off-target for a retail-platform seed.","client":"claude-code","month":"2026-10"}],"share":{"useful":0.4,"partly":0.6,"not_useful":0.0}}},{"id":"leadsforge.companies.lookalike.search","provider":"leadsforge","provider_display":"LeadsForge","name":"Find lookalike companies for seed domains","summary":"Search for companies similar to the provided domains.","method":"POST","path":"/lookalikes/search","scope":"any_account","tier":"core","kind":"data","domain":"companies","call_template":"treg call leadsforge.companies.lookalike.search --method POST --data '{\"domains\":[\"stripe.com\"],\"page\":1,\"pageSize\":1}'","cost":{"type":"per_result","value":1,"currency":"credit","per":1,"unit":"row","source":"docs","source_url":"https://www.leadsforge.ai/pricing","checked":"2026-08-20","confidence":"documented","note":"1 credit per company returned (charged per company, not per lead). Confirmed live: pageSize=1 moved the balance 89 -> 88; GET /balance reports companyLookalikePrice=1","usd":0.0245},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-08-20","added":"2026-08-20","docs_url":"https://api.leadsforge.ai/public/swagger/doc.json","has_example":true,"input":{"headers":{"Idempotency-Key":{"type":"string","required":false,"note":"a retried request with the same key returns the original result without charging credits again","example":"treg-lookalike-2026-08-20-1"}},"body":{"domains":{"type":"array","required":true,"note":"seed company domains","example":["stripe.com"]},"employeeRanges":{"type":"array","required":false,"example":["201-500"]},"categories":{"type":"array","required":false},"fundingStages":{"type":"array","required":false},"locations":{"type":"array","required":false,"note":"ids from leadsforge.companies.lookalike.filters.locations"},"page":{"type":"integer","required":false,"note":"1-based, max 100","example":1},"pageSize":{"type":"integer","required":false,"note":"max 100 — THIS IS THE PRICE DIAL: 1 credit per company returned","example":1}},"note":"credits are reserved before the search and charged against actual results. Feed a returned domain into leadsforge.people.search companyDomains.include to turn a company into enrichable people."},"test_request":{"body":{"domains":["stripe.com"],"page":1,"pageSize":1}},"observed":{"samples":91,"decided":88,"ok_rate":0.9886,"p50_ms":1043,"p95_ms":2526,"last_ok_days":0,"hit_rate":null,"hit_samples":0}},{"id":"oceanio.companies.lookalike","provider":"oceanio","provider_display":"Ocean.io","name":"Find lookalike companies from seed domains","summary":"Search companies using filters — seeded with lookalikeDomains, this returns companies similar to your seeds","method":"POST","path":"/v3/search/companies","scope":"any_account","tier":"core","kind":"data","domain":"companies","call_template":"treg call oceanio.companies.lookalike --method POST --data '{\"size\":2,\"companiesFilters\":{\"lookalikeDomains\":[\"stripe.com\"]},\"fields\":[\"domain\",\"name\",\"description\",\"employeeCountOcean\",\"webTraffic\",\"technologies\",\"headcountGrowth\",\"primaryCountry\",\"industries\"]}'","cost":{"type":"per_result","value":0.2,"currency":"credit","per":1,"unit":"record","source":"observed","source_url":"https://app.ocean.io/docs/getting-started/credits","checked":"2026-08-20","confidence":"verified","reported_charge":{"path":"creditsUsed","unit":"credit"},"note":"OBSERVED live 2026-08-20 on the same call as oceanio.companies.search: size=2 with lookalikeDomains=[\"stripe.com\"] returned 15,286 total matches and creditsUsed 0.4. Matches the published rate card: \"Search Companies — 0.2 credits / result\".","usd":0.0162},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-08-20","added":"2026-08-20","docs_url":"https://app.ocean.io/docs/searchCompaniesV3","has_example":true,"input":{"body":{"companiesFilters":{"type":"object","required":true,"note":"must carry `lookalikeDomains` INSIDE this object, never at the top level of the body: a list of up to 10 seed domains (your best customers, a competitor's logo wall). Combine with the ordinary filters — primaryLocations, companySizes, industries — to constrain the neighbourhood","example":{"lookalikeDomains":["stripe.com","adyen.com"],"companySizes":["201-500"]}},"size":{"type":"integer","required":false,"note":"how many similar companies to return — the price dial, max 10,000 with your own key; the shared key requires an explicit size of 1-100","example":2},"searchAfter":{"type":"string","required":false,"note":"cursor from the previous page"},"peopleFilters":{"type":"object","required":false,"note":"narrows to companies that EMPLOY people matching these filters"},"fields":{"type":"array[string]","required":false,"note":"which Company fields to return"}},"note":"the same route as oceanio.companies.search, listed separately because lookalike-by-seed-domain is a job of its own and few providers do it. Each row carries `relevance`: A / B / C. `minRelevance` and `maxRelevance` inside companiesFilters let you keep only the close matches"},"body_allowlist":true,"test_request":{"body":{"size":2,"companiesFilters":{"lookalikeDomains":["stripe.com"]},"fields":["domain","name","description","employeeCountOcean","webTraffic","technologies","headcountGrowth","primaryCountry","industries"]}},"observed":{"samples":583,"decided":451,"ok_rate":1.0,"p50_ms":1084,"p95_ms":5722,"last_ok_days":1,"hit_rate":0.8067,"hit_samples":450}},{"id":"predictleads.companies.similar","provider":"predictleads","provider_display":"PredictLeads","name":"Lookalike companies for a domain, with reasons","summary":"Returns a list of a company's Similar Companies and, for the top 20, provides a reason why they are considered similar.","method":"GET","path":"/companies/{company_id_or_domain}/similar_companies","scope":"any_account","tier":"core","kind":"data","domain":"companies","call_template":"treg call predictleads.companies.similar --query company_id_or_domain=stripe.com --query limit=1","cost":{"type":"per_result","value":1,"currency":"credit","per":1,"unit":"record","source":"docs","source_url":"https://predictleads.com/pricing","checked":"2026-08-20","confidence":"documented","note":"docs label this endpoint '1 Credit / Record'; the pricing FAQ calls out Similar Companies by name as priced per returned company","usd":0.04},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-08-20","added":"2026-08-20","docs_url":"https://docs.predictleads.com/v3/api_endpoints/similar_companies_dataset/retrieve_company_s_similar_companies","has_example":true,"input":{"pathParams":{"company_id_or_domain":{"type":"string","required":true,"note":"company domain or PredictLeads company UUID","example":"stripe.com"}},"queryParams":{"page":{"type":"integer","required":false},"limit":{"type":"integer","required":false,"note":"default 20, max 50 — PRICE DIAL: 1 credit per company returned","example":1}},"note":"each result carries a similarity `score`, a `position` rank and, in the top 20, a plain-English `reason`"},"test_request":{"pathParams":{"company_id_or_domain":"stripe.com"},"queryParams":{"limit":1}},"observed":{"samples":652,"decided":651,"ok_rate":1.0,"p50_ms":219,"p95_ms":716,"last_ok_days":0,"hit_rate":null,"hit_samples":0},"reviews":{"teams":0,"samples":[{"usefulness":"useful","reason":"Relevant AI/product-engineering lookalikes for limestonedigital.com with plain-English reasons (Gorilla Logic, 8th Light, Netguru, Rootstrap, Particle41, etc.).","client":"mcp","month":"2026-09"}]}},{"id":"tomba.companies.similar","provider":"tomba","provider_display":"Tomba","name":"Find lookalike companies from a seed domain","summary":"Company domain → comparable companies with their domain, name and industry — competitor and lookalike discovery from one seed","method":"GET","path":"/v1/similar","scope":"any_account","tier":"core","kind":"data","domain":"companies","call_template":"treg call tomba.companies.similar --query domain=stripe.com","cost":{"type":"per_call","value":1,"currency":"credit","per":1,"unit":"call","source":"observed","source_url":"https://tomba.io/pricing","checked":"2026-08-20","confidence":"verified","note":"rate card: 1 credit per similar-domain lookup; /v1/logs reported cost=1","usd":0.0089},"async":null,"platform_eligible":true,"platform_blocked":null,"miss":null,"status":null,"status_note":null,"superseded_by":null,"verified":"2026-08-20","added":"2026-08-20","docs_url":"https://docs.tomba.io/attributes/similar","has_example":true,"input":{"queryParams":{"domain":{"type":"string","required":true,"note":"seed company domain, no protocol or www","example":"stripe.com"}}},"test_request":{"queryParams":{"domain":"stripe.com"}},"observed":{"samples":885,"decided":857,"ok_rate":0.9988,"p50_ms":232,"p95_ms":1269,"last_ok_days":0,"hit_rate":1.0,"hit_samples":824},"reviews":{"teams":0,"samples":[{"usefulness":"not_useful","reason":"Lookalikes were string matches on the domain name (speaker, speakeasy) rather than companies in the same market; the served provider ignored the seed company's industry.","client":"mcp","month":"2026-10"},{"usefulness":"partly","reason":"Mixed: some title/DMV peers (usvrs, nytagandtitle, carregistration) but many were actual carriers not service-layer shops","client":"mcp","month":"2026-09"},{"usefulness":"not_useful","reason":"Most results were name collisions, local agencies, or unrelated businesses rather than digital consumer insurers comparable to boom.co.uk.","client":"cli","month":"2026-09"}]}}],"related_capabilities":[{"endpoint_id":"treg.companies.enrich","capability":"companies.enrich","does":"Enrich a company from its domain or name"},{"endpoint_id":"treg.companies.jobs.search","capability":"companies.jobs.search","does":"Search indexed job listings across companies"},{"endpoint_id":"treg.companies.news","capability":"companies.news","does":"Recent news & signals about a company"},{"endpoint_id":"treg.companies.search","capability":"companies.search","does":"Search companies by industry, size or tech — account lists for lead generation"}],"routing":{"contract":{"identity":[["domain"]],"output":{"companies":{"type":"list","required":true},"count":{"type":"int"}},"miss":"companies == []","derive":{}},"plan":[{"endpoint_id":"tomba.companies.similar","accepts":[["domain"]],"usd":0.0089,"hit_rate":1.0,"usd_per_hit":0.0089,"works":0.9988},{"endpoint_id":"companyenrich.companies.similar","accepts":[["domain"]],"usd":0.049,"hit_rate":1.0,"usd_per_hit":0.049,"works":1.0},{"endpoint_id":"oceanio.companies.lookalike","accepts":[["domain"]],"usd":0.162,"hit_rate":0.8067,"usd_per_hit":0.2008181480104128,"works":1.0}],"also":[{"endpoint_id":"companyenrich.companies.similar.scroll","usd":0.049},{"endpoint_id":"findymail.lookalike.search","usd":0.00198},{"endpoint_id":"leadsforge.companies.lookalike.preview","usd":0.0},{"endpoint_id":"leadsforge.companies.lookalike.search","usd":0.0245},{"endpoint_id":"predictleads.companies.similar","usd":0.04}],"headers":{"X-Treg-Route-Waterfall":"on by default: a miss tries the next provider; 0 = stop at the first miss","X-Treg-Route-Max-Cost":"USD ceiling for the whole call (default 1.00)","X-Treg-Route-Prefer":"provider[,…]","X-Treg-Route-Exclude":"provider[,…]","X-Treg-Route-Strict-Filters":"1 = never call a provider that cannot apply a filter you sent (answers 422, nothing charged); off by default — the answer names what was ignored in X-Treg-Ignored-Filters"}},"call_template":"treg call treg.companies.similar --method POST --data '{\"domain\":\"stripe.com\"}'","example_response":null,"hints":["treg call treg.companies.similar --method POST --data '{\"domain\":\"stripe.com\"}'   # run it — key injected server-side","treg catalog get companyenrich.companies.similar   # the same job from companyenrich"]}