# Media links

Adspy API · https://www.adspy.sh/docs/api/media-links · Updated October 24, 2026

Media fields hold signed links: use them directly, refresh them by reading the record again.

## Signed links

Fields such as media_url, poster_url, media_urls, thumb_url and logo_url hold links of the form https://www.adspy.sh/media/{id}?grant={signature}. They work without the API key, so an image tag, a download job or a worker can read them.

- A link is valid 21 days. After that it answers 403; read the record again for a fresh link.
- Treat links as private to your organization: anyone with a link can open it until it expires.
- Store the record's id, not the link, when you keep data longer.
- A creative whose media could not be stored has media_availability and media_unavailable_reason instead of a broken link.