Tools Reference

Search Titan Network training content and lessons.

Search community discussions and member insights.

Get teaching frameworks. Slugs: plog (Product Launch Optimization), ppc_3_0 (PPC 3.0 tactics), states_and_drivers (posture matrix).

List linked Amazon stores in the active Titan Tools account.

Activate a store by name; pass marketplace if duplicate names.

Revenue, orders, units, margins, CM1/CM2/CM3.

PPC totals: spend, sales, ACoS, ROAS.

PPC by campaign. Filters: campaignIds, asins, adType. Response includes matchType, tags, outOfBudget, avgDailySpend per campaign (2026-05).

Connected Amazon marketplaces.

Seller brands.

Amazon data-sync (backfill) progress for the active seller — why data may look empty or partial. Reports tracked plus, only when tracked, an overall percent and per-lane SP / Ads progress. An untracked result means UNKNOWN, not 0%: that is the normal shape for an established account whose backfill predates upstream lifecycle tracking, and its data should be treated as complete. Takes no arguments.

Search by name, ASIN, or SKU.

Full product list with metrics (paginated, needs dates).

Metrics for specific ASINs (needs dates).

PPC data by product (needs dates).

Best Seller Rank HISTORY for one ASIN — main-category and per-subcategory rank time series, for questions about rank movement and seasonality. Points are event-based, not daily, and a subcategory can return an empty series while its siblings are populated. Ranks are not comparable across marketplaces. For the current rank only, search_for_products and get_products_summary already carry a salesRanks snapshot for free. Span capped at 365 days.

Performance by portfolio.

Performance by product ad.

Performance by keyword/target.

Performance by placement (SP only). Server-side filters: asins (2026-05; narrows per-placement metrics), campaignIds (server-side filter, verified 2026-07-30; narrows the aggregate only, since the response is grouped by placement classification and carries no campaignId, so per-campaign numbers need one call per campaign).

Performance by search term (SP only). Server-side filters: campaignIds, asins (both 2026-05).

Hour-of-day or weekday breakdown of whole-account PPC (Amazon Marketing Stream — SP+SB+SD, SP=7d/SB+SD=14d attribution, bucketed by conversion hour). Available for all regions where the seller is subscribed to AMS via Amazon Ads. Required: groupBy ('hour' or 'day'). Server-side filters: campaignIds, portfolioIds, asins (AND across fields — intersection; OR within array). Near-real-time — endDate can be today (no 2-day lag). Hours in the seller's account-level local timezone (US→PT, DE→CET, UK→GMT/BST). Currency: pass any ISO code; conversion server-side via daily mid-rate at UTC midnight. ⚠ All-zero ≠ no ads — most often deliberate operator dayparting, NOT budget exhaustion; ask the operator before recommending changes; cross-verify with get_account_ppc_metrics.

Brand Analytics Search Query Performance by (ASIN, ISO week). Data horizon 2026-W15+; SP-only.

Find campaigns by name. Each response item carries a state field — filter client-side for enabled/paused/archived (upstream rejects a status request param with 400 as of 2026-05-15). Response includes matchType + tags per campaign (2026-05).

List portfolios.

List ad groups.

List product ads.

List keywords/targets.

List ad-group-level negative keywords. Campaign-level negatives are not returned by this route.

List existing negative targets (Live API). Required scope: 'sp_campaign' / 'sp_ad_group' / 'sb_ad_group'. Use before pause/archive flows so you have real targetIds.

PPC modification audit trail.

List campaigns LIVE with serving status / last-update / creation date (SP/SB/SD). Heavy throttle cost — the persisted creationDate on search_for_ppc_campaigns is free.

List ad groups LIVE from the Amazon Ads API (SP/SB/SD). Heavy throttle cost — prefer get_ppc_ad_groups.

List keywords LIVE from the Amazon Ads API (SP only). Heavy throttle cost — prefer get_ppc_targets.

List targets LIVE from the Amazon Ads API (SP/SD — SB target lists are not available upstream). Heavy throttle cost.

