Skip to main content

​
Throughput and result limits

ConstraintValue
Concurrent sessions per customer500
search_clicks — max records returned1,000
search_conversions — max records returned500
search_clicks — max date window14 days
search_conversions — minimum windowOne full UTC day (YYYY-MM-DD 00:00:00 → 23:59:59) — sub-hour windows may return an error
run_performance_report — max rows per page100
run_performance_report — max total rows (all pages combined)500 — truncated: true is set when this ceiling is hit
list_offers, list_affiliates, list_entities — max rows per page200
Rate limit30 req/s per customer — one shared bucket across all API keys, all users, and both REST and MCP. See Rate Limiting.

​
Parameter length limits

All string parameters are validated server-side before any backend call. A request that exceeds a limit is rejected immediately with an INVALID_ARGUMENT error — no partial processing occurs.
sub1–sub5, adv1–adv5, and source_id are affiliate-controlled tracking values written directly to database columns. Their limits match the underlying column constraint.
ParameterMax
sub1, sub2, sub3, sub4, sub5600 chars
adv1, adv2, adv3, adv4, adv5600 chars
source_id600 chars
These limits apply across every tool where the parameter appears.
ParameterMax
cursor (pagination token)1,024 chars
timezone (IANA name, e.g. America/New_York)64 chars
currency (ISO code, e.g. USD)8 chars
ParameterToolMax
dimensionsrun_performance_report256 chars
filters (comma-separated type:value string)run_performance_report4,096 chars total
sort_byrun_performance_report128 chars
sort_directionrun_performance_report8 chars
includerun_network_summary256 chars
Individual non-sub filter values (e.g. country, status, offer_id)search_clicks, search_conversions64 chars each
ParameterToolMax
includeget_offer, get_affiliate256 chars
affiliate_ids, offer_idsget_offer, get_affiliate1,024 chars
can_runget_affiliate8 chars
Individual filter values (search, status, label, etc.)list_offers, list_affiliates256 chars each
ParameterToolMax
typeget_entity, get_entity_schema, list_entities64 chars
idget_entity64 chars
includeget_entity1,024 chars
filters (JSON object)list_entities4,096 chars
parameters (JSON object)get_entity4,096 chars

​
Error response

When a parameter limit is exceeded, the server returns a structured error before any backend call is made: 
{
  "code": "INVALID_ARGUMENT",
  "message": "Parameter 'sub1' exceeds the maximum length of 600 characters (got 847)."
}
The message always names the offending parameter, the allowed maximum, and the actual length received.