Skip to main content
GET
Get posts tagged with a specific product

Authorizations

x-api-key
string
header
required

Path Parameters

id
string
required

Product identifier, interpreted according to the id_type query parameter: the product's external ID (default), or a manufacturer part number when id_type=mpn

Example:

"product123"

Query Parameters

limit
number
default:25

Max value for limit is 25

Required range: 1 <= x <= 25
Example:

10

skip
number | null
default:0

Number of items to skip

Required range: x >= 0
Example:

0

market
string

Market ID or shortId for localized content

Example:

"us"

filter
string

JSON string array of filter criteria. See Core Concepts → Filtering for detailed filter structure and supported operators.

Example:

"[{\"type\":\"label\",\"operator\":\"OR\",\"values\":[\"507f1f77bcf86cd799439011\",\"507f191e810c19729de860ea\"]}]"

id_type
enum<string>

How the {id} path parameter resolves to products. 'external_id' (default) matches the single product with that id from your platform. 'mpn' matches every product carrying that manufacturer part number and returns posts tagged with any of them, including color- and product-level tags on grouped products. An mpn matching more than 500 products returns 400.

Available options:
external_id,
mpn
Example:

"mpn"

Response

Successful response

count
number
required

Total number of items

next
string | null
required

URL for next page

nodes
object[]
required