Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. By signing up you are subscribing to the APIs.io and API Evangelist
newsletters — you can unsubscribe from any issue. See our
Privacy Policy and Terms.
openapi: 3.2.0
info:
title: Maginary Seo API
description: Public API documentation for Maginary — AI image and video generation platform.
version: v1
servers:
- url: https://app.maginary.ai/api
security:
- Basic: []
- Bearer: []
tags:
- name: SEO
paths:
/seo/daily-images/:
parameters: []
get:
operationId: seo_daily-images_list
summary: All published images (past or today, never future) for the landing SSR
description: Newest first. Feeds the archive listing and the dynamic sitemap.
responses:
'200':
description: ''
tags:
- SEO
/seo/daily-images/{date_str}/:
parameters:
- name: date_str
in: path
required: true
schema:
type: string
get:
operationId: seo_daily-images_read
description: Single daily image by ISO date (YYYY-MM-DD). Used by SSR landing route.
responses:
'200':
description: ''
tags:
- SEO
summary: Seo daily images read
x-summary-source: derived
/seo/generations/:
parameters: []
get:
operationId: seo_generations_list
description: Get all SEO-promoted generations for landing site builds. Returns lightweight generation data suitable for static site prerendering. Only includes generations marked for SEO promotion (superuser-controlled).
parameters:
- name: limit
in: query
description: 'Max generations to return (default: 1000)'
required: false
schema:
type: integer
responses:
'200':
description: List of SEO-promoted generations
content:
application/json:
example:
- slug: my-awesome-dragon
uuid: abc123...
prompt: a majestic dragon
seo_title: Dragon Art Generation
seo_description: AI-generated dragon artwork
image_url: https://...
tags:
- SEO
summary: Seo generations list
x-summary-source: derived
/seo/profiles/:
parameters: []
get:
operationId: seo_profiles_list
description: Get all public profiles for SEO/landing site builds. Returns lightweight profile data suitable for static site generation. Only includes public profiles with at least one created recipe.
parameters:
- name: limit
in: query
description: 'Max profiles to return (default: 1000)'
required: false
schema:
type: integer
responses:
'200':
description: List of public profiles with SEO fields
content:
application/json:
example:
- username: artist123
display_name: Artist Name
bio: AI art enthusiast
created_recipes_count: 25
tags:
- SEO
summary: Seo profiles list
x-summary-source: derived
/seo/recipes/:
parameters: []
get:
operationId: seo_recipes_list
description: 'Get all public recipes for SEO/landing site builds. Returns lightweight recipe data suitable for static site generation. Only includes public recipes (visibility: public_use or public_full).'
parameters:
- name: limit
in: query
description: 'Max recipes to return (default: 1000)'
required: false
schema:
type: integer
responses:
'200':
description: List of public recipes with SEO fields
content:
application/json:
example:
- id: 123
slug: fantasy-dragon
prompt: a majestic dragon flying over mountains
use_count: 145
created_by: username
tags:
- SEO
summary: Seo recipes list
x-summary-source: derived
components:
securitySchemes:
Basic:
type: http
scheme: basic
Bearer:
type: apiKey
name: Authorization
in: header