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.

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).

Performance by portfolio.

Performance by product ad.

Performance by keyword/target.

Performance by placement (SP only). Server-side filter: asins (2026-05; narrows per-placement metrics).

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 negative keywords.

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.

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.

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).