Skip to main content
Amazon Vendor Central is the platform used by first-party vendors, the brands that sell their products to Amazon, which then resells them. Its retail analytics reports are exposed through the Amazon Selling Partner API (SP-API) and cover sales, traffic, inventory health, product margin, and Amazon’s own demand forecast, all broken down by ASIN.
Vendor Central and Seller Central are different programs. If you sell directly to customers on the Amazon marketplace, you are a seller: use the Amazon Selling Partner source instead. A vendor account has no seller orders, merchant listings, or FBA inventory, and a seller account has none of the vendor reports below.

Configuring Amazon Vendor as a Source

In the Sources tab, click on the “Add source” button located on the top right of your screen. Then, select the Amazon Vendor option from the list of connectors. Click Next and you’ll be prompted to add your access.

1. Add account access

You’ll need to authorize Nekt to access your Amazon Vendor Central data. Click on the Amazon Authorization button and log in with your Vendor Central account. The authorization grants access to the vendor group tied to those credentials, and therefore to every vendor code in that group.
The authorization must be granted from Vendor Central, not from Seller Central. A Seller Central authorization is accepted by Amazon but returns no vendor data, and every stream will fail as unauthorized.
The following configurations are available:
  • Region: Select the region where your vendor account is registered:
    • North America (US, Canada, Mexico, Brazil)
    • Europe (UK, France, Germany, Italy, Spain, Netherlands, etc.)
    • Far East (Japan, Australia, Singapore)
  • Marketplace ID: The Amazon marketplace your vendor account belongs to (e.g., ATVPDKIKX0DER for Amazon US, A2Q3Y263D00KWC for Amazon Brazil). A vendor account belongs to a single marketplace.
Find the complete list of marketplace IDs on this link: https://developer-docs.amazon.com/sp-api/docs/marketplace-ids
  • Distributor view: Which side of the business the sales and inventory numbers describe.
    • Manufacturing: your view as the manufacturer, including what Amazon ordered from you. This is the usual choice.
    • Sourcing: Amazon’s view of what it sourced from you. Ordered revenue and ordered units are not reported in this view.
  • Selling program: The Amazon program your vendor account participates in: Retail, Business, or Fresh. Amazon publishes the inventory and forecasting reports for Retail and Fresh only, so those two streams fall back to Retail when Business is selected. The run log records it when that happens.
  • Start Date: The earliest date from which records will be synced. Amazon keeps roughly 4 years of daily vendor data, so earlier dates are automatically adjusted to the oldest date Amazon still serves.
Once you’re done, click Next.

2. Select streams

Choose which data streams you want to sync. For faster extractions, select only the streams that are relevant to your analysis. You can select entire groups of streams or pick specific ones.
Tip: The stream can be found more easily by typing its name.
Select the streams and click Next.

3. Configure data streams

Customize how you want your data to appear in your catalog. Select the desired layer where the data will be placed, a folder to organize it inside the layer, a name for each table (which will effectively contain the fetched data) and the type of sync.
  • Layer: choose between the existing layers on your catalog. This is where you will find your new extracted tables as the extraction runs successfully.
  • Folder: a folder can be created inside the selected layer to group all tables being created from this new data source.
  • Table name: we suggest a name, but feel free to customize it. You have the option to add a prefix to all tables at once and make this process faster!
  • Sync Type: you can choose between INCREMENTAL and FULL_TABLE.
    • Incremental: every time the extraction happens, we’ll get only the new data - which is good if, for example, you want to keep every record ever fetched.
    • Full table: every time the extraction happens, we’ll get the current state of the data - which is good if, for example, you don’t want to have deleted data in your catalog.
Once you are done configuring, click Next.

4. Configure data source

Describe your data source for easy identification within your organization, not exceeding 140 characters. To define your Trigger, consider how often you want data to be extracted from this source. Amazon publishes vendor metrics with up to 72 hours of delay, so a daily trigger is usually enough. Optionally, you can define some additional settings:
  • Configure Delta Log Retention and determine for how long we should store old states of this table as it gets updated. Read more about this resource here.
  • Determine when to execute an Additional Full Sync. This will complement the incremental data extractions, ensuring that your data is completely synchronized with your source every once in a while.
Once you are ready, click Next to finalize the setup.

5. Check your new source

You can view your new source on the Sources page. If needed, manually trigger the source extraction by clicking on the arrow button. Once executed, your data will appear in your Catalog.
For you to be able to see it on your Catalog, you need at least one successful source run.

Streams and Fields

