A REST API for your Amazon Ads & Seller Central data

Bearer-token authenticated. Bulk CSV or JSON exports up to 100,000 rows per call, delivered via presigned S3. Feed your dashboards, data warehouse, or custom app — no Amazon developer registration, no async report polling.

Bearer-token auth CSV / JSON to S3 100k rows / call
Daily Export — One Curl Call
# Daily SKU-level sales & traffic export
curl -X POST https://app.marketplaceadpros.com/api/v1/reports/export/ \
  -H "Authorization: Bearer $MAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "...",
    "report_type": "sp_sales_traffic",
    "date_start": "2026-05-17",
    "date_end": "2026-06-16",
    "format": "csv"
  }'
presigned S3 URL · row_count: 3,890 · 1h expiry

Skip the Amazon API plumbing

A daily dashboard for 130 SKUs should not require writing a polling loop.

Direct against Amazon

  • Apply for the Amazon Ads & SP-API developer programs
  • Manage LWA OAuth tokens and refresh cycles
  • Schedule async report jobs and poll for completion
  • Different shapes per report type and ad product
  • Per-endpoint rate limits and retry logic
  • Hand-roll a normalization layer before it's queryable

Through the MAP Developer API

  • Connect once via OAuth in the app, generate an API key
  • Plain HTTPS + Authorization: Bearer — works from any language
  • Pre-ingested data — exports are instant, no polling
  • Normalized columns across SP, SB, SD, DSP, Facebook, SP-API
  • MAP absorbs rate limits and Amazon's report restatements
  • Schema introspection so your tooling can auto-discover columns

Two ways to talk to your data

Pick the one that matches what you're building.

Developer REST API You're here

Bearer-token HTTPS. Bulk CSV / JSON exports, schema introspection, resource CRUD. For dashboards, data warehouses, BI tools, and custom apps.

  • Cron jobs, Airflow / Dagster, dbt
  • Snowflake / BigQuery / Redshift loaders
  • Internal dashboards (Metabase, Looker, Sheets)
  • Custom backend services

MCP Server

Same data, conversational surface. For natural-language queries through Claude, ChatGPT, n8n, or any MCP-compatible AI client.

  • "Show me last week's wasted spend"
  • n8n workflows and AI agents
  • Claude / ChatGPT desktop chat
See the MCP surface

What's in the API

Everything is namespaced under /api/v1/. All endpoints are scoped to the account that owns the key.

POST

/reports/export/

Filtered CSV or JSON export of any report type, delivered as a 1-hour presigned S3 URL. Up to 100,000 rows per call. Column projection and date filters supported.

GET

/reports/schema/…

Columns, sample rows, row count, observed date range, and human-readable column_notes — auto-discover the shape of every report.

GET

/profiles/…/report-status/

Per-report freshness: last successful pull timestamp, requested date window, status. Poll cheaply before exporting.

GET

/brands/ · /integrations/ · /profiles/

Walk the account graph: brands, integrations across platforms, and the profiles inside each. Filter by brand or platform.

GET / POST / PUT

/resources/…

List, create, and update campaigns, ad groups, keywords, product ads, targets, and brand assets — across Sponsored Products, Brands, and Display. Audit-tracked in a ChangeSet.

POST

/profiles/…/budget-recommendations/

Live Amazon Ads budget recs including percent_time_in_budget and estimated missed sales — works for SP, SB, and SD.

POST

/profiles/…/product-metadata/

Live ASIN metadata from Amazon Ads — title, brand, category, BSR, price, image, eligibility, variations.

POST

/profiles/…/request-review/

Send Amazon's official Request a Review email per order, with an eligibility pre-check baked in. Seller accounts only.

GET

/profiles/…/report-types/

Enumerate every report type a profile supports and whether each has data available right now.

Every report, one surface

All ad platforms and Selling Partner reports, normalized and pre-ingested.

Amazon Ads

Sponsored Products, Brands, Display — campaigns, keywords, search terms, product ads, purchased products, placements.

Amazon DSP

Campaign performance for DSP advertisers under agency profiles. Hourly traffic, conversions, audience reach.

Seller Central

