Dealert Data API

Programmatic access to the Dealert M&A deals database — browse with filters, run semantic search, fetch a single deal, and pull the reference vocabularies you need to build queries. A simple, read-only REST API returning JSON.

Introduction

All endpoints are GET requests and return JSON. Successful list responses are shaped { "data": [...], "pagination": {...} }; single-object responses are { "data": {...} }. Access requires an active Data API add-on on your account and an API key.

Don't have access yet? Enable the add-on and create a key →

Authentication

Send your secret key on every request, in either header:

# Recommended
curl -H "X-API-Key: YOUR_KEY" "https://dealert.ai/api/v1/deals?limit=5"

# Or a bearer token
curl -H "Authorization: Bearer YOUR_KEY" "https://dealert.ai/api/v1/deals?limit=5"

Rate limits & quota

Each account has a monthly request quota that resets on the 1st of the month. Every response includes your current standing:

When the quota is exhausted, requests return 429 until the reset date. Requests rejected before authentication (unknown route, missing key) do not count against your quota.

Per-minute rate limit

In addition to the monthly quota, each API key is limited to 100 requests per minute. Every response carries your current standing, and throttled requests do not consume monthly quota:

Exceeding the limit returns 429 with type: "rate_limited". Back off for the number of seconds in Retry-After and retry.

Errors

Errors use a consistent envelope and standard HTTP status codes:

{ "error": { "type": "quota_exceeded", "message": "Monthly API quota exceeded. Resets on 2026-08-01." } }

List deals

Browse and filter the deals database, most recent first. Paginated.

Query parameters

Example

curl -H "X-API-Key: YOUR_KEY" \
  "https://dealert.ai/api/v1/deals?target_country=1&min_ev=50&data_source=confirmed&limit=2"

{
  "data": [
    {
      "deal_code": "GCXI",
      "buyer_name": "Baladna Q.P.S.C., Algerian National Investment Fund",
      "target_name": "Baladna Algeria S.P.A.",
      "deal_year": 2025,
      "target_country": "Algeria",
      "target_industry": "Dairy Products",
      "deal_type": "Strategic Partnership",
      "transaction_size": "155.00",
      "ev": null, "revenue": null, "ebitda": null,
      "ev_est_min": "160.0", "ev_est_max": "190.0"
      /* …more fields — see "The deal object" */
    }
  ],
  "pagination": { "page": 1, "limit": 2, "total": 33, "total_pages": 17 }
}

Search deals

Hybrid keyword + semantic (vector) search, ordered by relevance. Accepts the same filter parameters as List deals (except buyer_name/target_name).

curl -H "X-API-Key: YOUR_KEY" \
  "https://dealert.ai/api/v1/deals/search?q=AI%20infrastructure%20acquisitions&limit=5"

Response adds the echoed query alongside data and pagination.

Get a deal

Fetch a single deal by its deal_code. Returns 404 if no match.

curl -H "X-API-Key: YOUR_KEY" "https://dealert.ai/api/v1/deals/GCXI"

{ "data": { "deal_code": "GCXI", "buyer_name": "…", /* …full deal object */ } }

Reference data

Lookups for building filter queries. Each returns { "data": [...] }.

curl -H "X-API-Key: YOUR_KEY" "https://dealert.ai/api/v1/reference/countries"

Likely buyers

Find the acquirers and investors most likely to buy a target with a given profile, ranked by historical deal fit with supporting evidence.

curl -H "X-API-Key: YOUR_KEY" \
  "https://dealert.ai/api/v1/likely-buyers?niche=50&country=1&size_band=large&buyer_type=financial"

Returns { "data": [ … ] } — each buyer has buyer_name, match_strength_label, score_pct, supporting_deal_count, reasoning, and up to 3 supporting_deals. Up to 100 results.

Instant comps

Resolve a company by name and return a set of AI-ranked comparable transactions. This runs a live analysis and typically takes ~30 seconds — set a generous client timeout.

curl -H "X-API-Key: YOUR_KEY" "https://dealert.ai/api/v1/comps?company=Salesforce"

Returns { "data": [ … ], "company": "…", "website": "…", "logic": { … } }. Each item in data is a comparable deal with relevancy_pct, relevancy_label, and the standard deal fields. logic describes the inferred industry/geography used for matching. 404 if the company can't be resolved.

The deal object

Financial figures are in USD millions. Disclosed fields are null when not publicly reported; the matching *_est_min/*_est_max pair carries Dealert's estimated range for that metric.