Configuring Amazon Selling Partner 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 Selling Partner 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 Selling Partner data. Click on the Amazon Authorization button and log in with your Amazon seller account. Grant the necessary permissions for the marketplace(s) you want to extract data from. The following configurations are available:-
Region: Select the appropriate region for your marketplace:
- North America (US, Canada, Mexico, Brazil)
- Europe (UK, France, Germany, Italy, Spain, Netherlands, etc.)
- Far East (Japan, Australia, Singapore, India)
-
Marketplace IDs: The Amazon marketplace IDs you want to sync data from (e.g.,
ATVPDKIKX0DERfor Amazon US,A2Q3Y263D00KWCfor Amazon Brazil).
Marketplace IDs
Marketplace IDs
Find the complete list of marketplace IDs on this link: https://developer-docs.amazon.com/sp-api/docs/marketplace-ids
| Region | Country | Marketplace Name | Marketplace ID |
|---|---|---|---|
| North America | United States | Amazon.com | ATVPDKIKX0DER |
| North America | Canada | Amazon.ca | A2EUQ1WTGCTBG2 |
| North America | Mexico | Amazon.com.mx | A1AM78C64UM0Y8 |
| North America | Brazil | Amazon.com.br | A2Q3Y263D00KWC |
| Europe | United Kingdom | Amazon.co.uk | A1F83G8C2ARO7P |
| Europe | Germany | Amazon.de | A1PA6795UKMFR9 |
| Europe | France | Amazon.fr | A13V1IB3VIYZZH |
| Europe | Italy | Amazon.it | APJ6JRA9NG5V4 |
| Europe | Spain | Amazon.es | A1RKKUPIHCS9HS |
| Europe | Netherlands | Amazon.nl | A1805IZSGTT6HS |
| Europe | Sweden | Amazon.se | A2NODRKZP88ZB9 |
| Europe | Poland | Amazon.pl | A1C3SOZRARQ6R3 |
| Europe | Belgium | Amazon.com.be | AMEN7PMS3EDWL |
| Far East | Japan | Amazon.co.jp | A1VC38T7YXB528 |
| Far East | Singapore | Amazon.sg | A19VAU5U5O7RUS |
| Far East | Australia | Amazon.com.au | A39IBJ37TRP1C6 |
| Far East | India | Amazon.in | A21TJRUUN4KGV |
| Middle East | United Arab Emirates | Amazon.ae | A2VIGQ35RCS4UG |
| Middle East | Turkey | Amazon.com.tr | A33AVAJ2PDY3EV |
| Middle East | Saudi Arabia | Amazon.sa | A17E79C6D8DWNP |
| Other | Egypt | Amazon.eg | ARBP9OOSHTCHU |
- Start Date: The earliest date from which records will be synced. If not provided, the connector defaults to the last 30 days of data.
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.
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. This decision usually depends on how frequently you need the new table data updated (every day, once a week, or only at specific times). 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.
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.Streams and Fields
Below you’ll find all available data streams from Amazon Selling Partner and their corresponding fields:Orders Report
Orders Report
Complete order data including buyer information, item details, pricing, taxes, and shipping — fetched via the flat-file all-orders report.
| Field | Type | Description |
|---|---|---|
amazonOrderId | String | Amazon order identifier |
merchantOrderId | String | Merchant order identifier |
purchaseDate | DateTime | Date the order was placed |
lastUpdatedDate | DateTime | Date the order was last updated (replication key) |
orderStatus | String | Order status |
fulfillmentChannel | String | Fulfillment channel (AFN for FBA, MFN for merchant-fulfilled) |
salesChannel | String | Sales channel |
orderChannel | String | Order channel |
shipServiceLevel | String | Ship service level |
productName | String | Product name |
sku | String | Seller SKU |
asin | String | Amazon Standard Identification Number |
itemStatus | String | Item status |
quantity | Integer | Quantity ordered |
currency | String | Currency code |
itemPrice | String | Item price |
itemTax | String | Item tax |
shippingPrice | String | Shipping price |
shippingTax | String | Shipping tax |
giftWrapPrice | String | Gift wrap price |
giftWrapTax | String | Gift wrap tax |
itemPromotionDiscount | String | Item promotion discount |
shipPromotionDiscount | String | Shipping promotion discount |
shipCity | String | Ship-to city |
shipState | String | Ship-to state |
shipPostalCode | String | Ship-to postal code |
shipCountry | String | Ship-to country |
promotionIds | String | Promotion IDs |
isBusinessOrder | String | Whether this is a business order |
purchaseOrderNumber | String | Purchase order number |
priceDesignation | String | Price designation |
Merchant Listings Report
Merchant Listings Report
Current snapshot of all active merchant listings with product details, pricing, inventory, and fulfillment information.
| Field | Type | Description |
|---|---|---|
itemName | String | Listing title |
itemDescription | String | Listing description |
listingId | String | Listing identifier |
sellerSku | String | Seller SKU (primary key) |
price | String | Listing price |
quantity | Integer | Available quantity |
openDate | DateTime | Date the listing was opened |
imageUrl | String | Main image URL |
itemIsMarketplace | String | Whether the item is listed on the marketplace |
productIdType | String | Product ID type (e.g. ASIN, UPC) |
zshopShippingFee | String | zShop shipping fee |
itemNote | String | Seller note on the item |
itemCondition | String | Item condition |
asin1 | String | Primary ASIN |
asin2 | String | Secondary ASIN |
asin3 | String | Tertiary ASIN |
willShipInternationally | String | Whether the item ships internationally |
expeditedShipping | String | Expedited shipping option |
productId | String | Product identifier |
addDelete | String | Add or delete flag |
pendingQuantity | Integer | Quantity pending fulfillment |
fulfillmentChannel | String | Fulfillment channel (AFN for FBA, MFN for merchant-fulfilled) |
merchantShippingGroup | String | Merchant shipping group |
status | String | Listing status |
Sales and Traffic Report
Sales and Traffic Report
Daily sales and traffic metrics including units ordered, revenue, refunds, sessions, page views, and conversion data — with B2B breakdowns.
| Field | Type | Description |
|---|---|---|
date | Date | Date (YYYY-MM-DD, replication key) |
unitsOrdered | Integer | Total units ordered |
unitsOrderedB2B | Integer | B2B units ordered |
totalOrderItems | Integer | Total order items |
totalOrderItemsB2B | Integer | B2B total order items |
orderedProductSalesAmount | Number | Ordered product sales amount |
orderedProductSalesCurrencyCode | String | Ordered product sales currency |
orderedProductSalesB2BAmount | Number | B2B ordered product sales amount |
orderedProductSalesB2BCurrencyCode | String | B2B ordered product sales currency |
unitsRefunded | Integer | Units refunded |
refundRate | Number | Refund rate |
claimsGranted | Integer | Claims granted |
claimsAmountAmount | Number | Claims amount |
claimsAmountCurrencyCode | String | Claims amount currency |
unitsShipped | Integer | Units shipped |
ordersShipped | Integer | Orders shipped |
sessions | Integer | Total sessions |
browserSessions | Integer | Browser sessions |
mobileAppSessions | Integer | Mobile app sessions |
sessionPercentage | Number | Session percentage |
pageViews | Integer | Total page views |
browserPageViews | Integer | Browser page views |
mobileAppPageViews | Integer | Mobile app page views |
pageViewsPercentage | Number | Page views percentage |
buyBoxPercentage | Number | Buy box percentage |
unitSessionPercentage | Number | Unit session percentage (conversion rate) |
unitSessionPercentageB2B | Number | B2B unit session percentage |
averageOfferCount | Integer | Average offer count |
averageParentItems | Integer | Average parent items |
feedbackReceived | Integer | Feedback received |
negativeFeedbackReceived | Integer | Negative feedback received |
receivedNegativeFeedbackRate | Number | Received negative feedback rate |
Use Cases for Data Analysis
This guide outlines valuable business intelligence use cases when consolidating Amazon Selling Partner data, along with ready-to-use SQL queries that you can run on Explorer.1. Sales Performance Overview
Analyze daily sales performance including revenue, units sold, and refund trends. Business Value:- Track revenue trends over time
- Monitor refund rates to identify product quality issues
- Compare B2B vs. B2C sales performance
SQL query
SQL query
- AWS
- GCP
Sample Result
Sample Result
| date | unitsOrdered | orderedProductSalesAmount | orderedProductSalesCurrencyCode | unitsRefunded | refundRate | unitsShipped | ordersShipped | calculated_refund_pct |
|---|---|---|---|---|---|---|---|---|
| 2026-03-10 | 342 | 18,456.90 | USD | 8 | 2.34 | 328 | 298 | 2.34 |
| 2026-03-09 | 298 | 15,230.45 | USD | 5 | 1.68 | 290 | 265 | 1.68 |
| 2026-03-08 | 410 | 22,890.10 | USD | 12 | 2.93 | 395 | 350 | 2.93 |
| 2026-03-07 | 275 | 14,100.00 | USD | 3 | 1.09 | 270 | 245 | 1.09 |
2. Order Fulfillment Analysis
Track order distribution by status and fulfillment channel to monitor operational health. Business Value:- Monitor order processing efficiency across FBA and merchant-fulfilled channels
- Identify bottlenecks in fulfillment
- Track cancellation rates by channel
SQL query
SQL query
- AWS
- GCP
Sample Result
Sample Result
| fulfillmentChannel | orderStatus | order_count | percentage | total_revenue |
|---|---|---|---|---|
| AFN | Shipped | 1,245 | 52.30 | 89,234.50 |
| MFN | Shipped | 520 | 21.84 | 31,245.00 |
| AFN | Pending | 312 | 13.11 | 22,523.00 |
| MFN | Cancelled | 156 | 6.55 | 9,856.00 |
| AFN | Cancelled | 148 | 6.22 | 8,432.00 |
3. Traffic-to-Sales Conversion
Measure how effectively your store traffic converts into orders using session and conversion data. Business Value:- Identify trends in traffic and conversion rates
- Compare browser vs. mobile app performance
- Optimize listing strategies based on Buy Box percentage
SQL query
SQL query
- AWS
- GCP
Sample Result
Sample Result
| date | sessions | browserSessions | mobileAppSessions | pageViews | unitsOrdered | conversion_rate | buyBoxPercentage | pages_per_session |
|---|---|---|---|---|---|---|---|---|
| 2026-03-10 | 4,523 | 1,890 | 2,633 | 8,245 | 342 | 7.56 | 92.30 | 1.82 |
| 2026-03-09 | 3,980 | 1,650 | 2,330 | 7,120 | 298 | 7.49 | 91.80 | 1.79 |
| 2026-03-08 | 5,120 | 2,100 | 3,020 | 9,800 | 410 | 8.01 | 93.10 | 1.91 |
| 2026-03-07 | 3,560 | 1,480 | 2,080 | 6,450 | 275 | 7.72 | 90.50 | 1.81 |
Implementation Notes
Report-Based Extraction
Report-Based Extraction
The connector uses the Amazon SP-API Reports API rather than direct API endpoints. Reports are created asynchronously — the connector submits a report request, polls until it’s ready, then downloads and parses the result. This approach avoids the strict rate limits of the Orders API (0.0056 req/s) and enables efficient bulk data extraction.
Regional API Endpoints
Regional API Endpoints
The connector supports all Amazon SP-API regional endpoints:
- North America: US, Canada, Mexico, Brazil
- Europe: UK, France, Germany, Italy, Spain, Netherlands, Turkey, UAE, India, etc.
- Far East: Japan, Australia, Singapore
Incremental Sync
Incremental Sync
The connector supports incremental sync for:
- Orders Report: Uses
lastUpdatedDateas the replication key — data is fetched in 30-day chunks - Sales and Traffic Report: Uses
dateas the replication key — data is fetched in 30-day chunks
Authentication and Token Management
Authentication and Token Management
The connector automatically manages OAuth access token refresh to prevent authentication failures:
- Access tokens are refreshed proactively 15 minutes before expiration
Data Chunking
Data Chunking
For time-based reports (Orders and Sales & Traffic), the connector splits requests into 30-day chunks to stay within SP-API limits and avoid timeouts on large date ranges. The chunking is handled automatically — you only need to set the desired
Start Date.