Epinium

Product ads of the authenticated account — the link between an ad group and the product it advertises. Filter by `campaign`, `adGroup`, `product`, `asin` or `state`. Fetches a single product ad by its id. Related records can be inlined with `expand`: connection, country, campaign, adGroup, product (nested paths like `connection.country` also work).

epinium_get_product_ad

Brands present in the authenticated account's catalog, scoped to it: brands belonging only to other Epinium customers are never returned, and `epinium_get_product_brand` answers 404 for a brand absent from this catalog. This is the brand-name entity referenced by a product's `brand` field, not the brand-identity feature of the Epinium app. Fetches a single product brand by its id.

epinium_get_product_brand

Search terms the authenticated account's ads were served on — the actual shopper queries, as opposed to the targets that matched them. Filter by `campaign`, `adGroup` or `searchTerm`. Fetches a single search term by its id. Related records can be inlined with `expand`: connection, country, campaign, adGroup (nested paths like `connection.country` also work).

epinium_get_search_term

Validated marketing playbooks for brands and manufacturers: each one carries the method, formulas, thresholds and red flags for a single job. Covers Amazon and Walmart advertising (bids, Max CPC, breakeven and target ACoS, ROAS, budget allocation, search-term harvesting, negative keywords, Sponsored Products/Brands/Display, DSP, dayparting, cannibalization), marketplace and listing work (ASIN listings, A+ brand content, variation families, Buy Box, review mining, FBA restock and reimbursements, aged inventory, GPSR compliance), Google, Meta, TikTok and Criteo ads, Shopify, WooCommerce and Magento stores, and SEO, content, email/CRM, social, influencer, affiliate, PR, creative, analytics and brand strategy. Filter by `integration` (amazon, google, shopify…) or `division`. Read the relevant skill before advising on one of these areas: it carries the margin math, cadence and failure modes that generic advice gets wrong. A skill is listed even when the account lacks the connection it needs — read it to find out what to connect. Fetches a single skill by its id.

epinium_get_skill

Advertising targets (keywords and product targets) of the authenticated account. Filter by `campaign` or `adGroup` to drill down, and by `targetType`, `state` or `negative` to separate positive targeting from negatives. Fetches a single target by its id. Related records can be inlined with `expand`: connection, country, campaign, adGroup (nested paths like `connection.country` also work).

epinium_get_target

Epinium tasks of the authenticated account: containers of suggested changes over products, campaigns or targets, created manually, by the AI chat or by a workflow. Filter by `status` or `priority`. NOTE: these are Epinium's own tasks, unrelated to the MCP `tasks` protocol extension for long-running operations. Fetches a single task by its id.

epinium_get_task

Individual suggestions inside an Epinium task: the entity they touch, the problem detected, the current value and the suggested one. Filter by `task` to read one task's suggestions, or by `entityModel` / `status`. Fetches a single task item by its id. Related records can be inlined with `expand`: task (nested paths like `connection.country` also work).

epinium_get_task_item

Automation workflows of the authenticated account — the rules that adjust bids, budgets, keywords and negatives on the campaigns they process, every night. Use `epinium_get_workflow` to audit what one is configured to do: it returns the schedule, the node graph, and every configuration variable with its effective value, flagging which ones the customer overrode versus which still carry the template default. Tell workflow types apart by `description_key`, NOT by `name` — several templates share a display name. Note that `schedule.last_run_at` advances even when a run was skipped (inactive account, missing tokens), so a recent timestamp is not proof that work happened. Fetches a single workflow by its id.

epinium_get_workflow

Advertising performance per ad group: spend, sales, ACOS, ROAS, clicks and impressions over a date range. One level below `campaign_metrics` — use it to find which ad groups inside a campaign carry the spend. `start_date` and `end_date` are REQUIRED. Use `order_by` (cost, sales, acos…) with `limit` to get a top-N directly instead of paging through everything. Monetary amounts are decimal strings; ratios are fractions (0.16 = 16%). Returns an offset-paginated list, with no cursor: page by advancing `offset` by `limit` while `has_more` is true.

epinium_list_adgroup_metrics

Ad groups of the authenticated account's advertising campaigns. Filter by `campaign` to drill down from a campaign, or by `connection`, `country` or `state`. Returns a cursor-paginated list; follow `has_more` with `starting_after` to page. Related records can be inlined with `expand`: connection, country, campaign (nested paths like `connection.country` also work).

epinium_list_adgroups

Amazon Advertising products of the authenticated account — the catalog as the Advertising API sees it. Use it when relating advertising entities back to a product. Filter by `connection`, `country`, `brand` or `asin`. Returns a cursor-paginated list; follow `has_more` with `starting_after` to page. Related records can be inlined with `expand`: connection, country, brand (nested paths like `connection.country` also work).

