Search

Reverse image search by phash

Find approved images visually similar to an arbitrary input image. Accepts an HTTPS URL or a data:image/(jpeg|png|webp);base64,... URL. SSRF-hardened (private IP / cloud metadata / DNS rebind blocked). Rate limited 10/min/IP via KV. Maximum 8 MB input.

post/v1/images/reverse-search

Request

  • Base URL: https://api.memestack.ai
  • URL: https://api.memestack.ai/v1/images/reverse-search
  • Auth: none declared

Request body

urlstring required

HTTPS URL or data: URL of the image to search by.

limitinteger
content'safe' | 'all'

Safe by default: 'safe' (the default) excludes matches classified controversial; 'all' includes them, each carrying controversial: true. Case-insensitive; any other value is 400 INVALID_CONTENT.

Response

Visually similar images, sorted by Hamming distance (nearest first).

countinteger

Example response

{
  "results": [
    {
      "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.