List product ads LIVE at AD-GROUP level (SP/SB/SD). Heavy throttle cost — prefer get_ppc_product_ads. Carries no ad creative; for Sponsored Brands creative use get_live_sb_ads.

List portfolios LIVE from the Amazon Ads API (SP only). Heavy throttle cost — prefer get_ppc_portfolios.

List negative keywords LIVE (SP). level:'campaign' is the ONLY read of campaign-level negatives anywhere — get_ppc_negative_keywords is ad-group-level only.

List Sponsored Brands ads at CAMPAIGN level LIVE. The only read of SB ad CREATIVE anywhere: headline copy, brand name and logo, Store subpages, and the landing page each ad sends traffic to, plus servingStatus. NOT the same list as get_live_product_ads with adType SB, which is ad-group-level and carries no creative. Server-side filters: campaignIds, adIds, statuses. Heavy throttle cost.

Tracked-keyword rank table for an ASIN. Each row: keywordRankTrackerId, phrase, organicRank/sponsoredRank (null when not ranking; read isOrganicRanked/isSponsoredRanked), searchVolume + searchVolumeRaw, label/tags. Filter (search/labelId), sort, paginate.

Per-day rank history for one tracked keyword by keywordRankTrackerId. The startDate→endDate span must be ≤ 360 days.

Keyword tracking limit / tracked count / remaining slots for an ASIN.

Account-scoped keyword labels ({ labelId, label, color, order }).

Tags on an ASIN's tracked keywords, with per-tag counts.

Keyword segments for an ASIN — named groupings ({ segmentId, name, type, keywordRankTrackerIds[], keywordCount }). A MASTER_SET can hold ~2,000 ids; summarize rather than dump.

Member-authored notes on one tracked keyword, by keywordRankTrackerId. Comments are operator-truth — cite verbatim. An unknown/foreign id returns a 404, not an empty list.

Keyword Relevancy table for an ASIN via the Titan Tools dashboard API. Use FIRST for relevance questions (do not infer from PPC search terms). Populated searchVolume, 0-9 relevancy, per-competitor ASIN/brand/rank, phraseUrl; paginated + sortable + dataset picker. Optional ppcCheck adds inPpc/adTypes/matchTypes.

Keyword families (root-phrase groupings) for a relevancy dataset. familyId is an opaque string; the page total is the KEYWORD count, NOT the family count.

Member keywords of one family, by datasetId + the string familyId.

Poll a relevancy dataset's ranking-recompute status ({ ongoing }). Use after propose_relevancy_ranking_update.

Latest completed PPC Audit metadata + a 5-minute presigned download URL. Click to download the xlsx; the audit data is not inline.

Generate a downloadable report file (CSV/XLSX), one-off or on a recurring schedule. 7 report types (DASHBOARD_METRICS, DASHBOARD_PROFIT_AND_LOSS_METRICS, DST_METRICS, PPC_AUDIT, PPC_SEARCH_TERM, PPC_CAMPAIGNS, SEARCH_QUERY_PERFORMANCE), each accepting only certain dateRangeType values. marketplaces are storefront URLs (e.g. Amazon.com), not IDs. Recurring reports can't be listed/edited/deleted via the API — confirm the schedule first.

Single-shot poll for a report's status and download link. DONE → a downloadUrl that opens with no Titan Tools login (do not fetch it yourself); IN_PROGRESS → call again in ~5-25s; NO_DATA_AVAILABLE / FAILED / CANCELLED / DELETED handled per status.

Generate a raw Amazon SP-API report file on demand. 15 report types across sales and traffic, orders, returns, listings, FBA inventory, inventory ledger, fees, and reimbursements. Async: returns a reportId; poll get_live_report for the link. Files are deleted 24 hours after generation. marketplace is a single storefront URL (e.g. Amazon.com), not an ID.