epinium_list_amazon_advertising_products

Amazon Seller Central listings of the authenticated account. Use it instead of `products` when the question is specifically about Seller Central data. Filter by `connection`, `country`, `brand` or `asin`. Returns a cursor-paginated list; follow `has_more` with `starting_after` to page. Related records can be inlined with `expand`: connection, country, brand (nested paths like `connection.country` also work). Large raw payloads are omitted by default to keep responses small; request them explicitly with `expand`: sellerCentralInfo, catalogPublicInfo, pricing, buyboxB2C, buyboxB2B, fbaInventory, aplusContent, competitivePriceSummary, suppressed, fbaLocalStock.

epinium_list_amazon_seller_products

Amazon Vendor Central listings of the authenticated account. Use it instead of `products` when the question is specifically about Vendor Central data. Filter by `connection`, `country`, `brand` or `asin`. Returns a cursor-paginated list; follow `has_more` with `starting_after` to page. Related records can be inlined with `expand`: connection, country, brand (nested paths like `connection.country` also work). Large raw payloads are omitted by default to keep responses small; request them explicitly with `expand`: vendorCentralInfo, catalogPublicInfo, aplusContent, inventory.

epinium_list_amazon_vendor_products

Advertising performance per campaign: spend, sales, ACOS, ROAS, clicks and impressions over a date range. Answers "how much am I spending per campaign?" and "which campaigns have the worst ACOS?". `start_date` and `end_date` are REQUIRED. Use `order_by` (cost, sales, acos…) with `limit` to get a top-N directly instead of paging through everything. Monetary amounts are decimal strings; ratios are fractions (0.16 = 16%). Returns an offset-paginated list, with no cursor: page by advancing `offset` by `limit` while `has_more` is true.

epinium_list_campaign_metrics

Amazon Advertising campaigns of the authenticated account. The top of the advertising hierarchy: campaign → ad group → target / product ad. Each campaign carries its daily or lifetime budget with the currency, and — for Sponsored Products — its dynamic bidding strategy: fixed (`MANUAL`), down-only (`LEGACY_FOR_SALES`) or up-and-down (`AUTO_FOR_SALES`). Read it before proposing bid changes: up-and-down lets Amazon raise the bid, so real spend runs above the base bid. Sponsored Brands and Display have no bidding strategy and return null. Filter by `connection`, `country` or `state`. Returns a cursor-paginated list; follow `has_more` with `starting_after` to page. Related records can be inlined with `expand`: connection, country (nested paths like `connection.country` also work).

epinium_list_campaigns

Keyword clusters of the authenticated account — groups of products that share a keyword strategy, used by Epinium's SEO and advertising tooling. By default each cluster returns `productCount` only; add `expand[]=products` to get the product ids (or the full product objects). Returns a cursor-paginated list; follow `has_more` with `starting_after` to page. Related records can be inlined with `expand`: products (nested paths like `connection.country` also work).

epinium_list_clusters

Data source connections of the authenticated account. Each connection links Epinium to one Amazon Seller Central, Vendor Central or Advertising account for a set of marketplaces. Start here: almost every other resource filters by `connection`, and this is how you learn which ids exist. Returns a cursor-paginated list; follow `has_more` with `starting_after` to page. Related records can be inlined with `expand`: countries (nested paths like `connection.country` also work).

epinium_list_connections

Amazon marketplace countries (ISO 3166 code plus the Amazon marketplace id). A global reference table, identical for every account — use it to resolve the `country` ids the other resources return. Filter by `code`. Returns a cursor-paginated list; follow `has_more` with `starting_after` to page.

epinium_list_countries

Advertising performance per product ad: spend, sales, ACOS, ROAS, clicks and impressions over a date range, with the ASIN of the advertised product. Answers "which of my advertised products actually convert?". Only Sponsored Products and Sponsored Display have product ads, so `ad_product` accepts SP and SD only. `start_date` and `end_date` are REQUIRED. Use `order_by` (cost, sales, acos…) with `limit` to get a top-N directly. Monetary amounts are decimal strings; ratios are fractions (0.16 = 16%). Returns an offset-paginated list, with no cursor: page by advancing `offset` by `limit` while `has_more` is true.

epinium_list_product_ad_metrics

Product ads of the authenticated account — the link between an ad group and the product it advertises. Filter by `campaign`, `adGroup`, `product`, `asin` or `state`. Returns a cursor-paginated list; follow `has_more` with `starting_after` to page. Related records can be inlined with `expand`: connection, country, campaign, adGroup, product (nested paths like `connection.country` also work).

