# EU Audiovisual Service Media API

> EU Audiovisual Service: 1.2 million EU photos, videos and podcasts, searchable by keyword and date

- Vendor: `euaudiovisualservicemediaapi` · version 1.0 · category Video & Images · tags eu audiovisual api, eu videos api, press photos api, eu media library api, european union images api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/euaudiovisualservicemediaapi
- This document: https://apiclay.com/docs/euaudiovisualservicemediaapi.md
- OpenAPI 3.1: https://apiclay.com/api/euaudiovisualservicemediaapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `euaudiovisualservicemediaapi`
- Updated: 2026-11-18

## About

## EU Audiovisual Service Media API

The media library behind the European Commission's Audiovisual Service: about 1.2 million photos, videos, video shots, podcasts, reportages and events from the EU institutions, searchable by media type, keyword and date range, each with reference, multilingual titles and summaries, date, place, personalities, themes, tags, image renditions or video streams, copyright and CC BY flag; one item in full by reference; and the curated stores (latest videos, news and stock-shot videos, podcasts, EU history collections, milestones, who's who) and focus collections.

Data comes from **audiovisual.ec.europa.eu** (https://audiovisual.ec.europa.eu). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/search?mediaType=PHOTO&amp;keywords=climate&amp;limit=20&amp;offset=1`, narrow with `startDate=20200101&amp;endDate=20201231`, then `/media?reference=`; `/store?store=LATEST_VIDEOS&amp;limit=10` for the newest.

### Routes

#### GET `/search` - Search media
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| mediaType | query | string | yes | `ALL`, `PHOTO`, `VIDEO`, `VIDEOSHOT`, `PODCAST`, `AUDIO`, `REPORTAGE`, `EVENT`, `COLLECTION` or `EVENTPLANNING`. |
| keywords | query | string | no | Words to match, e.g. `climate`. |
| startDate | query | string | no | From date, `YYYYMMDD`, e.g. `20200101`. |
| endDate | query | string | no | To date, `YYYYMMDD`. |
| limit | query | number | no | Items per page, e.g. 20. |
| offset | query | number | no | Position of the first item, from 1 (21 for the second page of 20). |

Returns: `completeItemsCount` and `items` array, newest first: `reference`, `type`, `titles` and `summaries` (per language), `startDateTime`, `personalities`, `themes`, `tags`, `locations`, `thumbnailUrl`, `imagesByQualities` (photos), `copyright`, `ccBy`, `views`.

#### GET `/media` - Media item
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| reference | query | string | yes | Item `reference`, e.g. `I-297756` (video) or `P-070933/00-04` (photo). |

Returns: The item in full: titles, summaries, `place`, `duration`, `languages`, institutions, personalities, projects, `files`, `hls` video streams or image renditions, `status`.

#### GET `/store` - Store
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| store | query | string | yes | `LATEST_VIDEOS`, `LATEST_NEWS_VIDEOS`, `LATEST_CLIPS_VIDEOS`, `LATEST_STOCKSHOTS_VIDEOS`, `LATEST_UPCOMING_VIDEOS`, `LATEST_HIGHLIGHTED_VIDEOS`, `LATEST_NEWS_REPORTAGES`, `LATEST_PORTRAITS_REPORTAGES`, `ALL_PODCASTS`, `ALL_MILESTONES`, `ALL_EU_HISTORY_COLLECTIONS`, `ALL_FOCUSED_COLLECTIONS`, `WHOSWHO_COLLECTION` and others. |
| limit | query | number | no | Items to return. |

Returns: `completeItemsCount` and `items` in the search format.

#### GET `/focus-collections` - Focus collections
No parameters.

Returns: `completeItemsCount` and `items`: the current focus collections (summits, visits, campaigns) with titles, summaries and dates.

### Caveats

- Media are copyright of the European Union or the named photographer; reuse terms are in each item's `copyright` and `ccBy` fields, and the Audiovisual Service asks for a credit line. Titles and summaries can contain HTML.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by audiovisual.ec.europa.eu.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /search — Search media
- Gateway: `GET https://api.apiclay.com/v1/api/euaudiovisualservicemediaapi/search`
- Public query params: `mediaType` (string, required), `keywords` (string), `startDate` (string), `endDate` (string), `limit` (number), `offset` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /media — Media item
- Gateway: `GET https://api.apiclay.com/v1/api/euaudiovisualservicemediaapi/media`
- Public query params: `reference` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /store — Store
- Gateway: `GET https://api.apiclay.com/v1/api/euaudiovisualservicemediaapi/store`
- Public query params: `store` (string, required), `limit` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /focus-collections — Focus collections
- Gateway: `GET https://api.apiclay.com/v1/api/euaudiovisualservicemediaapi/focus-collections`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/euaudiovisualservicemediaapi/search?mediaType=<mediaType>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
