Milda API

Companies — Competitors

POST /v1/companies/competitors

The companies competing for the same buyers, whether or not they share the company's industry. Milda first works out what the company sells and to whom, breaks that into product and service lines, then finds and scores companies competing in those lines.

Use this endpoint to map a market around a company, to qualify a prospect against the alternatives it faces, or to expand a target list with companies that share a buyer rather than an industry code. Every competitor comes with the specific lines it contests and an explanation of where the two meet, so you can check each result.

Request

• company_id (required) — Company ID.

Response

• profile — how the requested company competes; null when its offering could not be established:
• what_it_sells — its own product and service lines, named concretely
• customers_served — the customers it sells to
• how_it_competes — how it positions itself against alternatives
• geographic_locality — local, regional or global: how much a competitor's proximity matters for this business
• locality_reason — why that locality was assigned
• dimensions — the requested company's product and service lines competitors are matched against:
• id — dimension ID, referenced by each competitor's overlaps
• label — short label for the line
• offering — what the company offers in that line
• weight — how much of the company's business the line represents (0–1)
• competitors — competitors ordered by competition_score, strongest first:
• company_id, name, url, domain_display, country_code, main_industry, summary — identifying and firmographic fields; pass company_id to POST /v1/companies/profiles for the full profile
• competition_score — how strongly it competes (0–1): share of the company's product lines contested, discounted by confidence and geographic distance
• product_coverage — share of the company's product lines it also offers (0–1)
• confidence — confidence in the assessment (0–1), based on how much evidence was found
• geo_tier — same_country, shared_market (operates in a market the company also serves), same_region or other
• geo_tier_label — human-readable label for geo_tier
• overlaps — contested lines as {dimension_id, match}, where match is same or similar
• explanation — why it is a competitor and where the two meet

Returns 204 No Content when no competitors could be identified.

Notes

The report is generated on demand and cached server-side. A first call for a company runs two reasoning passes plus a similarity search and can take 15–30 seconds; later calls return the cached report.

Credits

Charged a flat fee per company (data credits). It is the highest fee of the three company insight endpoints, since the report is built on demand.