AgentXray

List the Amazon marketplaces on the seller account connected to this AgentXray workspace. Call this FIRST whenever a question needs a marketplace id (Buy Box, inventory age) so you never guess one.

list_my_marketplaces

List the Amazon seller accounts connected to this workspace, with the marketplaces each one covers. An agency has one per client; a single seller has one. Every marketplace-scoped tool takes an 'account' argument naming which of them to answer about, and refuses rather than guessing when several could apply.

list_my_accounts

Every negative keyword on the account, with its campaign and ad group and a self_block flag. self_block means the seller also bids on that exact term in the same ad group — the campaign blocks a keyword it pays for. A negative is invisible by construction, so this list is the only way to see one.

get_ads_negatives

One SKU over time on one marketplace: units per day, the price buyers actually paid after promotions against the listed price, sessions, conversion and Buy Box %, and settled net profit per week. Use it for 'how is this product doing over time', 'did my price change hurt conversion', 'what do buyers really pay'.

get_sku_trend

The seller's Amazon payout balance and why it moved, from Amazon's own settlement lines: what the current settlement started from (negative = still owed to Amazon), what is released and held now, and the last settlements broken into buckets with the posting date of every advertising invoice, debt adjustment and carried balance. Use it for 'why is my balance negative', 'what triggered −X', 'what did Amazon deduct', 'when do I get paid'. Money only — units live in get_inventory_reconciliation.

get_payout_balance

Per-SKU profit ranking for the connected seller account over a window: units, revenue, fees, COGS, net profit and margin per SKU. Use this for 'which product makes money', 'which SKU is losing money', 'what should I stop selling'.

get_profit_by_sku

Real profit and loss for the connected Amazon seller account over a window: revenue, Amazon fees, COGS, net profit and margin, grouped per currency. Numbers come from posted Amazon fee events joined to the seller's own orders and saved product costs, so fees include the consumption tax Amazon actually charged (such as AU GST). Use this for 'what did I actually make', 'was last month profitable', 'what are my fees'.

get_profit_summary

Brands registered to this seller in Amazon Brand Registry, with the brand entity id, as Amazon's Advertising API reports them. Call this before proposing anything brand-gated — Sponsored Brands, A+ Content, Brand Analytics and Vine all require an enrolled brand. An empty list distinguishes 'no brand enrolled' from 'not synced yet'.

get_my_brands

The product costs (COGS) saved in this AgentXray workspace: SKU, marketplace, unit cost, currency and validity dates. Call this when a profit answer depends on whether costs are actually recorded — a SKU with no saved cost is counted at zero cost, which makes profit look better than it is.

get_my_product_costs

Customer search terms that triggered ads, with clicks, orders and spend, the campaign and ad group they came through, and whether each is ALREADY negated. Call this before proposing a negative keyword. Zero orders on single-digit clicks is not evidence of a bad term — it is what a normal conversion rate looks like most of the time.

get_ads_search_terms

Sessions, page views and conversion rate per ASIN from Amazon's Sales & Traffic report, for the connected seller account. This is the metric that separates the two halves of the funnel: clicks with no orders can be a targeting problem OR a detail-page problem, and unit-session percentage is the only field that tells them apart. Conversion is computed from the window's summed units and sessions. Check it before recommending any listing change.

get_traffic_and_conversion

How long one SKU has been in stock on one marketplace and what running out cost: days in stock, out of stock, not launched yet and unknown (no snapshot), each stock-out period, the first receipt, units per day on in-stock days only, and an ESTIMATE of sales lost while out of stock. Use it for 'how long has this been selling', 'how many days was it out of stock', 'what did running out cost'.

get_stock_history

How today is going for the connected Amazon seller account, as ONE short paragraph written to be read aloud: units sold so far today in the store's own time zone, the money Amazon has actually POSTED recently (today's fees do not exist yet — they post 7.5-13 days after purchase), ad spend, and at most two things that need attention. Use this for 'how did today go', 'what happened today', 'give me my morning brief'. The result carries a 'narrative' field that is already composed from measured numbers: read it out word for word and do not recompute, re-round or add numbers of your own.

daily_brief

Top-of-Search impression share and placement stats per campaign, from Amazon's own spCampaigns daily reports: share of eligible top-of-search impressions won, plus top-of-search impressions, clicks and spend against total impressions. Use for visibility questions — why impressions are flat, whether a campaign shows at the top of search. Absence from the result means no report rows in the window, not zero share.

get_ads_placements

UNITS ONLY — says nothing about money, balances or payouts (use get_payout_balance for money). Units Amazon's own Inventory Ledger has not reconciled for one marketplace on the connected seller account, with Amazon's reference id for each row, plus the ledger's event totals in units (receipts, shipments, adjustments). Use this for 'am I missing units', 'is Amazon holding stock it never accounted for'. This reads Amazon's own Unreconciled Quantity column — it does not derive a shortfall from a formula. Requires a marketplace id from list_my_marketplaces.

get_inventory_reconciliation

The honest limits of this account's data, measured live for the connected seller: which SKUs have unrecorded costs (profit overstated), how many recent orders Amazon has not fully posted yet, whether ad spend is invisible, and the structural limits that apply to everyone. Call this BEFORE drawing conclusions from the other tools, and whenever the seller asks how much to trust the numbers.

what_i_cannot_tell_you

What to reorder, how much, by when and from whom, per SKU: stock (Amazon's, or the seller's own shelf for merchant-fulfilled listings), the 30-day sales rate, days until it runs out, the lead time used and where it came from, the supplier and their minimum order. Use it for 'what should I reorder' and 'when do I run out'.

get_reorder_plan

Changes applied through AgentXray and where each stands in its proof: the 14-day net-contribution verdict, or status 'measuring' when the window has not matured. Use before claiming a past change worked.

get_my_changes