### Product Node Request Example Source: https://sellersprite.github.io/ Example cURL command to retrieve product node information. Requires a secret key and specifies marketplace and nodeIdPath. ```bash curl 'https://api.sellersprite.com/v1/product/node?marketplace=US&nodeIdPath=2619525011' \ -H 'secret-key: your secret key' \ -H 'content-type: application/json;charset=utf-8' \ --compressed ``` -------------------------------- ### Google Trends Request Example Source: https://sellersprite.github.io/ Example of how to make a request to the Google Trends endpoint. Ensure you replace 'your secret key' with your actual secret key. ```bash curl 'https://api.sellersprite.com/v1/google/trends?googleProp=web&keyword=iphone%20stand&marketplace=US&monthly=true' \ -H 'secret-key: your secret key' \ -H 'content-type: application/json;charset=utf-8' \ --compressed ``` -------------------------------- ### Traffic Listing Stat API Request Example Source: https://sellersprite.github.io/ Example of a cURL request to the traffic listing stat endpoint. This endpoint retrieves statistics for a given list of ASINs. ```bash curl 'https://api.sellersprite.com/v1/traffic/listing/stat \ -H 'secret-key: your secret key' \ -H 'content-type: application/json;charset=UTF-8' \ --data-raw $"{"marketplace":"US","asinList":["B07Z82895W"]}" \ --compressed ``` -------------------------------- ### Get ASIN Details Source: https://sellersprite.github.io/ Retrieves detailed information about a specific Amazon ASIN. Requires your secret key for authentication. ```bash curl 'https://api.sellersprite.com/v1/asin/US/B07V34QQ3C' \ -H 'secret-key: Your Key' \ -H 'content-type: application/json;charset=utf-8' \ --compressed ``` -------------------------------- ### ABA Research API Request Example Source: https://sellersprite.github.io/ Example of a cURL request to the ABA research endpoint. Ensure to replace 'your secret key' with your actual secret key. ```bash curl 'https://api.sellersprite.com/v1/aba/research' \ -H 'secret-key: your secret key' \ -H 'content-type: application/json;charset=UTF-8' \ --data-raw $'{"marketplace":"US","rankGrowthType":"W1","date":"20220129"}' \ --compressed ``` -------------------------------- ### Product Competitor Lookup Request Source: https://sellersprite.github.io/ Example cURL command to perform a product competitor lookup. Requires a secret key and specifies marketplace and brand. ```bash curl 'https://api.sellersprite.com/v1/product/competitor-lookup' \ -H 'secret-key: your secret key' \ -H 'content-type: application/json;charset=UTF-8' \ --data-raw $'{\"marketplace\": \"US\",\n \"brand\":\"Gorilla Grip\"\n }' \ --compressed ``` -------------------------------- ### Get ASIN Sales Prediction Source: https://sellersprite.github.io/ Estimates sales for a given ASIN and marketplace. Requires ASIN and marketplace. ```shell curl 'https://api.sellersprite.com/v1/sales/prediction/asin? asin=B08C7HDF1F&marketplace=US' \ -H 'secret-key: You Key' \ -H 'content-type: application/json;charset=UTF-8' \ --compressed ``` -------------------------------- ### Get Keyword Traffic Statistics Source: https://sellersprite.github.io/ Fetches statistics for keywords associated with a given ASIN in a specific marketplace. Authentication is required. ```bash curl 'https://api.sellersprite.com/v1/traffic/keyword/stat/US/B07Z82895W' \ -H 'secret-key: your key' \ -H 'content-type: application/json;charset=UTF-8' \ --compressed ``` -------------------------------- ### Get Keyword Distribution Data Source: https://sellersprite.github.io/ Fetches keyword distribution and ASIN-related information for a given marketplace, query, and month. Authentication is required. ```curl curl 'https://api.sellersprite.com/v1/traffic/source \ -H 'secret-key: Your Key' \ -H 'content-type: application/json;charset=UTF-8' \ --data-raw $"{"marketplace":"US","q":"B07Z82895W","month":"202210"}" \ --compressed ``` -------------------------------- ### Product Research API Request Example Source: https://sellersprite.github.io/ This cURL command demonstrates how to query the product research endpoint, specifying marketplace, excluding certain keywords, and setting a maximum price. ```bash curl 'https://api.sellersprite.com/v1/product/research' \ -H 'secret-key: your secret key' \ -H 'content-type: application/json;charset=UTF-8' \ --data-raw $'{"marketplace": "US", "excludeKeywords":"HP", "maxPrice":432}' \ --compressed ``` -------------------------------- ### Example cURL Request for Brand Detail Source: https://sellersprite.github.io/ This snippet demonstrates how to fetch brand details using a cURL command. It includes parameters for brand ID and office, along with necessary headers and form data. ```bash curl 'https://api.sellersprite.com/v1/global/brand/detail?brandId=US502016087116276&office=US' \ -H 'secret-key: you key' \ -H 'content-type: multipart/form-data' \ -F "imageFile=" -F "imageBase64=" -F "text=ANKER" -F "office=US" -F "office=CA" \ --compressed ``` -------------------------------- ### GET /v1/traffic/listing/stat Source: https://sellersprite.github.io/ Retrieves statistics for a given ASIN list, including related product counts and traffic associations. ```APIDOC ## GET /v1/traffic/listing/stat ### Description Retrieves statistics for a given ASIN list, including related product counts and traffic associations. ### Method GET ### Endpoint /v1/traffic/listing/stat ### Parameters #### Query Parameters - **marketplace** (String) - Required - marketplace code, see table 1.2 - **asinList** (List) - Optional - Collection of query ASINs ### Request Example ```json { "marketplace": "US", "asinList": [ "B07Z82895W" ] } ``` ### Response #### Success Response (200) - **marketplace** (String) - marketplace code - **asin** (String) - asin - **relations** (Integer) - the number of related asin - **freeRelations** (Integer) - associated traffic without sponsored - **paidRelations** (Integer) - associated traffic with sponsored - **calcTime** (Long) - last calculated time - **items** (List) - result set - **relation** (String) - relation type, see table 2.2, ignore case - **count** (Integer) - the number of relation #### Response Example { "marketplace": "US", "asin": "B07Z82895W", "relations": 1848, "freeRelations": 1414, "paidRelations": 286, "calcTime": null, "items": [ { "relation": "vav", "count": 3 } ] } ``` -------------------------------- ### Get Listing Information Source: https://sellersprite.github.io/ Retrieves detailed information about a specific product listing using its ASIN. This includes brand, pricing, sales metrics, ratings, and seller information. ```APIDOC ## POST /v1/traffic/listing ### Description Retrieves detailed information about a specific product listing using its ASIN. This includes brand, pricing, sales metrics, ratings, and seller information. ### Method POST ### Endpoint /v1/traffic/listing ### Parameters #### Request Body - **marketplace** (String) - Required - The marketplace code (e.g., US). - **asinList** (List of Strings) - Required - A list of ASINs to retrieve information for. ### Request Example { "marketplace": "US", "asinList": ["B07Z82895W"] } ### Response #### Success Response (200) - **asin** (String) - ASIN of the product. - **brand** (String) - Brand name of the product. - **brandUrl** (String) - URL to search for the brand on Amazon. - **imageUrl** (String) - URL of the product image. - **title** (String) - Title of the product listing. - **parent** (String) - Parent ASIN, if applicable. - **nodeId** (Long) - Product node ID. - **nodeIdPath** (String) - Path of node IDs, separated by colons. - **nodeLabelPath** (String) - Path of node labels, separated by colons. - **bsrId** (String) - Best Seller Rank ID. - **bsr** (Integer) - Best Seller Rank. - **units** (Integer) - Monthly sales volume in units. - **unitsCr** (Float) - Monthly sales volume growth rate. - **revenue** (Float) - Monthly sales revenue. - **price** (Float) - Current price of the product. - **profit** (Float) - Estimated profit margin. - **fba** (Float) - Fulfillment by Amazon fees. - **ratings** (Integer) - Total number of ratings. - **ratingsRate** (Float) - Retention rate of ratings. - **rating** (Float) - Average rating score. - **ratingsCv** (Integer) - Number of monthly rating growth. - **ratingDelta** (Integer) - Number of new comments in the last 30 days. - **availableDate** (Long) - Shelf time in milliseconds. - **fulfillment** (String) - Fulfillment method (AMZ, FBA, FBM). - **variations** (Integer) - Number of product variations. - **sellers** (Integer) - Number of sellers. - **sellerId** (String) - Seller ID. - **sellerName** (String) - Seller name. - **sellerNation** (String) - Seller's country code. - **badge** (Object) - Badge information. - **bestSeller** (String) - Indicates if the product is a best-seller (Y/N). - **amazonChoice** (String) - Indicates if the product has Amazon's Choice badge (Y/N). - **newRelease** (String) - Indicates if the product is a new release (Y/N). - **ebc** (String) - Indicates if the product has A+ content (Y/N). - **video** (String) - Indicates if the product has a video (Y/N). - **weight** (String) - Product weight. - **dimension** (String) - Product dimensions. - **dimensionType** (String) - Dimension type code. - **sku** (String) - SKU details. #### Response Example { "asin": "B078J8VPVW", "brand": "Pampers", "brandUrl": "https://www.amazon.com/s?k=HP", "imageUrl": "https://images-na.ssl-images-amazon.com/images/I/51axlzme6aL.AC_US200.jpg", "title": "Diapers Size 2, 186 Count - Pampers Swaddlers Disposable Baby Diapers, ONE MONTH SUPPLY", "parent": "B081RGNL17", "nodeId": 3741281, "nodeIdPath": "2619525011:3741271:3741281", "nodeLabelPath": "Baby Products:Diapering:Disposable Diapers", "bsrId": "office-products", "bsr": 1, "units": 26289, "unitsCr": -46.3, "revenue": 1693537.4, "price": 64.42, "profit": 63.92, "fba": 13.58, "ratings": 32004, "ratingsRate": 40.57, "rating": 4.8, "ratingsCv": 10666, "ratingDelta": 0, "availableDate": 1454083200000, "fulfillment": "AMZ", "variations": 7, "sellers": 7, "sellerId": "A1Y8BVAASXO4R7", "sellerName": "Amazon", "sellerNation": "see table 1.5", "badge": { "bestSeller": "Y", "amazonChoice": "N", "newRelease": "N", "ebc": "Y", "video": "N" }, "weight": "8.88 pounds", "dimension": "13.3 x 15.8 x 10.6 inches", "dimensionType": "ST,0V", "sku": "[\"Color: Beige\", \"Size: 47 inches\"]" } ``` -------------------------------- ### Get ASIN Detail Source: https://sellersprite.github.io/ Retrieves detailed information for a specific ASIN within a given marketplace. This includes historical data and ranking information. ```APIDOC ## GET /v1/asin/{marketplace}/{asin} ### Description Retrieves detailed information for a specific ASIN within a given marketplace. This includes historical data and ranking information. ### Method GET ### Endpoint /v1/asin/{marketplace}/{asin} ### Parameters #### Path Parameters - **marketplace** (String) - Required - Marketplace code (see table 1.2). - **asin** (String) - Required - The ASIN to retrieve details for. #### Query Parameters - **month** (String) - Optional - Historical month in 'YYYYMM' format. Defaults to the last 30 days if not provided. ### Response #### Success Response (200) (Response structure for ASIN detail is not explicitly provided in the source, but would typically include metrics similar to the extended traffic data for the specified ASIN.) #### Response Example (No specific response example provided in the source for this endpoint.) ``` -------------------------------- ### Keyword Miner API Request Example Source: https://sellersprite.github.io/ This snippet shows how to make a request to the keyword miner endpoint using curl. It includes common parameters like keyword, marketplace, and ordering. ```bash curl 'https://api.sellersprite.com/v1/keyword/miner' \ --H 'Content-Type: application/json' \ --H 'secret-key: your secret key' \ --data-raw '{"desc": true,"keyword":"phone stand","marketplace": "US","amazonChoice":false,"pageNum": 1,"pageSize":100,"order": { "field":"searches", "desc":false}}' \ --compressed ``` -------------------------------- ### Keyword Research Department API Request Source: https://sellersprite.github.io/ Example cURL request to retrieve department information for keyword research. The marketplace parameter is required. ```bash curl 'https://api.sellersprite.com/v1/keyword-research/department?marketplace=US' \ -H 'secret-key: your secret key' \ -H 'content-type: application/json;charset=UTF-8' \ --compressed ``` -------------------------------- ### Get Google Trends Data Source: https://sellersprite.github.io/ Retrieves Google Trends data for a given keyword and marketplace. Supports filtering by search type and monthly granularity. ```bash curl 'https://api.sellersprite.com/v1/google/trends?marketplace=US&keyword=iphone%20stand&googleProp=web&monthly=false' \ -H 'secret-key: Your Key' \ -H 'content-type: application/json;charset=utf-8' \ --compressed ``` -------------------------------- ### Get Keyword Distribution Source: https://sellersprite.github.io/ Analyzes traffic sources for a given ASIN or keyword, providing a distribution of traffic terms and related ASIN information. ```APIDOC ## POST /v1/traffic/source ### Description Analyzes traffic sources for a given ASIN or keyword, providing a distribution of traffic terms and related ASIN information. ### Method POST ### Endpoint /v1/traffic/source ### Parameters #### Request Body - **marketplace** (String) - Required - Marketplace code (e.g., US). - **q** (String) - Required - The query ASIN or keywords. - **month** (String) - Required - Query month in yyyyMM format (e.g., 202210). - **page** (Integer) - Required - Page number for pagination. - **size** (Integer) - Required - Number of items per page. - **order** (Object) - Required - Sorting parameters. - **field** (String) - Field to sort by (See table 2.4). - **desc** (Boolean) - True for descending, false for ascending. ### Request Example { "marketplace": "US", "q": "B07Z82895W", "month": "202210" } ### Response #### Success Response (200) - **keywords** (Integer) - Total traffic terms. - **searchKeywords** (Integer) - Natural search terms. - **acKeywords** (Integer) - AC Recommendation terms. - **editorialKeywords** (Integer) - ER Recommendation terms. - **fourStarsKeywords** (Integer) - 4-star recommendation terms. - **hrKeywords** (Integer) - HR Recommendation terms. - **adKeywords** (Integer) - SP advertising slogan terms. - **videoKeywords** (Integer) - Video advertising slogan terms. - **brandKeywords** (Integer) - Brand advertising slogan terms. - **badgeLabels** (List) - Overview of traffic sources (e.g., ["SEARCH", "OFFICIAL", "AD"]). - **badgeDetails** (Map) - Traffic source details (e.g., {"SEARCH": ["NATURAL_SEARCHING"],"OFFICIAL": ["AMAZON_CHOICE"]}). - **asinInfo** (Object) - ASIN related information. - **asin** (String) - ASIN of the product. - **asinUrl** (String) - URL of the ASIN on Amazon. - **currency** (String) - Currency code (e.g., $). - **price** (Float) - Price of the product. - **rating** (Float) - Average rating score. - **reviews** (Integer) - Number of reviews. - **sku** (String) - SKU details. - **title** (String) - Title of the product. - **variations** (Integer) - Number of product variations. #### Response Example { "keywords": 1423, "searchKeywords": 23, "acKeywords": 43, "editorialKeywords": 234, "fourStarsKeywords": 234, "hrKeywords": 234, "adKeywords": 214, "videoKeywords": 453, "brandKeywords": 223, "badgeLabels": ["SEARCH", "OFFICIAL", "AD"], "badgeDetails": {"SEARCH": ["NATURAL_SEARCHING"],"OFFICIAL": ["AMAZON_CHOICE"]}, "asinInfo": { "asin": "B078J8VPVW", "asinUrl": "https://www.amazon.com/dp/B08GHW4TBS", "currency": "$", "price": 23.0, "rating": 32.0, "reviews": 354, "sku": "[\"Color: Beige\", \"Size: 47 inches\"]", "title": "Example Product Title", "variations": 2 } } ``` -------------------------------- ### Keyword Research API Request Source: https://sellersprite.github.io/ Example of a cURL request to the keyword research endpoint. Ensure to replace 'your secret key' with your actual secret key. ```bash curl 'https://api.sellersprite.com/v1/keyword-research' \ -H 'secret-key: your secret key' \ -H 'content-type: application/json;charset=UTF-8' \ --data-raw $'{"marketplace":"US","month":"202203"}' \ --compressed ``` -------------------------------- ### Get Global Trademark Statistics Source: https://sellersprite.github.io/ Queries statistics from the Global Trademark Library. Supports filtering by data range (office) and text query, or by uploading an image. ```shell curl 'https://api.sellersprite.com/v1/global/brand/stats' \ -H 'secret-key: Your Key' \ -H 'content-type: multipart/form-data' \ --compressed ``` -------------------------------- ### Get Listing Traffic Data Source: https://sellersprite.github.io/ Retrieves traffic data for a given ASIN in a specific marketplace. Requires a secret key for authentication. ```curl curl 'https://api.sellersprite.com/v1/traffic/listing' \ -H 'secret-key: your secret key' \ -H 'content-type: application/json;charset=UTF-8' \ --data-raw $'{"marketplace":"US","asinList":["B07Z82895W"]}' \ --compressed ``` -------------------------------- ### Product Node Lookup Source: https://sellersprite.github.io/ Retrieves product node information based on marketplace and node ID path or keyword. ```APIDOC ## GET /v1/product/node ### Description Retrieves product node information based on marketplace and node ID path or keyword. ### Method GET ### Endpoint /v1/product/node ### Parameters #### Query Parameters - **marketplace** (String) - Required - Marketplace code (e.g., US). - **nodeIdPath** (String) - Optional - Complete node ID paths, separated by colon (e.g., 2619525011:3741271:3741281). - **keyword** (String) - Optional - Keywords or node ID (e.g., Books or 4053). ### Response #### Success Response (200) - **nodeIdPath** (String) - Complete node ID paths, separated by colon. - **nodeLabelPath** (String) - Node label path. - **products** (Integer) - The number of products in the node. - **nodeLabelLocale** (String) - Chinese translation of node names. - **nodeLabelPathLocale** (String) - Chinese translation of full node names. #### Response Example ```json { "nodeIdPath": "2619525011:3741271", "nodeLabelPath": "Appliances:Dishwashers", "products": 42, "nodeLabelLocale": "洗碗机", "nodeLabelPathLocale": "大家电:洗碗机" } ``` ``` -------------------------------- ### GET /v1/aba/research Source: https://sellersprite.github.io/ Retrieves research data for a given marketplace and date, including search rank, purchase information, and brand data. ```APIDOC ## GET /v1/aba/research ### Description Retrieves research data for a given marketplace and date, including search rank, purchase information, and brand data. ### Method GET ### Endpoint /v1/aba/research ### Parameters #### Query Parameters - **marketplace** (String) - Required - marketplace code, see table 1.2 - **rankGrowthType** (String) - Optional - Type of rank growth to consider (e.g., W1 for weekly) - **date** (String) - Required - Date in YYYYMMDD format ### Request Example ```json { "marketplace": "US", "rankGrowthType": "W1", "date": "20220129" } ``` ### Response #### Success Response (200) - **marketplace** (String) - Description - **keyword** (String) - Description - **keywordCn** (Integer) - Keyword Chinese translation - **keywordJp** (String) - Keyword Japanese translation - **departments** (List) - Description - **searchRank** (Integer) - Description - **searchRankCv** (Integer) - Description - **searchRankCr** (Double) - Description - **searches** (Integer) - Description - **purchases** (Integer) - Purchase quantity - **purchaseRate** (Double) - Purchase rate - **searchRankGrowthValue** (Integer) - Description - **searchRankGrowthRate** (Double) - Description - **cvsShareRate** (Double) - Description - **titleDensityExact** (Integer) - Description - **cprExact** (Integer) - Description - **w1SearchRank** (Integer) - Last week search rank - **w1RankGrowthValue** (Integer) - Last week rank growth - **w1RankGrowthRate** (Double) - Last week rank growth rate - **w4SearchRank** (Integer) - Last 4 weeks search rank - **w4RankGrowthValue** (Integer) - Last 4 weeks rank growth - **w4RankGrowthRate** (Double) - Last 4 weeks rank growth rate - **w12SearchRank** (Integer) - Last 12 weeks search rank - **w12RankGrowthValue** (Integer) - Last 12 weeks rank growth - **w12RankGrowthRate** (Double) - Last 12 weeks rank growth rate - **top3Brands** (List) - Description - **bid** (Float) - Description - **bidMax** (Float) - Description - **bidMin** (Float) - Description - **top3AsinDtoList** (List) - First three clicks asin - **asin** (String) - asin - **imageUrl** (String) - Description - **clickRate** (Double) - Description - **conversionRate** (Double) - Description - **sumClickRate** (Double) - Percentage of top three hits - **sumConversionRate** (Double) - Total share of conversions #### Response Example { "marketplace": "US", "keyword": "portable charger", "keywordCn": "便携式充电器", "keywordJp": "", "departments": [ "Cell Phones & Accessories" ], "searchRank": 62, "searchRankCv": 19, "searchRankCr": 0.2346, "searches": null, "purchases": 2492, "purchaseRate": 0.0054, "searchRankGrowthValue": null, "searchRankGrowthRate": null, "cvsShareRate": null, "titleDensityExact": null, "cprExact": null, "w1SearchRank": null, "w1RankGrowthValue": null, "w1RankGrowthRate": null, "w4SearchRank": null, "w4RankGrowthValue": null, "w4RankGrowthRate": null, "w12SearchRank": null, "w12RankGrowthValue": null, "w12RankGrowthRate": null, "top3Brands": [], "bid": null, "bidMax": null, "bidMin": null, "top3AsinDtoList": [ { "asin": null, "imageUrl": null, "clickRate": null, "conversionRate": null } ], "sumClickRate": 54.2, "sumConversionRate": 43.5 } ``` -------------------------------- ### POST /v1/traffic/listing/page Source: https://sellersprite.github.io/ Retrieves a paginated list of related products for a given ASIN list and relation types. ```APIDOC ## POST /v1/traffic/listing/page ### Description Retrieves a paginated list of related products for a given ASIN list and relation types. ### Method POST ### Endpoint /v1/traffic/listing/page ### Parameters #### Request Body - **marketplace** (String) - Required - marketplace code, see table 1.2 - **asinList** (List) - Required - Collection of asin - **relations** (List) - Optional - Collection of relation type, see table 2.2, default vav - **variations** (Boolean) - Optional - Whether to query variation ASINs - **page** (Integer) - Optional - Base on 1, Default 1 - **size** (Integer) - Optional - Default 50 - **order** (Object) - Optional - - **field** (String) - See table 2.2 - **desc** (boolean) - Default true ### Request Example ```json { "marketplace": "US", "asinList": [ "B07Z82895W" ], "relations": [ "vav", "bab" ], "variations": false, "page": 1, "size": 50, "order": { "field": "some_field", "desc": true } } ``` ### Response #### Success Response (200) (Response structure not detailed in the source text, but would typically include a list of related products based on the request parameters.) ``` -------------------------------- ### Get Keyword Traffic Data Source: https://sellersprite.github.io/ Use this endpoint to retrieve traffic data for a specific keyword and ASIN. Requires a secret key for authentication. ```curl curl 'https://api.sellersprite.com/v1/traffic/keyword' \ -H 'secret-key: your secret key' \ -H 'content-type: application/json;charset=UTF-8' \ --data-raw $'{"marketplace":"US","asin":"B07Z82895W"}' \ --compressed ``` -------------------------------- ### Global Trademark Library List Request Source: https://sellersprite.github.io/ This cURL example demonstrates how to query the Global Trademark Library for a list of trademarks. It supports filtering by text, office, brand name, status, and more, and allows file uploads or base64 image data. ```bash curl 'https://api.sellersprite.com/v1/global/brand/list' \ -H 'secret-key: you key' \ -H 'content-type: multipart/form-data' \ -F "imageFile=" -F "imageBase64=" -F "text=ANKER" -F "office=US" -F "office=CA" \ --compressed ``` -------------------------------- ### Get BSR Sales Prediction Source: https://sellersprite.github.io/ Predicts sales based on Best Seller Rank (BSR) and category ID. Requires marketplace and BSR. ```shell curl 'https://api.sellersprite.com/v1/sales/prediction/bsr? bsr=2&categoryId=11260432011&marketplace=US' \ -H 'secret-key: Your Key' \ -H 'content-type: application/json;charset=UTF-8' \ --compressed ``` -------------------------------- ### Competitor Lookup Source: https://sellersprite.github.io/ Searches for competitor products based on various criteria such as marketplace, brand, seller, or keywords. This endpoint helps in identifying and analyzing competing products in the market. ```APIDOC ## POST /v1/product/competitor-lookup ### Description Searches for competitor products based on various criteria such as marketplace, brand, seller, or keywords. This endpoint helps in identifying and analyzing competing products in the market. ### Method POST ### Endpoint /v1/product/competitor-lookup ### Parameters #### Query Parameters - **marketplace** (String) - Required - marketplace id - **month** (String) - Optional - The filter date is the last 30 days by default, and the earliest query time is January 2020 - **brand** (String) - Optional - brand name - **sellerName** (String) - Optional - seller name - **asins** (List) - Optional - asin collection, the maximum is 50 - **nodeIdPath** (String) - Optional - complete node id paths, separated by colon - **keyword** (String) - Optional - keyword for search - **variation** (String) - Optional - whether to query variations (Y/N, default N) - **page** (Integer) - Optional - one-based page index (default 1) - **size** (Integer) - Optional - the size of the page to be returned (default 50) #### Request Body - **order** (Object) - Optional - sorting parameters - **field** (String) - sort field (See table 1.6) - **desc** (boolean) - sort direction (true/false, default false) ### Request Example { "example": "curl 'https://api.sellersprite.com/v1/product/competitor-lookup' \ -H 'secret-key: your secret key' \ -H 'content-type: application/json;charset=UTF-8' \ --data-raw $'{\"marketplace\": \"US\",\n \"asins\": [\"B08MT3JR3F\"]}' \ --compressed" } ### Response #### Success Response (200) - **asin** (String) - asin - **brand** (String) - brand name - **brandUrl** (String) - URL for the brand - **imageUrl** (String) - URL of the product image - **title** (String) - Product title - **parent** (String) - Parent ASIN - **nodeId** (Long) - Product category node ID - **nodeIdPath** (String) - Complete node ID paths, separated by colon - **nodeLabelPath** (String) - Product category label path - **bsrId** (String) - Best Seller Rank ID - **bsr** (Integer) - Best Seller Rank - **units** (Integer) - Monthly sales units - **unitsGr** (Float) - Monthly sales growth rate - **revenue** (Float) - Monthly revenue - **price** (Float) - Product price - **profit** (Float) - Product profit - **fba** (Float) - FBA fees - **ratings** (Integer) - Total number of ratings - **ratingsRate** (Float) - Percentage of ratings - **rating** (Float) - Average rating - **ratingsCv** (Integer) - Ratings of monthly growths - **ratingDelta** (Integer) - Number of ratings in the last 30 days - **availableDate** (Long) - Available date timestamp - **fulfillment** (String) - Fulfillment method (AMZ, FBA, FBM) - **variations** (Integer) - Number of variations - **sellers** (Integer) - Number of sellers - **sellerId** (String) - Seller ID - **sellerName** (String) - Seller Name - **sellerNation** (String) - Seller's country - **badge** (Object) - Badge information - **bestSeller** (String) - Whether to contains best-seller (Y/N) - **amazonChoice** (String) - Whether to contains Amazon’s choice (Y/N) - **newRelease** (String) - Whether to contains newRelease (Y/N) - **ebc** (String) - Whether to contains A+ content (Y/N) - **video** (String) - Whether to contains video (Y/N) - **weight** (String) - Product weight - **dimension** (String) - Product dimensions - **dimensionsType** (String) - Dimensions type - **sku** (String) - Product SKU details #### Response Example { "example": "[Example response body for competitor lookup]" } ``` -------------------------------- ### Predict Sales Based on BSR Source: https://sellersprite.github.io/ Estimates sales volume based on Best Seller Rank (BSR), marketplace, and category ID. This is a GET request. ```curl GET /v1/sales/prediction/bsr?marketplace=US&bsr=1024&categoryId=11260432011 ``` -------------------------------- ### Product Competitor Lookup Source: https://sellersprite.github.io/ Retrieves competitor information for a given product, allowing filtering by brand and marketplace. ```APIDOC ## POST /v1/product/competitor-lookup ### Description Retrieves competitor information for a given product, allowing filtering by brand and marketplace. ### Method POST ### Endpoint /v1/product/competitor-lookup ### Parameters #### Request Body - **marketplace** (String) - Required - The marketplace code (e.g., US). - **brand** (String) - Optional - The brand name to filter by. ### Request Example ```json { "marketplace": "US", "brand":"Gorilla Grip" } ``` ### Response #### Success Response (200) - **asin** (String) - asin - **brand** (String) - Brand name. - **brandUrl** (String) - URL for the brand. - **imageUrl** (String) - URL of the product image. - **title** (String) - Product title. - **parent** (String) - Parent ASIN. - **nodeId** (Long) - Product's node ID. - **nodeIdPath** (String) - Complete node ID paths, separated by colon. - **nodeLabelPath** (String) - Node label path. - **bsrId** (String) - Best Seller Rank ID. - **bsr** (Integer) - Best Seller Rank. - **units** (Integer) - Monthly sales units. - **unitsGr** (Float) - Monthly sales growth rate. - **revenue** (Float) - Monthly revenue. - **price** (Float) - Product price. - **profit** (Float) - Product profit. - **fba** (Float) - Fulfillment by Amazon fee. - **ratings** (Integer) - Total number of ratings. - **ratingsRate** (Float) - Percentage of ratings. - **rating** (Float) - Average rating. - **ratingsCv** (Integer) - Increase in ratings. - **ratingDelta** (Integer) - Number of ratings in the last 30 days. - **availableDate** (Long) - Product availability date (timestamp). - **fulfillment** (String) - Shipping method (AMZ, FBA, FBM). - **variations** (Integer) - Number of variations. - **sellers** (Integer) - Number of sellers. - **sellerId** (String) - Seller ID. - **sellerName** (String) - Seller name. - **sellerNation** (String) - Seller's country of origin. - **badge** (Object) - Badge information. - **bestSeller** (String) - Indicates if it's a best-seller (Y/N). - **amazonChoice** (String) - Indicates if it has 'Amazon's Choice' badge (Y/N). - **newRelease** (String) - Indicates if it's a new release (Y/N). - **ebc** (String) - Indicates if it has A+ content (Y/N). - **video** (String) - Indicates if it has a video (Y/N). - **weight** (String) - Product weight. - **dimension** (String) - Product dimensions. - **dimensionsType** (String) - Type of dimensions. - **sku** (String) - SKU information. - **subcategories** (List) - List of subcategories. - **code** (String) - Subcategory code. - **rank** (Integer) - Rank within the subcategory. - **label** (String) - Subcategory label. #### Response Example ```json { "asin": "B078J8VPVW", "brand": "Pampers", "brandUrl": "https://www.amazon.com/s?k=HP", "imageUrl": "https://images-na.ssl-images-amazon.com/images/I/51axlzme6aL.AC_US200.jpg", "title": "Diapers Size 2, 186 Count - Pampers Swaddlers Disposable Baby Diapers, ONE MONTH SUPPLY", "parent": "B081RGNL17", "nodeId": 3741281, "nodeIdPath": "2619525011:3741271:3741281", "nodeLabelPath": "Baby Products:Diapering:Disposable Diapers", "bsrId": "office-products", "bsr": 1, "units": 26289, "unitsGr": -46.3, "revenue": 1693537.4, "price": 64.42, "profit": 63.92, "fba": 13.58, "ratings": 32004, "ratingsRate": 40.57, "rating": 4.8, "ratingsCv": 10666, "ratingDelta": 0, "availableDate": 1454083200000, "fulfillment": "AMZ", "variations": 7, "sellers": 7, "sellerId": "A1Y8BVAASXO4R7", "sellerName": "Amazon", "sellerNation": "see table 1.5", "badge": { "bestSeller": "Y", "amazonChoice": "N", "newRelease": "N", "ebc": "N", "video": "N" }, "weight": "8.88 pounds", "dimension": "13.3 x 15.8 x 10.6 inches", "dimensionsType": "ST,0V", "sku": "[\"Color: Beige\",\"Size: 47 inches\"]", "subcategories": [ { "code": "1063242", "rank": 1, "label": "Bath Rugs" } ] } ``` ``` -------------------------------- ### ABA Search Terms API Request Source: https://sellersprite.github.io/ Example cURL request for the ABA Search Terms API. This endpoint supports various parameters for filtering and searching. ```bash curl 'https://api.sellersprite.com/v1/aba/research' \ -H 'secret-key: your secret key' \ -H 'content-type: application/json;charset=UTF-8' \ --data-raw $'{"marketplace":"US","reverseType":"M","date":"20230610","departments":["automotive","baby-products"],"keywordList":["phone","stand"],"excludeKeywords":"portable","exactFlag":true,"searchModel":1,"page":1,"size":50,"order":{"field":"searchRank","desc":true}}' \ --compressed ```