https://api.milda.ai/v1/companies/text-searchText Search
application/jsonDescription
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:
- Its rank in the results
- A unique Milda company ID
- Name, website, country and size
- The market segments it was found under
- A search_id for the search
Use the Profiles endpoint with the returned IDs to get full firmographics.
Market Segments
Milda expands your query into related market segments and searches for companies in each of them. market_segments lists every segment that matched the company, so you can see why it was returned and group results by segment.
Filters
You can narrow your search using filters such as: - 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.
Why a Company Matched
Pass the response's search_id and a company_id from the results to Text Search Insights
to get the passage that ties that company to your query. It is free.
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/urlsprovided): 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
limitcan be 1 to 10,000. Without it, the endpoint returns up to 10,000 companies (2,500 for trial tokens).- If your search yields 8,000+ companies, consider refining by region or country for better granularity.
Rate Limit
1 request per second