Text Search: POST /v1/companies/text-search

POSThttps://api.milda.ai/v1/companies/text-search

Text Search

application/json

Description

The Text Search endpoint allows users to find relevant companies on the Milda platform using a free-text query. It supports both simple keywords and detailed descriptions.

Query Options

You can input one of the following into the keyword parameter: - A specific keyword (e.g. creative agency, private credit, B2B data provider) - A highly descriptive phrase (e.g. companies that remove oil and water from gas, conversion of atmospheric CO₂ into carbonate minerals using highly reactive minerals in steel slag)

Response Data

The endpoint returns: - A list of companies, each with: - A unique Milda company ID - 18 firmographics data fields (same as the Profiles endpoint) - An additional relevance score

Relevance Score

80–100%: Company specializes in the queried niche.
50–79%: Company has relevant activities/products but may also operate in other areas.
Below 50%: Company is semantically related to the niche but doesn’t explicitly state such involvement.

Filters

You can narrow your search using filters such as: - Relevance score - Country - Industry - Company age - Company size - Other parameters

Searching within a set of companies

Pass company_ids and/or urls to restrict the search to that set of companies (max 1000). When provided, the keyword search runs only within those companies. Leave them empty to search the whole platform.

Credit Usage

Open keyword search (no company_ids/urls): 10 credits per search + 0.2 credit per company returned.
Search within a set (company_ids/urls provided): flat 10 credits per search.

Example

Open keyword search returning 100 companies: - Total cost = 10 + (0.2 × 100) = 30 credits

Exclusions

To avoid duplicates, use: - exclude_company_ids to exclude previously returned companies by ID - exclude_urls to exclude companies by URL

No credits are charged for excluded companies, so re-running a similar query returns new companies instead of repeats.

Notes

If limit is not specified, the endpoint returns up to 10,000 companies.
If your search yields 8,000+ companies, consider refining by region or country for better granularity.

Rate Limit

1 request per second

Headers

nameinreqdescription

tokenheaderyesAPI token. Issued per account; check it with GET /v1/credit-usage.

Request body

TextSearchItem

TextSearchItemtypereq27 fields

countriesCountryCode[] | null—Include companies headquartered in ANY of these countries.

exclude_countriesCountryCode[] | null—Exclude companies headquartered in ANY of these countries.

locationsCountryCode[] | null—Include companies with operations in ANY of these countries.

locations_notCountryCode[] | null—Exclude companies with operations in ANY of these countries.

industries_nace2digitstring[] | null—Include companies active in ANY of these NACE 2-digit industries. Example: {'47', '62'} includes companies in Retail trade (47) and Computer programming (62).

exclude_industries_nace2digitstring[] | null—Exclude companies active in ANY of these NACE 2-digit industries. Example: {'35'} excludes companies in Electricity, gas, steam and air conditioning supply (35).

industries_nace4digitstring[] | null—Include companies active in ANY of these NACE 4-digit industries. Example: {'4711', '6201'} includes companies in Retail sale in non-specialised stores with food (4711) and Computer programming activities (6201).

exclude_industries_nace4digitstring[] | null—Exclude companies active in ANY of these NACE 4-digit industries. Example: {'3521'} excludes companies in Manufacture of gas (3521).

industries_sicstring[] | null—Include companies active in ANY of these US SIC industries. Example: {'804'} includes companies in Offices of health practitioners (804).

exclude_industries_sicstring[] | null—Exclude companies active in ANY of these US SIC industries. Example: {'249'} excludes companies in Wood products not elsewhere classified (249).

value_chainsValueChain[] | null—Include companies engaged in ANY of these value chain segments.

exclude_value_chainsValueChain[] | null—Exclude companies engaged in ANY of these value chain segments.

ageAge[] | null—Filter by one or more company age categories.

sizeSize[] | null—Filter by one or more company size categories.

turnoverTurnover[] | null—Filter by one or more company turnover categories.

has_linkedinboolean—Filter for companies with a LinkedIn page.default false

has_twitterboolean—Filter for companies with a Twitter/X page.default false

has_facebookboolean—Filter for companies with a Facebook page.default false

relevance_scoreRelevanceScore[] | null—Include companies in the top-X% of relevance scores. Allowed values: high, medium, low.

momentum_scoreinteger[] | null—Include companies in the top-X% of momentum scores. Allowed values: 5, 10, 25.

keywordstringyesKeyword or phrase to search.

use_name_searchboolean—Whether to also search for companies by name.default true

company_idsstring[]—Restrict the search to these company IDs (max 1000). When provided (with `urls`), the search runs only within this set.

urlsstring[]—Restrict the search to these company URLs or domain names (max 1000).

exclude_company_idsstring[]—List of company IDs to exclude from the search results.

exclude_urlsstring[]—List of company URLs to exclude from the search results.

limitinteger | null—Maximum number of results to return.

Responses

200 Successful Response422 Validation Error

TextSearchResponsetypereq2 fields

+companiesSearchCompany[]yes

rankintegeryesPosition of the company in the search results, ranked by relevance.

relevance_scoreinteger | null—Relevance score assigned based on query matching.

company_idstringyesUnique identifier for the company.

namestring | null—Full name of the company.

urlstring | null—URL of the company's official website.

country_codeCountryCode | null—Company's country, as a two-letter ISO 3166-1 alpha-2 code.

sizeSize | null—Company size category based on employee count.

search_idstringyes