All streams carry one record per ASIN per period. Amazon also returns account-wide totals in each report; those are not extracted, since they are the sum of the per-ASIN rows and can be recomputed with a GROUP BY.
Daily sales performance per ASIN, from the GET_VENDOR_SALES_REPORT report. Primary key is the composite (asin, startDate).Which metrics Amazon fills in depends on your configuration: ordered revenue and ordered units are only reported for the Manufacturing distributor view, and customer returns only for the Retail and Business selling programs.
Daily detail page traffic per ASIN, from the GET_VENDOR_TRAFFIC_REPORT report. Combined with the Sales Report, this is what makes conversion rate computable. Primary key is the composite (asin, startDate).
Daily inventory health per ASIN, from the GET_VENDOR_INVENTORY_REPORT report: what Amazon received from you, what it still holds, and how healthy that stock is. Primary key is the composite (asin, startDate).
Daily net pure product margin per ASIN, from the GET_VENDOR_NET_PURE_PRODUCT_MARGIN_REPORT report. Primary key is the composite (asin, startDate).
Amazon’s demand forecast per ASIN, from the GET_VENDOR_FORECASTING_REPORT report. Unlike the other reports this one looks forward, so each run pulls the current snapshot, covering several future periods per ASIN. Snapshots are kept side by side (keyed by forecastGenerationDate), so you can compare what Amazon predicted against what actually happened. Primary key is the composite (asin, forecastGenerationDate, startDate).

Use Cases for Data Analysis

This guide outlines valuable business intelligence use cases when consolidating Amazon Vendor data, along with ready-to-use SQL queries that you can run on Explorer.

1. Shipped Revenue and Margin by ASIN

Rank your catalog by what Amazon actually shipped, and check the margin Amazon makes on each product. Business Value:
  • Identify the products driving revenue
  • Spot ASINs where Amazon’s margin is thin, which is what buyers cite in cost negotiations
  • Track customer returns against shipped units

2. Detail Page Conversion by ASIN

Combine traffic and sales to see which product pages convert the views they get. Business Value:
  • Find high-traffic, low-conversion pages where content or pricing is the bottleneck
  • Prioritize A+ content and imagery work by potential impact
  • Measure the effect of a listing change on conversion

3. Stock Risk Against Amazon’s Forecast

Compare the stock Amazon holds today with what it forecasts it will sell, to anticipate stockouts and excess. Business Value:
  • Flag ASINs whose on-hand cover is below Amazon’s own demand forecast
  • Catch aging and unhealthy inventory before it turns into chargebacks
  • Bring an objective number to purchase order negotiations

Implementation Notes

Vendor Central and Seller Central data both live on the Amazon Selling Partner API, but on disjoint endpoints. A vendor sells to Amazon, so it has no seller orders, no merchant listings, and no FBA inventory; those are covered by the Amazon Selling Partner source. The authorization is separate as well: this connector requires consent granted from Vendor Central, and a seller refresh token will be rejected by every stream.
All streams use the SP-API Reports API. Reports are generated asynchronously: the connector submits a report request, polls until it’s ready (up to 30 minutes per window: 60 attempts × 30 seconds), then downloads and parses the JSON document, decompressing it when Amazon returns GZIP.Amazon caps how much a single daily report may span at 15 days, so each sync walks the requested range in 14-day windows. Requesting a long history therefore creates many reports, and the first sync of several years of data takes a while.
The Sales, Traffic, Inventory, and Net Pure Product Margin streams use startDate as the replication key.Amazon revises recent vendor metrics after the fact, as returns are processed and costs adjusted. To keep already-loaded rows in sync instead of freezing them at their first value, every incremental run rewinds its bookmark by 30 days and re-reads that window. Re-extracted rows carry the same primary key, so they update in place rather than duplicating.The Forecasting Report is a forward-looking snapshot with no date range, so it is always a full extraction. Each run’s snapshot is preserved through the forecastGenerationDate in its primary key.
  • Publication lag: Amazon takes up to 72 hours to publish a day’s metrics, so extraction windows stop one day short of today. Recent days are filled in by later runs through the 30-day rewind above.
  • Retention: roughly 4 years (1460 days) of daily data. A Start Date earlier than that is automatically clamped, and the run log states the adjusted date.
  • Selling program: the Inventory and Forecasting reports exist for Retail and Fresh only. When the source is configured as Business, those two streams are extracted for Retail and the run log records the fallback.
Amazon refills the report creation quota roughly once per minute, so long backfills are throttled by design. The connector handles this automatically:
  • 429 QuotaExceeded: retried up to 5 times. The Retry-After header is respected when present, otherwise exponential backoff is used, starting at 60 seconds and doubling each attempt. Waits are reported in the run log, which is why a large first sync may look slow.
  • Stale connections: if the server closes an idle connection during a long polling sleep, the connector reopens the session and retries transparently.
  • Access tokens are refreshed 15 minutes before expiration to avoid failures in the middle of a long extraction.

Skills for agents

Download Amazon Vendor skills file

Amazon Vendor connector documentation as plain markdown, for use in AI agent contexts.