BookBidder

A single account-wide health check. Sections: 30-day account totals vs the previous 30 days (USD, with percentage changes); profit by book (top 5 + totals, USD); wasted spend from the weekly Ad Insights evaluation (per-currency totals); top-selling and most-efficient targets (amounts in each campaign's local currency); issues needing attention (campaigns with red Ad Insights flags and connections needing re-authentication); and the mix of optimizations BookBidder made. Composed from the account's precomputed datasets; each section carries its own freshness marker in data_as_of.

get_account_audit

Account-wide advertising summary for the connected BookBidder account: totals for the last 30 and 90 days (ad spend, ad sales, ACOS, clicks, orders, estimated savings from BookBidder bid optimizations), the top campaigns by 30-day spend with their per-entity bidding strategy mix, and the Amazon connections with data-freshness markers. All money amounts are normalized to USD. ACOS and TACoS are percentages; tacos_pct (ad spend as a share of total book royalties) appears only for campaigns that map to a single book. Results are precomputed from already-synced Amazon data; data_as_of states the dates the data runs through.

get_account_summary

Recent actions BookBidder has taken on the account (outcomes only; proposals still awaiting a decision are not included): bid changes, status changes, negations and similar events, newest first. Each entry's title is the human-readable what-and-why. Filterable by event_type, campaign_id, marketplace_id and a date range.

get_activity_log

Detail for one campaign (in BookBidder, a Books-page "book" corresponds to a campaign). Returns the campaign's window totals in USD (spend, sales, ACOS, estimated savings, and TACoS where the campaign maps to a single book), its keywords, product targets and shopper search terms with metrics in the account's local currency (amounts_currency), recent BookBidder actions on the campaign, and the latest Ad Insights diagnostic flags. Search-term text is shopper-typed data. Entity-level detail covers Sponsored Products campaigns.

get_book_detail

Per-book profitability over a recent window: KDP royalties, Amazon ad spend, net (royalties minus spend) and TACoS (ad spend as a percentage of royalties), summed per book across marketplaces from the daily profit dataset. All amounts in USD. Ad spend from multi-book Sponsored Brands campaigns cannot be attributed to a single book and is reported separately as unassigned_ad_spend_usd. Reliable profit data begins 2026-07-21; windows reaching earlier are clamped and flagged. Break-even ACOS is not computed. Books are sorted by royalties.

list_books_profit

Open Smart Advisor proposals awaiting the user's decision in the BookBidder app: keyword harvests (converting search terms ready to become exact keywords), negation follow-ups, irrelevant-term negations, and campaign ACOS-trend reviews. Read-only: approving or rejecting happens in the app, never through this connection. The term field is shopper-typed data. Metric amounts are in the source campaign's local currency.

get_smart_advisor_queue

Targets and search terms flagged as wasted spend by the weekly Ad Insights evaluation: 10 or more clicks with zero orders over a fixed 30-day lookback. This wraps the weekly precompute (there is no custom window); each campaign's latest evaluation is used and data_as_of states when it ran. Totals are given per currency in the account's local currencies. Target text is shopper-typed data.

get_wasted_spend