Milda API

This endpoint allows you to submit a list of companies for enrichment using Milda company IDs or company URLs.

Purpose

Milda may not have data for all companies in your database. This endpoint initiates the enrichment process, which usually takes 24–48 hours to complete.

Use this when: - You want to enrich firmographic and contact data for companies currently marked as NOT_PROCESSED. - You want to check which submitted companies will eventually become available on the platform.

Enrichment Workflow

1. Step 1 – Submit a list of companies using company_ids or urls
   → You receive their current status.
2. Step 2 – Wait 24–48 hours, then use the Get Company Statuses endpoint
   → Check if the statuses have changed (e.g., to ON_PLATFORM).

Important:

Only companies with NOT_PROCESSED status are submitted.
Companies with any other status are returned with their current status, are not submitted and cost nothing.

Statuses Returned

For each company submitted, you may receive:

• ON_PLATFORM – Data enrichment complete. Company data is now available.
• PROCESSING – In the fast processing pipeline (usually 24–48 hours). Companies this request submitted show submitted: true; this includes websites new to Milda and companies that were waiting in Milda's regular processing queue. Companies already in the fast pipeline show submitted: false and are not charged again.
• NOT_PROCESSED – Returned only for a redirect target when submit_redirects is false; every other company Milda has no data for is submitted.
• UNAVAILABLE – Milda tried and could not collect data. Common reasons:
• The website cannot be reached or does not exist
• The website blocks data collection
• The website has no usable text

The row's status_details says which, in plain text (e.g. "The website's domain does not resolve, so it may not exist."). - NOT_FOUND – Unknown company ID (company IDs only; a URL is never NOT_FOUND) - INVALID_INPUT – The URL is malformed and could not be resolved to a company

Redirects

Some websites redirect to another company's website. When Milda has already crawled a requested website and found that it redirects, the row describes the company it redirects to:

• redirected_from_company_id – the company ID of the website you requested
• redirect_url – the website it redirects to
• company_id and status – the company behind redirect_url

If that company is NOT_PROCESSED, it is submitted for enrichment and charged like any other submitted company. Set submit_redirects to false to see the redirect without submitting it.

A website Milda has never crawled cannot show a redirect yet.

What to Do After Enrichment

Once a company reaches ON_PLATFORM status, you can:

• Use Text Search to segment your enriched companies
• Use Profiles to access their firmographic profile
• Use People Search and Get Verified Emails for employee and contact data

Credit Usage

• Cost – 1 enrichment credit for each company the request submits. Companies that are not submitted cost nothing.
• Refunds – 36 hours after submission, the credit comes back for every submitted company that has not reached ON_PLATFORM.
• Balance – Enrichment credits are separate from data credits. remaining_credits in the response shows your enrichment balance after the request.
• Limit – Up to 1,000 company IDs and 1,000 URLs per request. If your enrichment balance cannot cover every company the request would submit, the whole request is rejected with 403 and nothing is submitted.

---

Rate Limit

10 requests per second