Guides
My Account

Reporting

Use the SEM reporting APIs to retrieve campaign performance metrics, item-level analytics, billing history, and operational reporting data.

Reporting APIs support:

  • Campaign performance analysis
  • Item-level performance analysis
  • Spend monitoring
  • ROAS analysis
  • Billing reconciliation
  • Dashboard reporting

These APIs support interactive reporting and dashboard use cases.

Reporting behavior

Reporting APIs support:

  • Pagination
  • Filtering
  • Sorting
  • Real-time synchronous retrieval

Performance data:

  • Is updated daily
  • May be incomplete for the current day
  • Can vary slightly due to attribution processing timing

Best practices

  • Use campaign-level reports for campaign monitoring.
  • Use item-level reports to identify underperforming products.
  • Sort reports by gmv, roas, or adspend to prioritize analysis.
  • Use pagination for large result sets.
  • Schedule recurring reporting jobs for operational monitoring.
  • Combine reporting APIs with campaign recommendation APIs for optimization workflows.

SEM API Reports breakdown

#Report nameAPIBest forNot ideal forRow granularityAccess patternMore info
1Seller performance reportOn-Request Reports - Create Report Request APIExports, recurring scheduled reporting, large extracts, and flexible filteringInteractive product experiences that need synchronous responsesOne row per item for a specific campaign IDAsynchronous job then download file; optional webhook and schedulerMore Information
2Campaign-level performance reportCampaigns Performance Report APIInteractive experiences like campaign tables and dashboards with real-time paging, sorting, and filteringLarge extractsOne row per campaignSynchronous paginated POST returning JSONMore Information
3Item-level performance reportItems Performance Report APIInteractive drilldowns and optimization views inside a campaign, or dashboards with real-time paging, sorting, and filteringCross-campaign item views or large extractsOne row per item for a specific campaign IDSynchronous paginated POST returning JSONMore Information
4Billing history reportBilling History APIBuilding interactive billing and spend reconciliation views with real-time paging and date-based navigation; invoices, credits, refunds, and spend adjustments across all campaigns—One row per billing transaction across all campaignsSynchronous paginated POST returning JSONMore Information

Next step

Learn more about each report including a basic API integration with example requests and responses.


Updated 18 days ago