epinium_list_product_ads

Brands present in the authenticated account's catalog, scoped to it: brands belonging only to other Epinium customers are never returned, and `epinium_get_product_brand` answers 404 for a brand absent from this catalog. This is the brand-name entity referenced by a product's `brand` field, not the brand-identity feature of the Epinium app. Returns a cursor-paginated list; follow `has_more` with `starting_after` to page.

epinium_list_product_brands

Catalog products of the authenticated account — Epinium's unified product entity, which merges the seller, vendor and advertising views of the same ASIN. This is the right resource for general catalog questions. Each product also carries its barcodes (EAN, UPC, GTIN), so this is where you find duplicate listings that share a product identifier. Filter by `connection`, `country`, `brand` or `asin`. Returns a cursor-paginated list; follow `has_more` with `starting_after` to page. Related records can be inlined with `expand`: connection, country, brand (nested paths like `connection.country` also work).

epinium_list_products

Advertising performance per shopper search term, with the actual query text resolved from the catalog into `query` — the text is NOT in the report store at all. Answers "which searches do I spend most on?" and is the input for harvest and negative-keyword decisions; rows are grouped per search term AND target, because the same text can be matched by different targets. Only Sponsored Products and Sponsored Brands produce search terms, so `ad_product` accepts SP and SB only. `start_date` and `end_date` are REQUIRED, and this is the heaviest resource in the API: window capped at 93 days for granularity=total, 31 for daily. Use `order_by=cost` with `limit` instead of paging. Returns an offset-paginated list, with no cursor: page by advancing `offset` by `limit` while `has_more` is true.

epinium_list_search_term_metrics

Search terms the authenticated account's ads were served on — the actual shopper queries, as opposed to the targets that matched them. Filter by `campaign`, `adGroup` or `searchTerm`. Returns a cursor-paginated list; follow `has_more` with `starting_after` to page. Related records can be inlined with `expand`: connection, country, campaign, adGroup (nested paths like `connection.country` also work).

epinium_list_search_terms

Seller Central sales and traffic per product over a date range: sales, units, orders, sessions, page views, buy box percentage, conversion rate and Best Seller Rank. Answers "which of my products sell the most?" and "which ones get traffic but do not convert?" — use `amazon_seller_products` instead for the listing itself (title, price, stock), which carries no performance history. `start_date` and `end_date` are REQUIRED. Use `order_by` (sales, units, orders, sessions, page_views, rank, conversion_rate) with `limit` to get a top-N directly instead of paging through the whole catalog. Rows are grouped by ASIN + SKU + connection + country + currency. Monetary amounts are decimal strings; `conversion_rate` is a fraction of orders per session (0.29 = 29%) and `buy_box_percentage` is 0-100. `sessions`, `page_views`, `buy_box_percentage`, `conversion_rate` and `rank` come back as `null` — never `0` — when Amazon did not report them for that product and day. Returns an offset-paginated list, with no cursor: page by advancing `offset` by `limit` while `has_more` is true.

epinium_list_seller_product_metrics

Validated marketing playbooks for brands and manufacturers: each one carries the method, formulas, thresholds and red flags for a single job. Covers Amazon and Walmart advertising (bids, Max CPC, breakeven and target ACoS, ROAS, budget allocation, search-term harvesting, negative keywords, Sponsored Products/Brands/Display, DSP, dayparting, cannibalization), marketplace and listing work (ASIN listings, A+ brand content, variation families, Buy Box, review mining, FBA restock and reimbursements, aged inventory, GPSR compliance), Google, Meta, TikTok and Criteo ads, Shopify, WooCommerce and Magento stores, and SEO, content, email/CRM, social, influencer, affiliate, PR, creative, analytics and brand strategy. Filter by `integration` (amazon, google, shopify…) or `division`. Read the relevant skill before advising on one of these areas: it carries the margin math, cadence and failure modes that generic advice gets wrong. A skill is listed even when the account lacks the connection it needs — read it to find out what to connect. Returns a list; `has_more` tells whether another page follows.

epinium_list_skills

Advertising performance per target, with the target type and keyword resolved from the catalog. Answers "which keywords waste my budget?" — ClickHouse alone cannot tell you, because the keyword text is only reliable in the catalog. `start_date` and `end_date` are REQUIRED, and this resource has a SHORTER window cap than the others: 93 days for granularity=total, 31 for daily. Use `order_by` (cost, sales, acos…) with `limit` to get a top-N directly. Monetary amounts are decimal strings; ratios are fractions (0.16 = 16%). Returns an offset-paginated list, with no cursor: page by advancing `offset` by `limit` while `has_more` is true.

