---
title: "Search the ad library"
description: "Search ad creatives we have already indexed. Fast, cached, and read-only."
url: https://docs.roasos.com/api-reference/discover/listDiscoverItems
---

# Search the ad library

Search ad creatives we have already indexed. Fast, cached, and read-only.

## `GET /v1/discover/items`

Endpoint: `GET https://api.roasos.com/v1/discover/items`

Search the ad library

Search ad creatives we have already indexed. Fast, cached, and read-only.

### Parameters

- `view` (query)
- `sources` (query)
- `brand_ids` (query)
- `media_types` (query)
- `since` (query)
- `query` (query)
- `sort` (query)
- `undefined`
- `undefined`

### Responses

- `200`: One bounded page of normalized cached creatives
- `400`: Invalid or unsupported filter or cursor
- `403`: API key no longer has exact Discover read authority
- `503`: Discover read authority or normalized projection is unavailable

Read the full reference at https://docs.roasos.com/api-reference/discover/listDiscoverItems.