Single-shot poll for a live report's status and download link. DONE with ready:true → a downloadUrl that opens with no Titan Tools login but stops working 24 hours after generation (do not fetch it yourself); DONE with ready:false and reason NO_DATA_ROWS → the file generated with column headers only, so no link is handed over; IN_PROGRESS → poll again (most reports take ~5 minutes); CANCELLED → Amazon had no data, not an error; FAILED / DELETED → create a new report.

List Amazon Warehousing & Distribution (AWD) inventory per SKU: totalOnhandQuantity (in the AWD warehouse), totalInboundQuantity (en route to AWD), and a per-SKU availableDistributable / replenishment / reserved breakdown. Returns Amazon's payload verbatim incl. nextToken (caller-driven pagination). An empty list means enrolled-but-no-stock, not 'no AWD'.

List shipments en route to the AWD warehouses, filterable by shipmentStatus (CREATED/SHIPPED/IN_TRANSIT/RECEIVING/DELIVERED/CLOSED/CANCELLED) and update window. Returns Amazon's payload verbatim incl. nextToken.

List AWD → FBA replenishment orders, including eligibleProducts, outboundShipments, and distributionIneligibleReasons (e.g. NO_NETWORK_INVENTORY_RESERVED). Returns Amazon's payload verbatim incl. nextToken.

Create SP portfolios.

Update SP portfolios.

Create SP campaigns.

Pause, update budget, update name, or update schedule.

Add campaign-level negative keywords.

Create SP ad groups.

Pause, change default bid, or change name.

Add keywords.

Pause or change bid.

Add ad-group-level negative keywords.

Add product/category targets.

Update targets (state, bid) — ASIN/category only; keywords go through propose_update_sp_keyword.

Create new product ads.

Pause or change state.

Update Sponsored Brands campaigns.

Update Sponsored Brands ad groups.

Update Sponsored Brands ads.

Update Sponsored Brands keywords.

Update Sponsored Brands targets (requires targetId, adGroupId, and campaignId).

Add Sponsored Brands ad-group-level negative keywords.

Pause, un-pause, or archive existing campaign-level negative keywords. State-only update.

Pause, un-pause, or archive existing ad-group-level negative keywords. State-only update.

Pause, un-pause, or archive existing Sponsored Brands ad-group negative keywords. Lowercase state values; each item must include keywordId, adGroupId, and campaignId.

Add campaign-level negative targets — block competitor ASINs or brands.

Pause, un-pause, or archive existing campaign-level negative targets. State-only update.

Add ad-group-level negative targets — block competitor ASINs or brands at the ad-group level.

Pause, un-pause, or archive existing ad-group-level negative targets. State-only update.

Add Sponsored Brands ad-group-level negative targets. CamelCase expression types (asinSameAs / asinBrandSameAs); body uses `expressions` (plural, NOT `expression`).

Pause, un-pause, or archive existing Sponsored Brands ad-group negative targets. Lowercase state values; each item must include targetId and adGroupId.

Update Sponsored Display campaigns.

Update Sponsored Display ad groups.

Update Sponsored Display product ads.

Update Sponsored Display targets.

Get Amazon's suggested bids (no writes).

Create a Keyword Relevancy dataset (account:write — Titan Tools datasets, NOT Amazon Ads). No dry-run, no delete — permanent. Returns numeric datasetId.

Add 1-10 competitor ASINs to a Keyword Relevancy dataset (by dataSetId).

Remove 1-10 ASINs from a Keyword Relevancy dataset (by dataSetId).

Set cost of goods for 1-500 SKUs — a Titan product-record write, NOT Amazon Ads. No dry-run and NOT reversible: there is no COGS read endpoint, so a previous cost structure cannot be restored. Drives CM1/CM2/CM3. isAllMarketplace true writes every marketplace (salesChannel must be omitted); false requires salesChannel. type PERIOD takes 1..N {element, amount, units ≥ 1}; type CONSTANT takes exactly one {amount}. Omitting startDate rewrites all history for that SKU. Partial success — results[] comes back in request order and an all-failed batch still returns HTTP 200.