---
title: "Retrieve Display Ads (Deprecated)"
method: GET
path: "/v1/display-ads"
tags: ["Display Ads"]
deprecated: true
---

# Retrieve Display Ads (Deprecated)

`GET /v1/display-ads`

## Request

- Base URL: `https://display.media-cnstrc.com`
- URL: `https://display.media-cnstrc.com/v1/display-ads`
- Auth: none required

> **Deprecated.**

Retrieves an ad for each of the given placement IDs. If no ad is available for a placement ID, the placement ID will be missing from the response.

## Query parameters

- `key` string, required: The key of the index to use.
- `placement_ids` string[], required: List of placement IDs.
- `query` string, nullable: Search query for keyword targeting.
- `filter_name` string, nullable: The name of the related browse filter.
- `filter_value` string, nullable: The value of the related browse filter.

## Response `200`

Successful Response.

- DisplayAdsResponse
  - `display_ads` object, required: Map of placement IDs to Display Ads. If a placement ID is missing it means that there are no available ads for that placement.

## Other responses

- `400`: Bad Request.

---

[API](https://skmtc.dev/constructor/apis/retail-media-display-ads.md) - [All operations](https://skmtc.dev/constructor/apis/retail-media-display-ads/llms.txt) - [OpenAPI document](https://skmtc.dev/constructor/apis/retail-media-display-ads/revisions/12d74d29f80f?raw)