openapi: 3.0.1
info:
  title: æye Creative Studio API
  description: Machine-readable access to æye's GEO services, nationwide US state/city knowledge graphs, and AI design capabilities.
  version: "1.2.0"
servers:
  - url: https://xn--ye-0ia.com
    description: Primary punycode domain
  - url: https://æye.com
    description: UTF-8 domain
paths:
  /locations.json:
    get:
      operationId: getLocations
      summary: Retrieve complete dataset of all 50 US states and top 150 metropolitan cities with localized GEO focus, key industries, and coordinates.
      responses:
        "200":
          description: Successful retrieval of nationwide GEO knowledge graph.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
  /services.json:
    get:
      operationId: getServices
      summary: Retrieve a list of GEO and agentic commerce capabilities.
      responses:
        "200":
          description: Successful retrieval of agency capabilities.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: string
  /contact:
    post:
      operationId: submitInquiry
      summary: Submit a project inquiry directly to info@æye.com via agent.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                email:
                  type: string
                state:
                  type: string
                city:
                  type: string
                inquiry:
                  type: string
      responses:
        "200":
          description: Inquiry successfully routed to the studio.