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

# Retrieve Display Ads (Deprecated)

`GET /v1/display-ads`

> **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/autocomplete.md) · [All operations](https://skmtc.dev/constructor/apis/autocomplete/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/constructor/autocomplete/revisions/2d33330633b6/schema)