GloriadsGloriads
API & AI assistants/What the API reads

What the API reads

Every endpoint of the Gloriads API — performance, products, campaigns, rules and activity — with its parameters, an example, and how fresh the figures are.

The API reads the same figures as your Gloriads screens. It never changes your account or your ads.

Endpoints

EndpointWhat it returns
GET /api/v1/accountYour subscription, whether Amazon Ads is connected, and up to which day the figures go. Call it first.
GET /api/v1/marketplacesYour connected marketplaces, with their currency and how many campaigns, ad groups and ads each runs.
GET /api/v1/summaryThe totals of a period: the dashboard's cards, per marketplace and per ad type too.
GET /api/v1/timelineThe same figures day by day or month by month: the dashboard's chart.
GET /api/v1/reports/productsEach advertised product's figures over a period: the Products page.
GET /api/v1/campaignsOne marketplace's campaigns, with budget, targeting and state.
GET /api/v1/ad-groupsOne marketplace's ad groups, with their default bid.
GET /api/v1/rulesYour rules: on or off, where they act, their schedule, their last run.
GET /api/v1/rules/{rule_id}/runsOne rule's last 20 runs.
GET /api/v1/activityEverything Gloriads did on Amazon, newest first.

Every parameter and every field is in the API reference, with a Try it button.

Periods

/summary, /timeline and /reports/products cover a period. Send one of:

ParameterExampleMeaning
rangelast_30_daystoday, yesterday, last_7_days, last_14_days, last_30_days, last_60_days, last_90_days, this_month, last_month, this_year, last_year, all_time
start_date + end_date2026-09-01 and 2026-09-30Two days, both included, at most six years apart
  • Nothing sent: last_30_days, like the dashboard.
  • last_30_days includes today, like the dashboard's Last 30 days. While the dashboard compares two periods (Compare to), it stops both at yesterday: for the same figure, send start_date and end_date with end_date = yesterday.
  • all_time starts at the oldest day Gloriads holds, like Lifetime on the dashboard.
  • timezone (Europe/Paris, America/New_York…) decides which day "today" is. UTC by default.
  • Every answer repeats the days it covers in period.

Filters

ParameterExampleKeeps
marketplacesUS,UKThese countries only (GB works too)
ad_productsSPONSORED_PRODUCTSSPONSORED_PRODUCTS, SPONSORED_BRANDS or SPONSORED_DISPLAY

An unknown value is refused with a 400 that names it, never answered with zeros.

Totals of a period

curl "https://gloriads.com/api/v1/summary?range=last_month&marketplaces=US" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "period": { "start_date": "2026-09-01", "end_date": "2026-09-30", "range": "last_month", "timezone": "UTC" },
  "currency": "USD",
  "spend": 13140.53,
  "sales": 46562.2,
  "acos": 28.22,
  "roas": 3.54,
  "impressions": 3945723,
  "clicks": 13973,
  "ctr": 0.35,
  "average_cpc": 0.94,
  "purchases": 1479,
  "conversion_rate": 10.58,
  "by_marketplace": [ … ],
  "by_ad_product": [ … ],
  "meta": { "data_last_date": "2026-10-09", "history_covered": true, "truncated": false }
}
  • acos, ctr and conversion_rate are percentages: 28.22 means 28.22 %.
  • purchases counts orders, like the console's Purchases, not units.
  • A ratio without its base (ACOS with no sale) is null, never 0.

Day by day or month by month

/timeline takes the same period and filters, and returns one point per day or per month in data.

  • granularity=auto (the default) picks days up to 92 days, months beyond, like the dashboard's chart.
  • granularity=day is refused on a period longer than 92 days.
  • A day without any figure is left out.

Per product

/reports/products returns one row per advertised product (ASIN), sorted by sort (spend by default) and order (desc by default).

  • product_id: null gathers what Amazon ties to no product, mostly Sponsored Brands.
  • The rows come in pages: see Limits and errors.

Campaigns and ad groups

Both need marketplace_id: an id from /marketplaces.

curl "https://gloriads.com/api/v1/campaigns?marketplace_id=3478512345678901&states=ENABLED" \
  -H "Authorization: Bearer YOUR_API_KEY"
  • They list enabled and paused campaigns of Sponsored Products, Sponsored Brands and Display. Archived ones are never listed.
  • Budgets and bids are in the marketplace's own currency (currency_code in /marketplaces).
  • provenance says whether Gloriads created the campaign, changed it, or never touched it.
  • /ad-groups?campaign_id=… keeps one campaign's ad groups.
  • Up to 1,000 rows per page (100 by default).

Rules and activity

  • /rules lists every rule, most recently edited first.
  • /rules/{rule_id}/runs shows what each recent run looked at and changed. Tests are not listed.
  • /activity lists every operation Gloriads ran on Amazon: a campaign created or copied, products added, a rule's changes, an undo. A rule's run appears once per marketplace, with the same rule_run_id. tool=rule keeps only the rules'.

How fresh the figures are

  • They are your dashboard's figures, read from the same data with the same code.
  • Performance amounts are in USD. Amazon converts each marketplace's figures.
  • Amazon credits sales several days after the click, so the last days of a period still grow for a while. meta.data_last_date says up to which day the figures go.
  • Campaigns are read from Amazon at most every 30 minutes per marketplace. meta.synced_at says when. On the very first call for a marketplace the list may be empty with meta.syncing: true: call again a minute later.
  • Product figures refresh once a day. A period that starts before the history Gloriads holds returns meta.history_covered: false.
Get started with the APIAuthentication and API keys