Images

Get image metadata

Public image metadata. Authenticated callers additionally get the per-viewer overlay fields (user_reported, user_claim_status); anonymous callers get false/null for them. Per-viewer, so never publicly cacheable.

get/v1/images/{id}/meta

Request

  • Base URL: https://api.memestack.ai
  • URL: https://api.memestack.ai/v1/images/{id}/meta
  • Auth: none declared

Path parameters

idstring uuid required

Response

Image metadata

idstring uuid
uploader_idstring
status'pending' | 'approved' | 'needs_review' | 'rejected'
mime_typestring
sizeinteger

Bytes of the original upload.

widthinteger

Width of the ORIGINAL upload, not of the canonical or thumbnail bytes.

heightinteger

Height of the ORIGINAL upload.

thumb_widthinteger
thumb_heightinteger
captionstring nullable
alt_textstring nullable
text_in_imagestring nullable

The text printed inside the image (OCR).

meme_template_namestring nullable

The meme template the image matched, if any.

meme_template_idstring uuid nullable
source_urlstring nullable

Where an imported image came from: a URL for a publisher import (Our World in Data, Eurostat, …), a prefix such as imgflip: or telegram: otherwise; null for a direct upload.

zap_countinteger
save_countinteger
like_countinteger
view_countinteger

Views in the last 30 days.

view_count_totalinteger

Views older than 30 days; add view_count for all recorded views.

attribution_urlstring nullable
attribution_namestring nullable
uploader_display_namestring nullable
uploader_pubkeystring nullable
uploader_has_avatarboolean
uploader_is_creatorboolean

Whether the uploader is a Verified Creator now.

uploaded_as_creatorboolean

Whether the image was uploaded as the uploader's own work.

uploader_website_urlstring nullable

The uploader's own website URL — populated only for Verified Creator uploads (null otherwise).

uploader_accepts_zapsboolean

Whether the uploader can be zapped: they have a Lightning address on their profile, or they are a system uploader (zaps on imported content go to the platform's address). Absent when the row was not joined to its uploader; treat absent as enabled.

controversialboolean

True when the image is classified controversial. Such images appear only with content=all.

is_ai_generatedboolean
has_thumbnailboolean
has_canonicalboolean

False when the original already fits the canonical size, so /canonical serves the original bytes.

has_social_cardboolean
mutation_group_idstring uuid nullable

The variant group of a meme with tracked variants.

is_dominantboolean

Whether this is the variant group's representative image.

created_atstring date-time
updated_atstring date-time
user_claim_status'pending' nullable

'pending' when the authenticated caller has an open work claim on this image; null otherwise, and always null for anonymous callers.

Example response

{
  "id": "1b856382-7fdf-4afd-8f66-ae5972989d6d",
  "status": "approved",
  "mime_type": "image/jpeg",
  "width": 419,
  "height": 235,
  "thumb_width": 419,
  "thumb_height": 235,
  "caption": "The iconic 'This is Fine' meme featuring a dog sitting calmly in a room engulfed by flames.",
  "alt_text": "A two-panel comic strip showing a dog wearing a hat sitting at a table with a mug. The entire room is on fire with thick smoke at the ceiling. In the second panel, the dog smiles and a speech bubble says, 'THIS IS FINE.'",
  "tags": [
    {
      "tag": "meme",
      "name": "Meme",
      "score": 10
    },
    {
      "tag": "cartoon",
      "name": "Cartoon",
      "score": 10
    },
    {
      "tag": "artwork",
      "name": "Artwork",
      "score": 8
    }
  ],
  "free_tags": [
    {
      "tag": "this is fine",
      "name": "This Is Fine",
      "score": 10
    },
    {
      "tag": "kc green",
      "name": "Kc Green",
      "score": 9
    },
    {
      "tag": "dog",
      "name": "Dog",
      "score": 8
    }
  ],
  "text_in_image": "THIS IS FINE.",
  "meme_template_name": "This is Fine",
  "source_url": null,
  "zap_count": 0,
  "zap_total_sats": "0",
  "save_count": 0,
  "like_count": 0,
  "controversial": false,
  "is_ai_generated": false,
  "has_thumbnail": true,
  "has_canonical": false,
  "uploader_display_name": "BTC_Boi",
  "uploaded_as_creator": false,
  "rights": {
    "source": "community",
    "publisher": null,
    "license": null,
    "license_name": null,
    "license_url": null,
    "attribution": "Uploaded by BTC_Boi via MemeStack",
    "attribution_required": false,
    "commercial_use": "unknown",
    "note": "MemeStack grants no licence to this image: its rights belong to its owner, who is usually not MemeStack and often not the uploader. The attribution records where it was found, not who owns it."
  },
  "created_at": "2026-05-07T23:53:23.224Z",
  "updated_at": "2026-07-17T22:33:04.207Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.