Welcome to the Acquisition Signals API
The Acquisition Signals API provides access to comprehensive, real-time acquisition signals aggregated from across the web. Our platform continuously monitors and collects acquisition activity, giving you up-to-date information on M&A deals, acquirers, and market trends.
Acquisition Signals Endpoint View the complete OpenAPI specification
Count Mode
You can get the total number of results matching any filter combination without consuming credits by adding count=true to your request. This returns an empty data array with full pagination metadata, including totalCount.
curl -X GET "https://www.trysignalbase.com/api/v2/signals/acquisitions?count=true&countries=US,GB&date_preset=last_90d" \
-H "Authorization: Bearer YOUR_API_KEY"
Response:
{
"success" : true ,
"data" : [],
"pagination" : {
"currentPage" : 1 ,
"totalPages" : 8 ,
"totalCount" : 152 ,
"hasNextPage" : true ,
"hasPreviousPage" : false
},
"meta" : {
"endpoint" : "signals.acquisitions" ,
"creditsUsed" : 0
}
}
Use count mode to preview how many results match your filters before fetching actual data. This is useful for building filter UIs, showing result counts, or validating queries — all at zero credit cost.
Key Features
Real-time Signals : Acquisition signals are aggregated continuously from web sources
Advanced Filtering : Filter by countries, categories, subcategories, date ranges, and search terms
Numeric Range Filters : Filter by amount, employee count, and founded year
Flexible Sorting : Sort by date, amount, or employee count
Verification Status : Filter signals by verified, unverified, or pending status
Pagination Support : Efficiently retrieve large datasets with up to 100 results per page
Rich Response Data : Detailed company information, acquisition amounts, and acquirer data
Credit-based Usage : Transparent credit consumption per API call
Service Level
Rate Limit : Based on your subscription tier
Uptime : 99% guaranteed uptime
Data Freshness : Real-time aggregation ensures up-to-date signals
Maximum Results : Up to 100 results per page
Authentication
All API endpoints require authentication using a Bearer token passed in the Authorization header.
curl -X GET "https://www.trysignalbase.com/api/v2/signals/acquisitions?page=1&limit=20" \
-H "Authorization: Bearer YOUR_API_KEY"
Query Parameters
Parameter Type Default Description pageinteger 1 Page number limitinteger 20 Results per page (max: 100)
Date Filters
Parameter Type Description dateFromstring Filter by date from (ISO-8601 string) dateTostring Filter by date to (ISO-8601 string) date_presetstring Relative date shorthand — takes precedence over dateFrom/dateTo. See Date Presets
Company Filters
Parameter Type Description countriesstring Comma-separated country codes (e.g., US,GB,DE) categoriesstring Pipe-separated company categories / industries subcategoriesstring Comma-separated subcategory IDs (e.g., ai,fintech,saas) industrystring Comma-separated exact industry names company_namestring Search by acquired company name (partial match) searchstring Free-text search across company name & industry
Numeric Range Filters
Parameter Type Description amount_mininteger Minimum acquisition amount in USD cents amount_maxinteger Maximum acquisition amount in USD cents employee_count_mininteger Minimum company employee count employee_count_maxinteger Maximum company employee count founded_year_mininteger Minimum company founded year founded_year_maxinteger Maximum company founded year
Acquisition-specific Filters
Parameter Type Description currencystring Currency symbol filter (e.g., $, €, £) verification_statusstring Comma-separated statuses: verified, unverified, pending acquiring_companystring Search by acquiring company name (partial match)
Sorting
Parameter Type Default Description sort_bystring occurred_atSort field: occurred_at, discovered_at, amount, employee_count sort_orderstring descSort direction: asc or desc
Response Structure
All successful responses follow this structure:
{
"success" : true ,
"data" : [ ... ],
"pagination" : {
"currentPage" : 1 ,
"totalPages" : 10 ,
"totalCount" : 200 ,
"hasNextPage" : true ,
"hasPreviousPage" : false
},
"meta" : {
"endpoint" : "signals.acquisitions" ,
"creditsUsed" : 1
}
}
Error Handling
The API returns standard HTTP status codes:
200 : Success
401 : Unauthorized - Invalid or missing API key
429 : Rate limit exceeded
500 : Internal server error
Error responses include:
{
"success" : false ,
"error" : "Error message description"
}
Example Usage
Filter by Date Preset and Country
curl -X GET "https://www.trysignalbase.com/api/v2/signals/acquisitions?date_preset=last_90d&countries=US,GB" \
-H "Authorization: Bearer YOUR_API_KEY"
Filter by Amount and Acquiring Company
curl -X GET "https://www.trysignalbase.com/api/v2/signals/acquisitions?amount_min=10000000&acquiring_company=Google" \
-H "Authorization: Bearer YOUR_API_KEY"
Filter by Subcategory with Sorting
curl -X GET "https://www.trysignalbase.com/api/v2/signals/acquisitions?subcategories=ai&sort_by=amount&sort_order=desc" \
-H "Authorization: Bearer YOUR_API_KEY"
Combined Filters
curl -X GET "https://www.trysignalbase.com/api/v2/signals/acquisitions?date_preset=last_30d&countries=US&verification_status=verified&sort_by=discovered_at&limit=50" \
-H "Authorization: Bearer YOUR_API_KEY"