Adverso
Browse all topics

Parameters

The parameters most tools share: marketplace, period, ad type, sorting, filtering and paging.

Your AI fills these in from your question. You only need this page when you call the server yourself, or when you want to know what you can ask for.

Marketplace

marketplace_id says which marketplace a question is about. Take the id from list_accounts.

  • With one marketplace on your plan, leave it out.
  • With several, it is required. Without it the server answers with a sentence asking which one.

Period

ParameterDefaultFormat
date_toyesterdayYYYY-MM-DD
date_from6 days before date_toYYYY-MM-DD

Both days are included, so the default period is 7 days. One call covers at most 90 days. For a longer comparison, ask for several periods.

Ask for a period inside the days that have data. list_accounts returns them as performance_data_from and performance_data_to. A period outside them is not an error: it simply returns no rows.

Ad type

ad_type is SP (Sponsored Products, the default), SB (Sponsored Brands) or SD (Sponsored Display). One call returns one ad type.

Not every tool exists for every ad type, because Amazon does not report everything for each:

ToolSPSBSD
get_campaigns, get_ad_groups, get_keywordsyesyesyes
get_search_terms, get_placementsyesyesno
get_productsyesnoyes

Asking for a combination that does not exist returns no rows and a note that says so.

Sorting

sort_by puts the highest value first. It takes cost (the default), sales, clicks, impressions, orders, acos or roas.

Filtering

ParameterKeeps
searchrows whose campaign, ad group, keyword, search term, ASIN, placement or product title contains the text. Upper and lower case do not matter.
campaign_idrows of one campaign

get_structure also takes state (ENABLED, PAUSED, ARCHIVED).

Paging

limit is the number of rows returned: 50 by default (100 for get_structure), 500 at most. Every answer includes total_rows, the number of rows that match.

To read past the first page, call again with offset:

Example
{ "date_from": "2026-11-11", "date_to": "2026-11-17", "limit": 500, "offset": 500 }

The totals in an answer always cover every matching row, not only the page you received.