openapi: 3.0.0
info:
  title: AI Site Metadata API
  description: Provides structured site metadata for AI agents.
  version: 1.0.0
servers:
  - url: https://www.mediatime.gr/wp-json/ai/v1

paths:
  /site-meta/:
    get:
      summary: Get site metadata
      description: Returns metadata about the site, categories, recent posts, breadcrumbs, and SEO information.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  site_name:
                    type: string
                  description:
                    type: string
                  url:
                    type: string
                  language:
                    type: string
                  categories:
                    type: array
                    items:
                      type: object
                      properties:
                        id: { type: integer }
                        name: { type: string }
                        slug: { type: string }
                        description: { type: string }
                  recent_posts:
                    type: array
                    items:
                      type: object
                      properties:
                        id: { type: integer }
                        title: { type: string }
                        excerpt: { type: string }
                        url: { type: string }
                        published: { type: string, format: date-time }
                        author: { type: string }
                        featured_img: { type: string }
                        breadcrumbs:
                          type: array
                          items:
                            type: object
                            properties:
                              name: { type: string }
                              url: { type: string }
                        seo_meta:
                          type: object
                          properties:
                            meta_title: { type: string }
                            meta_desc: { type: string }