Get Creative Ads
POST/server/v2/ads
Request ads each time a user visits a page on your platform where ads should appear. Include the ID of each Ad Placement you created for this page to specify the type and quantity of ads to return for each placement.
Supported ad formats: in addition to Sponsored Product, Sponsored Display, Sponsored Display with Product, and Display Sponsored Brand shown below, the platform also serves CROSS_SELL (request/response structure mirrors Sponsored Product) and VIDEO_WITH_PRODUCT (request/response structure mirrors Sponsored Display with Product). Use the same request body — placement type is inferred from the configured Ad Placement.
Request
Responses
- 200
- 204
- 400
- 401
- 403
- 404
- 500
- 503
Ads found
No relevant ads were found
Bad Request
Unauthorized
Forbidden
Marketplace Not Found
Internal Server Error
Service Unavailable