epinium_list_target_metrics

Advertising targets (keywords and product targets) of the authenticated account. Filter by `campaign` or `adGroup` to drill down, and by `targetType`, `state` or `negative` to separate positive targeting from negatives. Returns a cursor-paginated list; follow `has_more` with `starting_after` to page. Related records can be inlined with `expand`: connection, country, campaign, adGroup (nested paths like `connection.country` also work).

epinium_list_targets

Individual suggestions inside an Epinium task: the entity they touch, the problem detected, the current value and the suggested one. Filter by `task` to read one task's suggestions, or by `entityModel` / `status`. Returns a cursor-paginated list; follow `has_more` with `starting_after` to page. Related records can be inlined with `expand`: task (nested paths like `connection.country` also work).

epinium_list_task_items

Epinium tasks of the authenticated account: containers of suggested changes over products, campaigns or targets, created manually, by the AI chat or by a workflow. Filter by `status` or `priority`. NOTE: these are Epinium's own tasks, unrelated to the MCP `tasks` protocol extension for long-running operations. Returns a cursor-paginated list; follow `has_more` with `starting_after` to page.

epinium_list_tasks

The campaigns a workflow actually processes, with the AI configuration each one carries (objective and its target value, bid limits, budget, whether AI actions are enabled, and since when it has really been optimized). This is NOT simply the campaigns linked to the workflow: membership is decided by three controls stored per campaign (force-include, force-exclude, global opt-out) combined with the workflow's own filter and its auto-selection setting, so every row carries a `gate` object saying why it is in. When the set comes back empty, `empty_reason` names the cause — `manual-sin-enlaces` means the workflow is on manual selection with nothing linked, which is the state a workflow is BORN in and the usual reason one runs nightly for weeks doing nothing; `filtro-vacio` means no campaign passes its own filter; `no-itera-campanas` means this workflow does not act on campaigns at all.

epinium_list_workflow_campaigns

Vendor Central sales per product over a date range. There is deliberately NO single `sales` or `orders` field: Vendor Central has two business models and Amazon does not report them symmetrically, so read the pair that matches how you sell. **Manufacturing** (Amazon makes the product under licence) reports `manufacturing_ordered_sales`/`_units`, `manufacturing_shipped_sales`/`_units`/`_cogs` and `manufacturing_net_received_sales`/`_units`. **Sourcing** (you sell wholesale to Amazon) reports only the shipped and net received pairs — Amazon publishes no sourcing ordered figures. Do not assume "sales" means sourcing shipped: a manufacturing vendor would read zeros. Also returns `units` (total ordered units, no model breakdown), `glance_views`, `rank` and the two `*_sellable_units` — which are the LATEST inventory snapshot in the window, not a sum. Vendor has no sessions and no conversion rate at all; use `amazon_vendor_products` for the listing itself (title, price, stock), which carries no performance history. `start_date` and `end_date` are REQUIRED. Use `order_by` with `limit` to get a top-N directly instead of paging through the whole catalog. Rows are grouped by ASIN + connection + country + currency (the SKU is not part of the key here, unlike `seller_product_metrics`). Monetary amounts are decimal strings. `glance_views`, `rank` and both `*_sellable_units` come back as `null` — never `0` — when Amazon did not report them. Returns an offset-paginated list, with no cursor: page by advancing `offset` by `limit` while `has_more` is true.

epinium_list_vendor_product_metrics

Automation workflows of the authenticated account — the rules that adjust bids, budgets, keywords and negatives on the campaigns they process, every night. Use `epinium_get_workflow` to audit what one is configured to do: it returns the schedule, the node graph, and every configuration variable with its effective value, flagging which ones the customer overrode versus which still carry the template default. Tell workflow types apart by `description_key`, NOT by `name` — several templates share a display name. Note that `schedule.last_run_at` advances even when a run was skipped (inactive account, missing tokens), so a recent timestamp is not proof that work happened. Returns a cursor-paginated list; follow `has_more` with `starting_after` to page.

epinium_list_workflows

Advertising results of the campaigns a workflow processes, over a required `start_date`/`end_date` window. This is how you judge whether a workflow is working: each row puts the configured `objective_type`/`objective_value` next to the realized ACOS, ROAS, spend, orders and conversion rate, so the target and the outcome can be compared directly. `optimizing_since` is when the workflow first touched that campaign for real — results before that date are NOT its doing, so a window straddling it will mislead you. Monetary amounts are decimal strings; ratios are fractions (0.1642 = 16.42%) and are `null`, never `0`, when their denominator is zero.

epinium_get_workflow_performance