Sign inConnect your AI
api

Media links

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

Updated · API v1

Fields such as media_url, poster_url, media_urls, thumb_url and logo_url hold links of the form 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.