Skip to main content

Throughput and result limits

ConstraintValue
Concurrent sessions per network500 — shared across all users and API keys on the network
Session idle timeout10 minutes — idle sessions are closed server-side; Streamable HTTP clients renegotiate automatically on the next request
search_activity (type="click") — max records returned1,000
search_activity (type="conversion") — max records returned500
search_activity (type="click") — max date window14 days
search_activity (type="conversion") — minimum windowOne full day in the network timezone (YYYY-MM-DD 00:00:00YYYY-MM-DD 23:59:59) — shorter windows may return an error
run_performance_report — max rows per page100
run_performance_report — max total rows (all pages combined)500 — result_capped: true (with row_limit) is set when this ceiling drops rows
list_offers, list_affiliates, list_entities — max rows per page200
Rate limit10 req/s per network — dedicated MCP bucket, shared across all users and API keys on the network. Independent from the REST API quota.

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.
sub1sub10, adv1adv10, 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, sub5, sub6, sub7, sub8, sub9, sub10600 chars
adv1, adv2, adv3, adv4, adv5, adv6, adv7, adv8, adv9, adv10600 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_activity64 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.