Amazon Seller Product Search

Publisher API

Amazon Seller Product Search is a GET endpoint on statsapi.pubadhub.com. The documented sample uses a PublisherKey header, a `q` search query, and optional `page` and `per_page` pagination parameters. The PDF states that at least one of `q` or `seller` is required.

Base URL https://statsapi.pubadhub.com

GET /api/amazon-seller-products/search

warning

Tracking

Always use redirect_url for outbound product clicks so tracking is preserved.

lock

Authentication

Send PublisherKey: {publisherkey} as an HTTP header. Your Account Manager will provide you the Publisher key. This header is required.

PublisherKey: {publisherkey}

Headers

PublisherKey REQUIRED

{publisherkey}

Your AM will provide you Publisher key.

Name	Value	Required	Description
PublisherKey	{publisherkey}	REQUIRED	Your AM will provide you Publisher key.

Query Parameters

Query parameters documented in the PDF.

q

string REQUIRED

Location: query

Search text. Maximum 255 characters. At least one of q or seller is required.

Example: office chairs

page

int OPTIONAL

Location: query

Page number for paginated results. Default: 1

Example: 1

Default: 1

per_page

int OPTIONAL

Location: query

Number of results to return per page. Default: 20. Maximum: 100.

Example: 20

Default: 20

Name	Type	Required	Location	Description	Example	Default
q	string	REQUIRED	query	Search text. Maximum 255 characters. At least one of q or seller is required.	office chairs
page	int	OPTIONAL	query	Page number for paginated results. Default: 1	1	1
per_page	int	OPTIONAL	query	Number of results to return per page. Default: 20. Maximum: 100.	20	20

Request example

curl --location --request GET 'https://statsapi.pubadhub.com/api/amazon-seller-products/search/?q=office%20chairs&page=1&per_page=20' \
--header 'PublisherKey: {publisherkey}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'q=office chair'

Response

The response returns a JSON object containing total, pagination fields, and results. HTTP status code: NEEDS_REVIEW (not specified in the PDF).

JSON

{
    "total": 1749,
    "page": 1,
    "per_page": 20,
    "last_page": 88,
    "results": [
        {
            "name": "VASAGLE Ergonomic Mesh Office Chairs with Adjustable Lumbar Support, 90-105\u00b0 Tilt Function, Wide Seat, Flip-Up Armrests, Computer Desk Chairs for Home Office, Set of 2, Dove Gray",
            "description": "VASAGLE Ergonomic Mesh Office Chairs with Adjustable Lumbar Support, 90-105\u00b0 Tilt Function, Wide Seat, Flip-Up Armrests, Computer Desk Chairs for Home Office, Set of 2, Dove Gray",
            "manufacturer": null,
            "category": null,
            "catalog_name": "Imported Amazon Catalog",
            "asin": null,
            "current_price": "151.9800",
            "image_url": "https://m.media-amazon.com/images/I/61pRDTVu0eL._AC_SL1500_.jpg",
            "stock_availability": "InStock",
            "redirect_url": "https://ck.pubadhub.com/track?encyp=0u8IgckyXQH2G6xy32SpdtkE42UAm3Lfc5zn9fXLtt0KBdHFKJWHsaXylpDkKegr&clickid={PublisherClickID}&dl=https%3A%2F%2Fvasagleamazonsellerus.sjv.io%2Fc%2F6338938%2F3406431%2F45455%3Fprodsku%3DB0H6WWGF14%26u%3Dhttps%253A%252F%252Fwww.amazon.com%252Fdp%252FB0H6WWGF14%26intsrc%3DAPIG_29111&subi={SubId}&psorc={PUBLISHERSOURCE}&cc=US"
        }
    ]
}

Response fields

total Integer

Total number of matching products returned.

page Integer

Current page number of the returned results.

per_page Integer

Number of results returned per page. Maximum: 100.

last_page Integer

Total number of available pages based on the current per_page value.

results Array

List of matching products, ordered by relevance.

name String / Null

Product name or title.

description String / Null

Product description.

manufacturer String / Null

Product manufacturer or brand.

category String / Null

Product category.

catalog_name String / Null

Catalog name.

asin String / Null

Amazon ASIN.

current_price String / Null

Product price returned with 4 decimal places.

image_url String / Null

Product image URL.

stock_availability String / Null

Stock status, such as InStock or OutOfStock.

redirect_url String / Null

PubAdHub tracking URL to use for outbound product clicks.

Name	Type	Description
total	Integer	Total number of matching products returned.
page	Integer	Current page number of the returned results.
per_page	Integer	Number of results returned per page. Maximum: 100.
last_page	Integer	Total number of available pages based on the current per_page value.
results	Array	List of matching products, ordered by relevance.
name	String / Null	Product name or title.
description	String / Null	Product description.
manufacturer	String / Null	Product manufacturer or brand.
category	String / Null	Product category.
catalog_name	String / Null	Catalog name.
asin	String / Null	Amazon ASIN.
current_price	String / Null	Product price returned with 4 decimal places.
image_url	String / Null	Product image URL.
stock_availability	String / Null	Stock status, such as InStock or OutOfStock.
redirect_url	String / Null	PubAdHub tracking URL to use for outbound product clicks.

Notes

info

Always use redirect_url for outbound product clicks so tracking is preserved.

info

The response returns a JSON object containing total and results.

Original PDF

This page is sourced from the official API PDF. The original file remains available.

picture_as_pdf View Original PDF download Download PDF

Amazon Seller Product Search.pdf

arrow_back Click-Level Conversion Report

Affiliate Product Search arrow_forward

play_circle

Try it out

Fill the fields below, copy the generated cURL, or send a live request.

GET https://statsapi.pubadhub.com/api/amazon-seller-products/search

cURL

Response Status: