{
  "openapi": "3.0.3",
  "info": {
    "title": "2 Bedroom 1 Bath Apartment — For Sale — Merchant API (preview)",
    "version": "0.1.0",
    "description": "Auto-generated from your Big Search merchant profile. Serves agents, search indexers, and checkout handoffs."
  },
  "servers": [
    {
      "url": "https://bigsearchai.com",
      "description": "Production origin when deployed"
    }
  ],
  "paths": {
    "/b/2-bedroom-1-bath-apartment-for-sale": {
      "get": {
        "summary": "Public business page (HTML)",
        "description": "Human-readable profile; crawlers and users land here.",
        "responses": {
          "200": {
            "description": "HTML document"
          }
        }
      }
    },
    "/api/v1/merchants/2-bedroom-1-bath-apartment-for-sale": {
      "get": {
        "summary": "Merchant profile (JSON)",
        "operationId": "getMerchantProfile",
        "responses": {
          "200": {
            "description": "Normalized merchant document",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "example": "draft-1780175011093"
                    },
                    "slug": {
                      "type": "string",
                      "example": "2-bedroom-1-bath-apartment-for-sale"
                    },
                    "name": {
                      "type": "string",
                      "example": "2 Bedroom 1 Bath Apartment — For Sale"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "draft",
                        "published",
                        "private",
                        "archived"
                      ]
                    },
                    "canonicalUrl": {
                      "type": "string",
                      "format": "uri",
                      "example": "https://bigsearchai.com/b/2-bedroom-1-bath-apartment-for-sale"
                    },
                    "identity": {
                      "type": "object",
                      "properties": {
                        "category": {
                          "type": "string"
                        },
                        "description": {
                          "type": "string"
                        },
                        "phone": {
                          "type": "string"
                        },
                        "email": {
                          "type": "string",
                          "format": "email"
                        },
                        "website": {
                          "type": "string",
                          "format": "uri"
                        },
                        "address": {
                          "type": "string"
                        },
                        "hours": {
                          "type": "string"
                        }
                      }
                    },
                    "fulfillment": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "boolean"
                      }
                    },
                    "visibility": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "boolean"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/merchants/2-bedroom-1-bath-apartment-for-sale/offers": {
      "get": {
        "summary": "Offer catalog",
        "operationId": "listMerchantOffers",
        "responses": {
          "200": {
            "description": "Array of offers",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "kind": {
                        "type": "string",
                        "enum": [
                          "product",
                          "service",
                          "menu_item",
                          "music_album",
                          "audiobook",
                          "video_series"
                        ]
                      },
                      "title": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      },
                      "price": {
                        "type": "string"
                      },
                      "inventory": {
                        "type": "string"
                      },
                      "category": {
                        "type": "string"
                      },
                      "fulfillmentType": {
                        "type": "string"
                      },
                      "imageUrl": {
                        "type": "string",
                        "format": "uri",
                        "description": "Primary image; mirrors imageUrls[0] when set."
                      },
                      "imageUrls": {
                        "type": "array",
                        "items": {
                          "type": "string",
                          "format": "uri"
                        },
                        "description": "Offer photo carousel"
                      },
                      "ingredients": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "materials": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "allergens": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "dietaryTags": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "origin": {
                        "type": "string"
                      },
                      "collectionDescription": {
                        "type": "string",
                        "description": "Album / book / series long description (media catalog lines)."
                      },
                      "mediaParts": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "title": {
                              "type": "string"
                            },
                            "description": {
                              "type": "string"
                            },
                            "duration": {
                              "type": "string"
                            }
                          }
                        },
                        "description": "Tracks, chapters, or episodes"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/merchants/2-bedroom-1-bath-apartment-for-sale/checkout": {
      "get": {
        "summary": "Resolve checkout",
        "operationId": "getMerchantCheckout",
        "responses": {
          "200": {
            "description": "Checkout handoff",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "platformFeePercent": {
                      "type": "number",
                      "example": 10
                    },
                    "note": {
                      "type": "string",
                      "example": "Checkout is created server-side; optional legacy Stripe Payment Link if configured."
                    },
                    "stripePaymentLinkUrl": {
                      "type": "string",
                      "format": "uri"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/merchants/2-bedroom-1-bath-apartment-for-sale/faqs": {
      "get": {
        "summary": "FAQ list (GEO / AEO)",
        "operationId": "listMerchantFaqs",
        "responses": {
          "200": {
            "description": "Question and answer pairs",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "question": {
                        "type": "string"
                      },
                      "answer": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}