Our dataPricingContact
Log in

API reference

Milda API

Base URL
https://api.milda.ai
Overview

Credit Usage1

  • GETCredit Usage

Company Search3

  • POSTFind Company
  • POSTText Search
  • POSTText Search Insights

Companies7

  • POSTSubmit Companies for Enrichment
  • POSTCompany Statuses
  • POSTCompany Profiles
  • POSTCompany Events
  • POSTPlaces of Performance
  • POSTGrowth Signals
  • POSTProducts & Clients

People2

  • POSTPeople Search
  • POSTVerified Email

Trade Data5

  • POSTTrade Candidates
  • POSTTrade Analytics
  • POSTShipping Records
  • POSTShipment Suppliers
  • POSTShipment Recipients

Patents7

  • POSTPatent Summary
  • POSTPatent Co-applicants
  • POSTPatent Inventors
  • POSTTechnology Users
  • POSTTechnology Providers
  • POSTPatent Citations
  • POSTPatent List

Publications5

  • POSTPublication Analytics
  • POSTPublication Authors
  • POSTPublication Funders
  • POSTCollaborating Organizations
  • POSTTop Cited Works

Risk Assessment4

  • POSTRisk Candidates
  • POSTCompany Financials
  • POSTCompany Ownership
  • POSTRisk Report

Companies

3 of 7
POSThttps://api.milda.ai/v1/companies/profiles

Company Profiles

application/json
01

Description

This endpoint retrieves full company profile documents using company IDs or URLs.


Input Options

You can provide one of the following: - Company IDs – Use the company_ids parameter. These can be obtained from: - Text Search - Find Company (lookup) - Company URLs – Use the urls parameter, e.g.: - https://milda.ai/api - milda.ai

Data Returned

Returns the company's firmographics, including: - Company name - Website URL - Business description - Key activities - Country - Locations - Company size - Company age - Turnover - Industry classifications: - NACE 2-digit - NACE 4-digit - US SIC 3-digit - Additional metadata

Note:
This endpoint does not return: - Employee lists
- Verified emails
- Events To get that data, use: - People Search - Get Verified Emails - Get Events Data

Companies Without a Profile

Every requested company gets a row, so you can match each input to a result. A company without profile data comes back with only its ID, the URL you sent and its status:

  • NOT_PROCESSED or PROCESSING – submit it with Enrichment, or wait for enrichment to finish
  • UNAVAILABLE – Milda could not collect data for it
  • NOT_FOUND or INVALID_INPUT – the ID is unknown or the URL is malformed
  • REDIRECT – the website redirects to another company's website. The row names that company in redirect_company_id and its website in redirect_url. Its profile is not included; request redirect_company_id to get it.
Credit Usage
  • 1 credit per company that returns profile data
  • Companies returned as NOT_FOUND, NOT_PROCESSED, PROCESSING, UNAVAILABLE, REDIRECT or INVALID_INPUT are not charged

Rate Limit

10 requests per second

02

Headers

nameinreqdescription
tokenheaderone ofYour API token, sent as "token: YOUR_API_TOKEN". Send this or Authorization.
Authorizationheaderone ofThe same token in the standard form, sent as "Authorization: Bearer YOUR_API_TOKEN" (the word Bearer, a space, then your token). Send this or token.
03

Request body

CompanyDataRequestItem
CompanyDataRequestItemtypereq2 fields
company_idsstring[]—Array of company ids (up to 1000)
urlsstring[]—Array of company URLs or domain addresses (up to 1000)
04

Responses

200 Successful Response422 Validation Error

Returns a JSON array. Each item:

CompanyProfiletype24 fields
Company
company_idstring | nullUnique identifier for the company.
requested_urlstring | nullURL submitted in the request, if available.
statusCompanyStatus | nullStatus of the company, representing the result of processing and matching. Possible values: - 'ON_PLATFORM': The company's data is available on the platform. - 'PROCESSING': In Milda's fast processing pipeline (submitted for enrichment or being collected). - 'NOT_PROCESSED': No data yet: the website is new to Milda or waiting in its regular queue. Submit it for enrichment. - 'UNAVAILABLE': Milda could not collect data (website unreachable, blocked, or without usable text). - 'REDIRECT': The company's website redirects to another company's website; see `redirect_company_id` and `redirect_url`. No profile is returned for it. - 'NOT_FOUND': The company ID is not known (only company IDs; a URL is never NOT_FOUND). - 'INVALID_INPUT': The provided URL was malformed and could not be resolved.
redirect_company_idstring | nullSet only when status is REDIRECT: the ID of the company the requested website redirects to.
redirect_urlstring | nullSet only when status is REDIRECT: the website the requested website redirects to.
namestring | nullFull name of the company.
websitestring | nullURL of the company's official website.
countryCountryCode | nullTwo-letter ISO 3166-1 country code representing the company's location.
milda_linkstring | nullLink to the company's profile on Milda.ai.
Activities
general_summarystring | nullBrief description or overview of the company.
general_activitiesstring[] | nullList of business activities the company is involved in.
value_chainsstring[] | nullList of value chain segments the company participates in.
Industry
industry_nace2digitstring[] | nullList of 2-digit NACE industry classification codes. Example: ['47', '62'] for Retail trade (47) and Computer programming (62).
industry_nace4digitstring[] | nullList of 4-digit NACE industry classification codes. Example: ['4711', '6201'] for Retail sale in non-specialised stores with food (4711) and Computer programming activities (6201).
industry_sicstring[] | nullList of US SIC (Standard Industrial Classification) codes. Example: ['804'] for Offices of health practitioners.
Size and age
ageAge | nullCompany age category: '1-3 years', '4-5 years', '6-10 years' or '10+ years'.
sizeSize | nullCompany size category based on employee count.
turnoverTurnover | nullCompany turnover category based on annual revenue.
Locations
locationsobject[] | nullList of locations associated with the company, including their types and link intensity scores. Location types include 'country', 'region', and 'city'.
Contact
emailsstring[] | nullList of general contact email addresses for the company.
social_mediaobject | nullSocial media presence of the company (e.g., LinkedIn, Twitter).
Certifications
isoobject | nullDictionary of ISO standards found on the company's website.
Scores and freshness
rank_scorestring | nullMomentum score assigned to the company.
timestampstring | nullTimestamp of the last update to the company's data.
PreviousCompany StatusesNextCompany Events

© 2026 Milda.ai All rights reserved.

  • Privacy policy
  • Terms and Conditions
  • Blog