Skip to main content
GET
Count Products

Authorizations

Authorization
string
header
required

Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows.

Query Parameters

status
string

Filter by one catalog view status. Lifecycle values include draft, active, archived and deleted; derived views include flagged, errors, qc_pending and qc_rejected. A product may have a lifecycle value and multiple derived signals simultaneously.

marketplace
enum<string>

Filter by enabled marketplace.

Available options:
shopee,
lazada,
tiktok,
shopify,
whatsapp,
zalora,
amazon,
ebay
country
string

Filter by marketplace country (e.g., Singapore, Malaysia).

Maximum string length: 80
q
string

Search query for product name or SKU.

Maximum string length: 200
sku
string

Exact catalog SKU match after trim. Not fuzzy and not substring. Repeat the parameter or comma-separate up to 50 SKUs. Combined with other filters using AND.

Maximum string length: 200
minPrice
number

Minimum price filter.

Required range: x >= 0
maxPrice
number

Maximum price filter.

Required range: x >= 0
store
string

Exact marketplace account/store IDs, comma-separated. Combine with marketplace, or use storeKeys for exact platform/country/store identity.

storeKeys
string

Comma-separated marketplace:country:storeId keys (up to 50), matching the Products page. Missing account IDs never match another store.

brands
string

JSON array of marketplace-prefixed brand names, matching the Products page.

bundleType
enum<string>
Available options:
,
hard,
virtual,
non_bundle
language
string
hasImage
enum<string>
Available options:
yes,
no
stock
enum<string>
Available options:
in_stock
publishedFrom
string

Inclusive publication date or exact ISO timestamp.

publishedTo
string

Inclusive publication date (whole local day), or exact ISO timestamp.

publishedTimeZone
string

IANA time zone for date-only publication bounds.

Response

Matching catalog product count

count
integer
required
Required range: x >= 0
unit
enum<string>
required
Available options:
catalog_products
filters
object
required

Normalized Products page filters used for this count.