openapi: 3.0.0
info:
  title: TattooStay AI API
  description: API for retrieving TattooStay FAQs and knowledge base for AI assistants
  version: 1.0.0
  contact:
    email: hello@tattoostay.com
servers:
  - url: https://tattoostay.com
    description: Production server
paths:
  /api/ai/faq:
    get:
      summary: Get TattooStay FAQs
      description: Returns a list of frequently asked questions about TattooStay platform, including questions for artists and studio owners
      operationId: getFAQs
      parameters:
        - name: lang
          in: query
          description: Language code (en or es)
          required: false
          schema:
            type: string
            enum: [en, es]
            default: en
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    question:
                      type: string
                      example: "What is TattooStay?"
                    answer_short:
                      type: string
                      example: "TattooStay is a platform connecting tattoo artists with studio owners who have open booths for rent."
                    answer_full:
                      type: string
                      example: "TattooStay is a platform that connects tattoo artists with studio owners who have open booths for rent. Think 'Airbnb for tattoo artists'."
                    url:
                      type: string
                      format: uri
                      example: "https://tattoostay.com/#faq"
                    lang:
                      type: string
                      example: "en"
                    tags:
                      type: array
                      items:
                        type: string
                      example: ["platform", "marketplace", "overview"]
                    last_updated:
                      type: string
                      format: date
                      example: "2025-01-28"
              examples:
                english:
                  summary: Example FAQ in English
                  value:
                    - question: "What is TattooStay?"
                      answer_short: "TattooStay is a platform connecting tattoo artists with studio owners who have open booths for rent."
                      answer_full: "TattooStay is a platform that connects tattoo artists with studio owners who have open booths for rent. Think 'Airbnb for tattoo artists'. We help traveling artists find verified, licensed studio space in multiple cities while helping studios monetize their empty booths."
                      url: "https://tattoostay.com/#faq"
                      lang: "en"
                      tags: ["platform", "marketplace", "overview"]
                      last_updated: "2025-01-28"
                    - question: "How much can I earn as a studio owner?"
                      answer_short: "Studios can earn €500-€2,000+ per month from empty booths depending on location and availability."
                      answer_full: "Studios can earn €500-€2,000+ per month from previously empty booths, depending on your location, rates, and availability. Many studios see a 35% increase in overall revenue."
                      url: "https://tattoostay.com/#income-calculator"
                      lang: "en"
                      tags: ["hosts", "income", "earnings"]
                      last_updated: "2025-01-28"
        '500':
          description: Server error
  /api/ai/knowledge:
    get:
      summary: Get TattooStay knowledge base
      description: Returns structured knowledge snippets about TattooStay platform, cities, process, and features
      operationId: getKnowledge
      parameters:
        - name: lang
          in: query
          description: Language code (en or es)
          required: false
          schema:
            type: string
            enum: [en, es]
            default: en
        - name: city
          in: query
          description: Filter by city (berlin, paris, barcelona, amsterdam)
          required: false
          schema:
            type: string
            enum: [berlin, paris, barcelona, amsterdam]
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    title:
                      type: string
                      example: "TattooStay Platform Overview"
                    snippet:
                      type: string
                      example: "TattooStay is a marketplace connecting traveling tattoo artists with studio owners who have empty booth space."
                    url:
                      type: string
                      format: uri
                      example: "https://tattoostay.com/"
                    tags:
                      type: array
                      items:
                        type: string
                      example: ["platform", "overview", "marketplace"]
                    city:
                      type: string
                      nullable: true
                      example: "berlin"
                    lang:
                      type: string
                      example: "en"
                    updated_at:
                      type: string
                      format: date
                      example: "2025-01-28"
              examples:
                general:
                  summary: Example knowledge snippets
                  value:
                    - title: "TattooStay Platform Overview"
                      snippet: "TattooStay is a marketplace connecting traveling tattoo artists with studio owners who have empty booth space. Studios monetize unused booths while artists access verified, licensed workspace."
                      url: "https://tattoostay.com/"
                      tags: ["platform", "overview"]
                      city: null
                      lang: "en"
                      updated_at: "2025-01-28"
                    - title: "Berlin Tattoo Booth Rental"
                      snippet: "Rent tattoo booth space in Berlin. Hub for alternative and traditional tattoo art with high demand from traveling artists."
                      url: "https://tattoostay.com/studios/berlin"
                      tags: ["berlin", "germany", "city"]
                      city: "berlin"
                      lang: "en"
                      updated_at: "2025-01-28"
        '500':
          description: Server error