Orders, sales & traffic, FBA inventory, settlements, returns, listings, Brand Analytics, Search Query Performance.

Vendor Central

Vendor sales, inventory, traffic, forecasting, and net PPM — automatically routed for vendor accounts.

Facebook Ads

Daily platform, audience demographics, geo demographics, and creative performance.

Amazon Marketing Stream

Near-real-time hourly SP traffic, conversions, and budget usage — for profiles with AMS enabled.

Brand Analytics

Market basket, repeat purchase, search terms, search query performance, search catalog performance.

More platforms

LinkedIn Ads integration is wired into the same brand and profile graph; TikTok exposed via the MCP surface today.

Hourly data, half-open ranges

Amazon Marketing Stream gives you SP traffic, conversion, and budget-usage data within minutes of the hour closing — the same export endpoint accepts ISO 8601 timestamps so you can chain non-overlapping windows.

Restatements are handled automatically: when Amazon revises a past hour, the API always serves the latest merged version. More on Amazon Marketing Stream →

Two-hour AMS window
curl -X POST .../api/v1/reports/export/ \
  -H "Authorization: Bearer $KEY" \
  -d '{
    "profile_id": "...",
    "report_type": "ams_sp_traffic",
    "date_start": "2026-06-16T14:00:00Z",
    "date_end":   "2026-06-16T16:00:00Z"
  }'

How It Works

1

Connect

Sign up and authorize Amazon Ads + Selling Partner through OAuth. Takes a couple of minutes.

2

Generate a key

Create a custom-read or custom-read-write API key on the Integrations page.

3

Discover the shape

Use the schema endpoint to enumerate columns and date ranges so your tooling can auto-configure.

4

Export on a schedule

Pull CSV or JSON via the export endpoint — feed BigQuery, Snowflake, Sheets, or whatever already runs your dashboards.

Auth, scoping, and rate limits

Bearer tokens

Authorization: Bearer <api_key>. Keys are SHA-512 hashed at rest and scoped to a single account. Two scopes: custom-read for read-only access, custom-read-write to unlock resource CRUD and Request-a-Review.

Brand-scoped access

Endpoints are filtered to enabled brands in the account that owns the key. Disabled brands and their profiles are invisible — useful for delegating per-client access in an agency without exposing the full portfolio.

Rate limits

100 req/min across all endpoints. 10 req/min on /reports/export/. 30 req/min on resource writes and Request-a-Review. Throttles are keyed per API token, not per IP.

Frequently Asked Questions

The MCP server is for AI clients — Claude, ChatGPT, n8n — where queries are conversational. The Developer REST API is for engineers and BI teams that want plain HTTP, Bearer-token auth, and bulk CSV or JSON exports to feed into dashboards, data warehouses, or custom apps. Same underlying data, different access surface.

Each call to POST /api/v1/reports/export/ can return up to 100,000 rows in a single CSV or JSON file, delivered via a presigned S3 URL. Responses always include a truncated flag so you can detect when the limit was hit and either narrow the date window or page across calls.

No. Marketplace Ad Pros handles the Amazon Ads API and Selling Partner API integrations end-to-end — OAuth, token rotation, rate limits, async report polling, version differences across SP, SB, SD, and DSP. You connect your accounts once and pull normalized data through one REST surface.

All Amazon Ads daily reports (Sponsored Products, Brands, Display), Amazon DSP campaign performance, Facebook Ads, and Selling Partner reports (orders, FBA inventory, settlement, returns, sales & traffic, Brand Analytics, Search Query Performance, Vendor Central). Amazon Marketing Stream hourly data is also available for profiles with AMS enabled.

Yes. Resource CRUD endpoints support creating and updating Sponsored Products, Sponsored Brands, and Sponsored Display campaigns, ad groups, keywords, product ads, targets, negative targets, and brand assets. Write operations require a custom-read-write API key and are tracked in a ChangeSet for audit.

100 requests per minute across all endpoints, 10 requests per minute on the export endpoint, and 30 requests per minute on resource writes — all keyed per API token.

Build on your Amazon data

Connect your accounts free, generate a key on the Integrations page, and start exporting in minutes.

Get an API Key