---
title: "Resolve a public meme share URL through oEmbed"
method: GET
path: "/api/oembed"
tags: ["memes", "discovery"]
---

# Resolve a public meme share URL through oEmbed

`GET /api/oembed`

## Request

- Base URL: `https://memesio.com`
- URL: `https://memesio.com/api/oembed`
- Auth: none required

Returns an oEmbed 1.0 link response for one canonical public Memesio share URL. The response intentionally does not reproduce the meme image or grant reuse rights. Private, flagged, removed, and unknown memes return 404.

## Query parameters

- `url` string, uri, required
- `format` 'json'

## Response `200`

oEmbed link response

- object
  - `version` '1.0', required
  - `type` 'link', required
  - `title` string, required
  - `provider_name` 'Memesio', required
  - `provider_url` string, uri, required
  - `cache_age` string, required

## Other responses

- `400`: Missing, malformed, external, or noncanonical share URL
- `404`: Public meme not found
- `501`: Requested response format is not supported
- `503`: oEmbed storage dependency is unavailable

## Changes

- **2026-11-03** `68ea65600c30`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/memesio/apis/memesio-api-contracts/changes/api/oembed/get.md)

---

[API](https://skmtc.dev/memesio/apis/memesio-api-contracts.md) - [All operations](https://skmtc.dev/memesio/apis/memesio-api-contracts/llms.txt) - [OpenAPI document](https://skmtc.dev/memesio/apis/memesio-api-contracts/revisions/68ea65600c30?raw)