search_templates

search_templates ranks templates against a situation, an optional published tag, and optional keyword filters. It does not generate captions. It does not return pixels.

Call search_templates with query "standup that could have been an email" and tell me the top three slugs and box counts.

Arguments

• query (string, 1-500): situation, format name, or catalog slug. Optional if you pass tag or keywords.
• tag (string): published tag slug such as spongebob-memes.
• keywords (string[], max 12): OR filters against name, slug, and catalog keywords.
• limit (int, 1-25): default 10.

Provide at least one of query, tag, or keywords.

Request

{
  "query": "standup that could have been an email",
  "limit": 5
}

Response

Each hit looks like:

{
  "slug": "drake-hotline-bling",
  "title": "Drake Hotline Bling",
  "boxCount": 2,
  "imageUrl": "https://cdn.magicmeme.com/templates/drake-hotline-bling.png",
  "keywords": []
}

imageUrl is the blank template. Don't treat it as a finished meme.

An empty array means nothing scored. Try a shorter query or a format name. Don't invent a slug.

What to explore next

• get_template for boxes and the caption formula
• generate_meme_captions when you are ready to write
• render_meme_still after you have captions