{
  "openapi": "3.1.0",
  "info": {
    "title": "Dream Data API",
    "version": "1.0.0",
    "description": "Human-curated creative-industry intelligence for agents, researchers, and production teams. Public endpoints expose five-record previews; full feeds are sold by license.",
    "contact": {
      "name": "Dream Inc.",
      "url": "https://thedream.io/data#pricing"
    },
    "license": {
      "name": "Public sample terms and commercial license review",
      "url": "https://thedream.io/data#rights"
    }
  },
  "servers": [
    {
      "url": "https://thedream.io",
      "description": "Dream Data production API"
    }
  ],
  "externalDocs": {
    "description": "Dream Data catalog, pricing, provenance, and rights",
    "url": "https://thedream.io/data"
  },
  "tags": [
    {
      "name": "Dream Data public samples",
      "description": "Free five-record previews of the licensed Dream Data catalog."
    }
  ],
  "paths": {
    "/api/data/v1/markets": {
      "get": {
        "operationId": "preview_markets",
        "summary": "Preview Worldwide production market intelligence",
        "description": "Market context, production approach, creative focus, and priority-sector planning across 44 cities. The public response contains up to five sample records; the complete feed requires a commercial license.",
        "tags": [
          "Dream Data public samples"
        ],
        "parameters": [
          {
            "name": "region",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "priority",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Versioned Dream Data sample response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "schema_version",
                    "data"
                  ],
                  "properties": {
                    "schema_version": {
                      "type": "string"
                    },
                    "canonical_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "updated_at": {
                      "type": "string",
                      "format": "date"
                    },
                    "access": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "data": {
                      "type": "array",
                      "maxItems": 5,
                      "items": {
                        "type": "object",
                        "additionalProperties": true
                      }
                    }
                  },
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/api/data/v1/services": {
      "get": {
        "operationId": "preview_services",
        "summary": "Preview Creative production service taxonomy",
        "description": "A normalized service vocabulary with outputs, methods, evidence routes, and worldwide availability. The public response contains up to five sample records; the complete feed requires a commercial license.",
        "tags": [
          "Dream Data public samples"
        ],
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Versioned Dream Data sample response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "schema_version",
                    "data"
                  ],
                  "properties": {
                    "schema_version": {
                      "type": "string"
                    },
                    "canonical_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "updated_at": {
                      "type": "string",
                      "format": "date"
                    },
                    "access": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "data": {
                      "type": "array",
                      "maxItems": 5,
                      "items": {
                        "type": "object",
                        "additionalProperties": true
                      }
                    }
                  },
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/api/data/v1/commercial-references": {
      "get": {
        "operationId": "preview_commercial_references",
        "summary": "Preview Commercial production reference index",
        "description": "Curated campaign-reference metadata with clear official, commissioned, concept, and unverified classifications. The public response contains up to five sample records; the complete feed requires a commercial license.",
        "tags": [
          "Dream Data public samples"
        ],
        "parameters": [
          {
            "name": "classification",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "brand",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Versioned Dream Data sample response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "schema_version",
                    "data"
                  ],
                  "properties": {
                    "schema_version": {
                      "type": "string"
                    },
                    "canonical_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "updated_at": {
                      "type": "string",
                      "format": "date"
                    },
                    "access": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "data": {
                      "type": "array",
                      "maxItems": 5,
                      "items": {
                        "type": "object",
                        "additionalProperties": true
                      }
                    }
                  },
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/api/data/v1/brand-assets": {
      "get": {
        "operationId": "preview_brand_assets",
        "summary": "Preview Dream Inc. brand asset index",
        "description": "Structured descriptions, formats, dimensions, palettes, keywords, and canonical URLs for the Dream Inc. visual system. The public response contains up to five sample records; the complete feed requires a commercial license.",
        "tags": [
          "Dream Data public samples"
        ],
        "parameters": [
          {
            "name": "category",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "format",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Versioned Dream Data sample response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "schema_version",
                    "data"
                  ],
                  "properties": {
                    "schema_version": {
                      "type": "string"
                    },
                    "canonical_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "updated_at": {
                      "type": "string",
                      "format": "date"
                    },
                    "access": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "data": {
                      "type": "array",
                      "maxItems": 5,
                      "items": {
                        "type": "object",
                        "additionalProperties": true
                      }
                    }
                  },
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    }
  }
}