get
https://{yourinstance}.makaira.io/placement
Returns a list of all advertising placements (manual product list placements) for the current instance.
Requires authentication.
Request
GET /placement
Headers
| Header | Value |
|---|---|
Authorization | Bearer <token> |
Response
Returns a JSON array of placement objects.
Response Body
| Field | Type | Description |
|---|---|---|
id | integer | Unique placement ID. |
name | string | Placement name. |
active | boolean | Whether the placement is active. |
listType | string | The page type: search, category, or manufacturer. |
identifier | array | Array of identifiers (search terms, category IDs, etc.) that trigger this placement. |
items | array | Manually configured product items in this placement. |
Successful response