MemeStack

{'type': 'object', 'required': ['category'], 'properties': {'category': {'type': 'string', 'description': 'Category slug (e.g. "charts", "memes")'}}}

{'type': 'object', 'required': ['featured_images'], 'properties': {'name': {'type': 'string', 'description': 'Category display name.'}, 'slug': {'type': 'string', 'description': 'Category slug.'}, 'description': {'type': ['string', 'null'], 'description': 'Category description.'}, 'featured_images': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (lean list fields) with attribution.', 'additionalProperties': True}, 'description': 'Featured images in the category.'}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'description': 'A category profile plus its featured images and combined citations.', 'additionalProperties': True}

{'type': 'object', 'required': ['tag'], 'properties': {'tag': {'type': 'string', 'description': 'Tag slug (e.g. "bitcoin", "meme", "lightning")'}, 'limit': {'type': 'number', 'description': 'Images per page (1-50, default 10). When provided, images are included in the response.'}, 'offset': {'type': 'number', 'description': 'Pagination offset (default 0)'}, 'include_controversial': {'type': 'boolean', 'description': 'Include images classified controversial (excluded by default).'}}}

{'type': 'object', 'required': ['images'], 'properties': {'name': {'type': 'string', 'description': 'Tag display name.'}, 'slug': {'type': 'string', 'description': 'Tag slug.'}, 'total': {'type': 'number', 'description': 'Total matching images.'}, 'images': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (lean list fields) with attribution.', 'additionalProperties': True}, 'description': 'Images with this tag.'}, 'description': {'type': ['string', 'null'], 'description': 'Tag description.'}, 'image_count': {'type': 'number', 'description': 'Number of images with this tag.'}, 'related_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Related tag slugs.'}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'description': 'A tag profile plus its images and combined citations.', 'additionalProperties': True}

{'type': 'object', 'properties': {'tag': {'type': 'string', 'description': 'Filter by tag slug (e.g. "bitcoin", "meme")'}, 'sort': {'enum': ['newest', 'popular', 'oldest', 'trending'], 'type': 'string', 'description': 'Sort order (default: newest)'}, 'limit': {'type': 'number', 'description': 'Results per page (1-50, default 10)'}, 'offset': {'type': 'number', 'description': 'Pagination offset (default 0)'}, 'include_controversial': {'type': 'boolean', 'description': 'Include images classified controversial (excluded by default).'}}}

{'type': 'object', 'required': ['images', 'total'], 'properties': {'total': {'type': 'number', 'description': 'Total number of matching images.'}, 'images': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (lean list fields) with attribution.', 'additionalProperties': True}, 'description': 'Images in the requested view.'}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'additionalProperties': True}

{'type': 'object', 'required': ['image_ids'], 'properties': {'image_ids': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 50, 'minItems': 1, 'description': 'Up to 50 image UUIDs'}}}

{'type': 'object', 'required': ['citations', 'combined', 'missing_ids'], 'properties': {'combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}, 'citations': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'markdown', 'html', 'plain'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}}, 'additionalProperties': True}, 'description': 'One citation per resolved image ID.'}, 'missing_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Requested IDs that could not be resolved.'}}, 'description': 'Per-image and combined citations for the requested image IDs.', 'additionalProperties': True}

{'type': 'object', 'required': ['vibe'], 'properties': {'vibe': {'type': 'string', 'description': 'The vibe, topic, or idea you want a meme for'}, 'limit': {'type': 'number', 'description': 'How many memes to return (1-20, default 5)'}, 'include_controversial': {'type': 'boolean', 'description': 'Include images classified controversial (excluded by default).'}}}

{'type': 'object', 'required': ['images'], 'properties': {'note': {'type': 'string', 'description': 'Present when the first page has no strong result: says so and that the results are the closest available.'}, 'images': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (lean list fields) with attribution.', 'additionalProperties': True}, 'description': 'Memes that capture the requested vibe.'}, 'has_more': {'type': 'boolean', 'description': 'Present when the API labelled the results: true when more results follow this page.'}, 'query_language': {'type': 'string', 'description': 'Present with translated_query: the ISO 639-1 code of the query language, e.g. "fr".'}, 'translated_query': {'type': 'string', 'description': 'Present only when the query was not English: the English text it was also searched as (those results are merged in).'}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'additionalProperties': True}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Source image UUID'}, 'limit': {'type': 'number', 'description': 'Max results (1-20, default 10)'}, 'include_controversial': {'type': 'boolean', 'description': 'Include images classified controversial (excluded by default).'}}}

{'type': 'object', 'required': ['images', 'count'], 'properties': {'count': {'type': 'number', 'description': 'Total number of matching images.'}, 'images': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'similarity': {'type': 'number', 'description': 'Visual-similarity score (find_similar / reverse_image_search).'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'relevance_score': {'type': 'number', 'description': 'Semantic-relevance score (find_related).'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (compact fields) with a ranking score and attribution.', 'additionalProperties': True}, 'description': 'Semantically related images.'}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'additionalProperties': True}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Source image UUID'}, 'limit': {'type': 'number', 'description': 'Max results (1-20, default 10)'}, 'include_controversial': {'type': 'boolean', 'description': 'Include images classified controversial (excluded by default).'}}}

{'type': 'object', 'required': ['images', 'count'], 'properties': {'count': {'type': 'number', 'description': 'Total number of matching images.'}, 'images': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'similarity': {'type': 'number', 'description': 'Visual-similarity score (find_similar / reverse_image_search).'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'relevance_score': {'type': 'number', 'description': 'Semantic-relevance score (find_related).'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (compact fields) with a ranking score and attribution.', 'additionalProperties': True}, 'description': 'Visually similar images.'}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'additionalProperties': True}

{'type': 'object', 'required': ['prompt'], 'properties': {'mode': {'enum': ['standard', 'quality'], 'type': 'string', 'description': 'Generation quality tier - "standard" (default, cheaper) or "quality" (higher fidelity, costs more).'}, 'prompt': {'type': 'string', 'maxLength': 2000, 'description': 'Text description of the image to generate (max 2000 characters).'}, 'aspect_ratio': {'enum': ['1:1', '3:4', '16:9'], 'type': 'string', 'description': 'Output image aspect ratio (default "1:1").'}}}

{'type': 'object', 'required': ['image_id', 'url', 'image_url', 'thumbnail_url'], 'properties': {'url': {'type': 'string', 'description': 'MemeStack gallery page URL for the generated image.'}, 'tags': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Scored tags assigned to the generated image.'}, 'caption': {'type': ['string', 'null'], 'description': 'AI-generated caption for the image.'}, 'image_id': {'type': 'string', 'description': 'UUID of the generated image.'}, 'image_url': {'type': 'string', 'description': 'Direct serve URL for the full generated image bytes.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail URL for the generated image.'}}, 'description': 'The AI-generated image produced by a paid generate_meme call.', 'additionalProperties': True}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID'}}}

{'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'size': {'type': 'number', 'description': 'File size in bytes.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'alt_text': {'type': 'string', 'description': 'Accessible alt text.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'mime_type': {'type': 'string', 'description': 'Image MIME type.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'updated_at': {'type': 'string', 'description': 'ISO 8601 last-updated timestamp.'}, 'thumb_width': {'type': 'number', 'description': 'Thumbnail width in pixels.'}, 'thumb_height': {'type': 'number', 'description': 'Thumbnail height in pixels.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'quality_score': {'type': 'number', 'description': 'AI quality score (1-10).'}, 'text_in_image': {'type': ['string', 'null'], 'description': 'OCR transcription of any text in the image.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (full detail) with OCR text, dimensions, and attribution.', 'additionalProperties': True}

{'type': 'object', 'required': ['type'], 'properties': {'type': {'enum': ['images', 'zappers'], 'type': 'string', 'description': 'Leaderboard type'}, 'period': {'enum': ['day', 'week', 'month', 'all'], 'type': 'string', 'description': 'Time period (default: week)'}}}

{'type': 'object', 'properties': {'users': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'User UUID.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 account-creation timestamp.'}, 'has_avatar': {'type': 'boolean', 'description': 'Whether the user has an avatar.'}, 'display_name': {'type': ['string', 'null'], 'description': 'Display name.'}, 'approved_image_count': {'type': 'number', 'description': 'Number of approved uploads.'}}, 'description': 'A public user profile (pubkey and role omitted).', 'additionalProperties': True}, 'description': 'Top zappers (zappers leaderboard).'}, 'images': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (lean list fields) with attribution.', 'additionalProperties': True}, 'description': 'Top images (images leaderboard).'}, 'period': {'type': 'string', 'description': 'The leaderboard period.'}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'description': 'Leaderboard results — `images` for the images board, `users` for the zappers board.', 'additionalProperties': True}

{'type': 'object', 'required': ['image_id'], 'properties': {'image_id': {'type': 'string', 'description': 'Image UUID'}}}

{'type': 'object', 'required': ['dominant', 'variants'], 'properties': {'dominant': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'size': {'type': 'number', 'description': 'File size in bytes.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'alt_text': {'type': 'string', 'description': 'Accessible alt text.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'mime_type': {'type': 'string', 'description': 'Image MIME type.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'updated_at': {'type': 'string', 'description': 'ISO 8601 last-updated timestamp.'}, 'thumb_width': {'type': 'number', 'description': 'Thumbnail width in pixels.'}, 'thumb_height': {'type': 'number', 'description': 'Thumbnail height in pixels.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'quality_score': {'type': 'number', 'description': 'AI quality score (1-10).'}, 'text_in_image': {'type': ['string', 'null'], 'description': 'OCR transcription of any text in the image.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (full detail) with OCR text, dimensions, and attribution.', 'additionalProperties': True}, 'variants': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (lean list fields) with attribution.', 'additionalProperties': True}, 'description': 'Variant images in the group.'}, 'total_variants': {'type': 'number', 'description': 'Number of variants.'}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'description': 'A meme-evolution group: the dominant image plus its variants.', 'additionalProperties': True}

{'type': 'object', 'required': ['tag'], 'properties': {'tag': {'type': 'string', 'description': 'Tag slug (e.g. "bitcoin", "meme")'}}}

{'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Tag display name.'}, 'slug': {'type': 'string', 'description': 'Tag slug.'}, 'description': {'type': ['string', 'null'], 'description': 'Tag description.'}, 'image_count': {'type': 'number', 'description': 'Number of images with this tag.'}, 'related_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Related tag slugs.'}}, 'description': 'A tag profile (description, related tags, stats) without images.', 'additionalProperties': True}

{'type': 'object', 'required': ['identifier'], 'properties': {'identifier': {'type': 'string', 'description': 'User public key (hex) or UUID'}}}

{'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'User UUID.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 account-creation timestamp.'}, 'has_avatar': {'type': 'boolean', 'description': 'Whether the user has an avatar.'}, 'display_name': {'type': ['string', 'null'], 'description': 'Display name.'}, 'approved_image_count': {'type': 'number', 'description': 'Number of approved uploads.'}}, 'description': 'A public user profile (pubkey and role omitted).', 'additionalProperties': True}

{'type': 'object', 'properties': {}}

{'type': 'object', 'properties': {'categories': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Display name.'}, 'slug': {'type': 'string', 'description': 'Category slug.'}, 'description': {'type': 'string', 'description': 'Category description.'}, 'image_count': {'type': 'number', 'description': 'Number of images in the category.'}}, 'description': 'A content category.', 'additionalProperties': True}, 'description': 'The full category list.'}}, 'description': 'All content categories.', 'additionalProperties': True}

{'type': 'object', 'properties': {'limit': {'type': 'number', 'description': 'How many tags to return (1-100, default 20)'}}}

{'type': 'object', 'properties': {'tags': {'type': 'array', 'items': {'type': 'object', 'properties': {'tag': {'type': 'string', 'description': 'Tag slug.'}, 'name': {'type': 'string', 'description': 'Display name.'}, 'usage_count': {'type': 'number', 'description': 'Number of images using this tag.'}}, 'description': 'A tag with usage stats.', 'additionalProperties': True}, 'description': 'Tags ordered by usage.'}}, 'description': 'The most-used tags by image count.', 'additionalProperties': True}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'HTTPS image URL, or data:image/(jpeg|png|webp);base64,... URL'}, 'limit': {'type': 'number', 'description': 'Max results (1-20, default 10)'}, 'include_controversial': {'type': 'boolean', 'description': 'Include images classified controversial (excluded by default).'}}}

{'type': 'object', 'required': ['similar'], 'properties': {'similar': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'similarity': {'type': 'number', 'description': 'Visual-similarity score (find_similar / reverse_image_search).'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'relevance_score': {'type': 'number', 'description': 'Semantic-relevance score (find_related).'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (compact fields) with a ranking score and attribution.', 'additionalProperties': True}, 'description': 'Visually similar images.'}, 'input_meta': {'type': 'object', 'properties': {'phash': {'type': 'string', 'description': 'Perceptual hash of the input.'}, 'mime_type': {'type': 'string', 'description': 'Input MIME type.'}, 'size_bytes': {'type': 'number', 'description': 'Input size in bytes.'}}, 'description': 'Computed metadata for the input image.', 'additionalProperties': True}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'description': 'Visually similar gallery images for the input image, plus input metadata.', 'additionalProperties': True}

{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'number', 'description': 'Results per page (1-50, default 10)'}, 'query': {'type': 'string', 'description': 'What the chart should show, in plain words - e.g. "global cereal yields" or "life expectancy by country".'}, 'offset': {'type': 'number', 'description': 'Pagination offset (default 0)'}, 'region': {'type': 'string', 'description': 'Restrict to charts that plot this entity exactly as the chart names it, e.g. "World", "Germany".'}, 'data_to': {'type': 'number', 'description': 'Latest year of interest. See data_from.'}, 'data_from': {'type': 'number', 'description': "Earliest year of interest. Matches charts whose DISPLAYED period overlaps [data_from, data_to]. Charts with no provable displayed period are excluded, and the underlying dataset's wider history is never used for this test."}, 'chart_source': {'type': 'string', 'description': 'Restrict to one upstream source key: "owid" (Our World in Data), "usda_ers" (USDA Economic Research Service), "eurostat" or "eea" (European Environment Agency).'}, 'include_controversial': {'type': 'boolean', 'description': 'Include images classified controversial (excluded by default).'}}}

{'type': 'object', 'required': ['images', 'total'], 'properties': {'note': {'type': 'string', 'description': 'Present when the first page has no strong result: says so and that the results are the closest available.'}, 'total': {'type': 'number', 'description': 'Total number of matching images.'}, 'images': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (lean list fields) with attribution.', 'additionalProperties': True}, 'description': 'Images that HAVE stored chart metadata, best-first. Every item carries a populated chart block (source, citation, unit, regions, displayed period).'}, 'has_more': {'type': 'boolean', 'description': 'Present when the API labelled the results: true when more results follow this page.'}, 'query_language': {'type': 'string', 'description': 'Present with translated_query: the ISO 639-1 code of the query language, e.g. "fr".'}, 'translated_query': {'type': 'string', 'description': 'Present only when the query was not English: the English text it was also searched as (those results are merged in).'}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'additionalProperties': True}

{'type': 'object', 'required': ['query'], 'properties': {'q': {'type': 'string', 'description': 'Alias for `query`. Provided so REST-API muscle memory (?q=...) works on the MCP tool too. If both are set, `query` wins.'}, 'tag': {'type': 'string', 'description': 'Filter results by a single tag slug (backward compat)'}, 'sort': {'enum': ['newest', 'popular', 'oldest'], 'type': 'string', 'description': 'Sort order (default: relevance)'}, 'tags': {'type': 'string', 'description': 'Filter results by multiple tag slugs (comma-separated, AND logic - e.g. "bitcoin,meme")'}, 'limit': {'type': 'number', 'description': 'Results per page (1-50, default 10)'}, 'query': {'type': 'string', 'description': 'Search query - combines semantic AI and keyword matching automatically. Alias: `q` (matches the REST API param name).'}, 'offset': {'type': 'number', 'description': 'Pagination offset (default 0)'}, 'include_controversial': {'type': 'boolean', 'description': 'Include images classified controversial (excluded by default).'}}}

{'type': 'object', 'required': ['images', 'total'], 'properties': {'note': {'type': 'string', 'description': 'Present when the first page has no strong result: says so and that the results are the closest available.'}, 'total': {'type': 'number', 'description': 'Total number of matching images.'}, 'images': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (lean list fields) with attribution.', 'additionalProperties': True}, 'description': 'Matching images, best-first.'}, 'has_more': {'type': 'boolean', 'description': 'Present when the API labelled the results: true when more results follow this page.'}, 'query_language': {'type': 'string', 'description': 'Present with translated_query: the ISO 639-1 code of the query language, e.g. "fr".'}, 'translated_query': {'type': 'string', 'description': 'Present only when the query was not English: the English text it was also searched as (those results are merged in).'}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'additionalProperties': True}

{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'number', 'description': 'Results per page (1-50, default 10)'}, 'query': {'type': 'string', 'description': 'Text to search for in image OCR'}, 'offset': {'type': 'number', 'description': 'Pagination offset'}, 'include_controversial': {'type': 'boolean', 'description': 'Include images classified controversial (excluded by default).'}}}

{'type': 'object', 'required': ['images', 'total'], 'properties': {'note': {'type': 'string', 'description': 'Present when the first page has no strong result: says so and that the results are the closest available.'}, 'total': {'type': 'number', 'description': 'Total number of matching images.'}, 'images': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (lean list fields) with attribution.', 'additionalProperties': True}, 'description': 'Images whose OCR text matched.'}, 'has_more': {'type': 'boolean', 'description': 'Present when the API labelled the results: true when more results follow this page.'}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'additionalProperties': True}

{'type': 'object', 'required': ['image_url'], 'properties': {'tags': {'type': 'array', 'items': {'type': 'string', 'maxLength': 40}, 'maxItems': 10, 'description': 'Optional tag hints (max 10).'}, 'caption': {'type': 'string', 'maxLength': 200, 'description': 'Optional caption hint for the AI tagger (admin-visible, never published verbatim).'}, 'image_url': {'type': 'string', 'description': 'HTTPS image URL, or data:image/(jpeg|png|webp);base64,... URL. Max 8MB.'}, 'attribution': {'type': 'string', 'maxLength': 200, 'description': 'Optional credit line for the original creator/source (shown to moderators, not published).'}}}

{'type': 'object', 'required': ['image_id', 'status'], 'properties': {'status': {'type': 'string', 'description': "Always 'pending_review' on success — accepted, awaiting human moderation."}, 'image_id': {'type': 'string', 'description': 'UUID of the submitted image.'}, 'page_url': {'type': 'string', 'description': 'Gallery URL where the image will be published if approved.'}}, 'description': 'Outcome of a paid submit_image call: accepted into the human review queue.', 'additionalProperties': True}

{'type': 'object', 'required': ['prefix'], 'properties': {'limit': {'type': 'number', 'description': 'Max suggestions (1-50, default 10)'}, 'prefix': {'type': 'string', 'minLength': 2, 'description': 'Tag prefix to autocomplete (>= 2 characters), e.g. "bit" -> "bitcoin".'}}}

{'type': 'object', 'properties': {'tags': {'type': 'array', 'items': {'type': 'object', 'properties': {'tag': {'type': 'string', 'description': 'Tag slug.'}, 'name': {'type': 'string', 'description': 'Display name.'}, 'usage_count': {'type': 'number', 'description': 'Number of images using this tag.'}}, 'description': 'A tag with usage stats.', 'additionalProperties': True}, 'description': 'Suggested tags matching the prefix.'}}, 'description': 'Tag suggestions for a prefix.', 'additionalProperties': True}