---
title: "List and search meme templates"
method: GET
path: "/memes/templates"
tags: ["Media"]
---

# List and search meme templates

`GET /memes/templates`

## Request

- Base URL: `https://app.openpo.st/api/v1`
- URL: `https://app.openpo.st/api/v1/memes/templates`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `openpost_session`

## Query parameters

- `workspace_id` string, required: Workspace ID
- `q` string: Template name, keyword, or example text
- `limit` integer: Maximum templates to return

## Response `200`

OK

- ListMemeTemplatesOutputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `ai_configured` boolean, required: Whether AI meme suggestions are configured
  - `catalog` MemeCatalogMetadata, required
    - `provider_key` string: Configured meme renderer key
    - `refreshed_at` string: Time the provider catalog was refreshed
    - `returned` integer, required: Templates returned by this request
    - `revision` string: Stable digest of the normalized catalog snapshot
    - `stale` boolean, required: Whether a stale cached catalog is being served
    - `total_templates` integer, required: Templates in the full cached catalog
  - `configured` boolean, required: Whether a meme renderer is configured
  - `templates` Template[], nullable, required
    - `animated` boolean, required
    - `blank_url` string, required
    - `example` TemplateExample, required
      - `text` string[], nullable, required
      - `url` string, required
    - `id` string, required
    - `keywords` string[], nullable, required
    - `lines` integer, required
    - `name` string, required
    - `overlays` integer, required
    - `search_terms` string[], nullable, required
    - `semantic` TemplateSemantic, required
      - `caption_roles` string[], nullable, required
      - `meaning` string, required
      - `mechanism` string, required
      - `tags` string[], nullable, required
      - `visual` string, required
    - `source_url` string, required
    - `styles` string[], nullable, required

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `500`: Internal Server Error
- `502`: Bad Gateway
- `503`: Service Unavailable

---

[API](https://skmtc.dev/openpo/apis/openpost-api.md) · [All operations](https://skmtc.dev/openpo/apis/openpost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openpo/apis/openpost-api/revisions/67d3964458a7?raw)