{
  "openapi": "3.1.0",
  "info": {
    "title": "ShoppingScraper API",
    "version": "1.0.0",
    "summary": "Google Shopping product and price data, identifier tools, and AI answer retrieval.",
    "description": "REST API that resolves an EAN/GTIN, ASIN or product query to a Google Shopping catalog ID and returns merchant offers with price, shipping, total and stock. Also converts and looks up product identifiers, scrapes retailer product pages, and answers questions through Google AI Mode. Every request authenticates with api_key and is metered in credits (100 free on signup; scheduled calls cost 1 credit, EAN/GTIN matching costs 4).",
    "contact": {
      "name": "ShoppingScraper",
      "url": "https://shoppingscraper.com/contact"
    },
    "license": {
      "name": "Terms of Service",
      "url": "https://shoppingscraper.com/legal/terms"
    }
  },
  "servers": [
    {
      "url": "https://api.shoppingscraper.com",
      "description": "Product REST endpoints (also served at https://data.shoppingscraper.com)"
    }
  ],
  "security": [{ "ApiKeyQuery": [] }],
  "tags": [
    { "name": "offers", "description": "Merchant offers and Google Shopping prices" },
    { "name": "products", "description": "Product page and webshop search extraction" },
    { "name": "identifiers", "description": "EAN, GTIN and ASIN lookup and conversion" },
    { "name": "match", "description": "EAN to product matching" },
    { "name": "channel", "description": "Channel API (async, X-API-Key header)" },
    { "name": "ai-answers", "description": "Google AI Mode and AI Overview retrieval" }
  ],
  "paths": {
    "/offers": {
      "get": {
        "tags": ["offers"],
        "operationId": "getOffers",
        "summary": "Merchant offers by EAN",
        "description": "Returns current merchant offers for a product on Google Shopping, keyed by EAN.",
        "security": [{ "ApiKeyQuery": [] }],
        "parameters": [
          { "$ref": "#/components/parameters/ApiKey" },
          {
            "name": "ean",
            "in": "query",
            "required": true,
            "description": "13-digit EAN/GTIN",
            "schema": { "type": "string", "examples": ["8710447495346"] }
          },
          {
            "name": "site",
            "in": "query",
            "required": false,
            "description": "Google Shopping site, for example shopping.google.nl",
            "schema": { "type": "string", "examples": ["shopping.google.nl"] }
          }
        ],
        "responses": {
          "200": {
            "description": "Offers grouped per product result",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/OffersResponse" }
              }
            }
          },
          "401": { "$ref": "#/components/responses/Unauthorized" },
          "402": { "$ref": "#/components/responses/InsufficientCredits" }
        }
      }
    },
    "/api/v1/search": {
      "get": {
        "tags": ["products"],
        "operationId": "searchWebshop",
        "summary": "Product URLs from a webshop search",
        "description": "Detects the search form on a webshop, submits the query, and extracts product URLs from the results.",
        "parameters": [
          { "$ref": "#/components/parameters/ApiKey" },
          {
            "name": "url",
            "in": "query",
            "required": true,
            "description": "Base URL of the webshop",
            "schema": { "type": "string", "examples": ["https://bol.com"] }
          },
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Search query",
            "schema": { "type": "string" }
          },
          {
            "name": "pages",
            "in": "query",
            "required": false,
            "description": "Number of result pages to fetch (1-10)",
            "schema": { "type": "integer", "default": 1, "minimum": 1, "maximum": 10 }
          },
          {
            "name": "max_results",
            "in": "query",
            "required": false,
            "schema": { "type": "integer", "default": 50, "minimum": 1, "maximum": 500 }
          }
        ],
        "responses": {
          "200": {
            "description": "Product URLs plus pagination info",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/SearchResponse" }
              }
            }
          },
          "401": { "$ref": "#/components/responses/Unauthorized" }
        }
      }
    },
    "/api/v1/page": {
      "get": {
        "tags": ["products"],
        "operationId": "getPageProduct",
        "summary": "Product data from a product page",
        "description": "Extracts product data from any product detail page using JSON-LD, microdata and HTML parsing.",
        "parameters": [
          { "$ref": "#/components/parameters/ApiKey" },
          {
            "name": "url",
            "in": "query",
            "required": true,
            "description": "Product page URL",
            "schema": { "type": "string" }
          },
          {
            "name": "javascript",
            "in": "query",
            "required": false,
            "description": "Enable JavaScript rendering",
            "schema": { "type": "boolean", "default": false }
          }
        ],
        "responses": {
          "200": {
            "description": "Parsed product record",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/ProductData" }
              }
            }
          },
          "401": { "$ref": "#/components/responses/Unauthorized" }
        }
      }
    },
    "/api/v1/match": {
      "get": {
        "tags": ["match"],
        "operationId": "matchEan",
        "summary": "Score a URL or title against an EAN",
        "description": "Returns a match verdict (absolute_match, title_match or no_match) with the matched product and reasons.",
        "parameters": [
          { "$ref": "#/components/parameters/ApiKey" },
          {
            "name": "ean",
            "in": "query",
            "required": true,
            "schema": { "type": "string", "examples": ["5702017416663"] }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": { "type": "string", "examples": ["nl"] }
          },
          {
            "name": "url",
            "in": "query",
            "required": false,
            "description": "Candidate product URL",
            "schema": { "type": "string" }
          },
          {
            "name": "title",
            "in": "query",
            "required": false,
            "description": "Candidate product title",
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": {
            "description": "Match verdict",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/MatchResponse" }
              }
            }
          },
          "401": { "$ref": "#/components/responses/Unauthorized" }
        }
      }
    },
    "/api/v1/asin": {
      "get": {
        "tags": ["identifiers"],
        "operationId": "convertAsinEan",
        "summary": "EAN to ASIN and ASIN to EAN",
        "description": "Converts EANs to ASINs and ASINs to EANs. Pass ean or asin (exactly one direction per call).",
        "parameters": [
          { "$ref": "#/components/parameters/ApiKey" },
          {
            "name": "ean",
            "in": "query",
            "required": false,
            "description": "13-digit EAN to convert to ASIN(s)",
            "schema": { "type": "string" }
          },
          {
            "name": "asin",
            "in": "query",
            "required": false,
            "description": "ASIN to convert to EAN(s)",
            "schema": { "type": "string" }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Marketplace country code, or ANY for ASIN to EAN without a marketplace",
            "schema": { "type": "string", "examples": ["DE"] }
          }
        ],
        "responses": {
          "200": {
            "description": "Conversion result",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/AsinConversionResult" }
              }
            }
          },
          "401": { "$ref": "#/components/responses/Unauthorized" }
        }
      }
    },
    "/api/v1/gtin": {
      "get": {
        "tags": ["identifiers"],
        "operationId": "getGtin",
        "summary": "Product data for a GTIN/EAN/UPC",
        "description": "Fetches product data from a GTIN via GS1 registry sources. Also accepts asin (converted internally).",
        "parameters": [
          { "$ref": "#/components/parameters/ApiKey" },
          {
            "name": "gtin",
            "in": "query",
            "required": false,
            "description": "GTIN/EAN/UPC code",
            "schema": { "type": "string", "examples": ["8714612112816"] }
          },
          {
            "name": "asin",
            "in": "query",
            "required": false,
            "description": "ASIN, converted to GTIN internally",
            "schema": { "type": "string" }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": { "type": "string" }
          },
          {
            "name": "extended",
            "in": "query",
            "required": false,
            "description": "Also scrape retailer pages for images, description and specs",
            "schema": { "type": "boolean", "default": false }
          },
          {
            "name": "source",
            "in": "query",
            "required": false,
            "description": "gs1org, gs1greece or codeonline",
            "schema": { "type": "string", "enum": ["gs1org", "gs1greece", "codeonline"] }
          }
        ],
        "responses": {
          "200": {
            "description": "GS1 and (optional) retailer product data",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/GtinResponse" }
              }
            }
          },
          "401": { "$ref": "#/components/responses/Unauthorized" }
        }
      }
    },
    "/api/v1/eancreator": {
      "get": {
        "tags": ["identifiers"],
        "operationId": "createEans",
        "summary": "Harvest GS1-valid EANs for a keyword",
        "description": "Walks Yahoo organic results and extracts check-digit-valid EAN-13 codes from URLs, titles and snippets.",
        "parameters": [
          { "$ref": "#/components/parameters/ApiKey" },
          {
            "name": "q",
            "in": "query",
            "required": true,
            "schema": { "type": "string" }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": { "type": "string", "default": "nl" }
          },
          {
            "name": "language",
            "in": "query",
            "required": false,
            "schema": { "type": "string", "default": "nl" }
          },
          {
            "name": "rounds",
            "in": "query",
            "required": false,
            "schema": { "type": "integer", "default": 3 }
          }
        ],
        "responses": {
          "200": {
            "description": "Harvested EANs",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/EanCreatorResponse" }
              }
            }
          },
          "401": { "$ref": "#/components/responses/Unauthorized" }
        }
      }
    },
    "/api/v1/asincreator": {
      "get": {
        "tags": ["identifiers"],
        "operationId": "createAsins",
        "summary": "Harvest Amazon ASINs for a keyword on a domain",
        "description": "Walks Yahoo organic results for a site-scoped query and extracts ASINs from /dp/ URLs.",
        "parameters": [
          { "$ref": "#/components/parameters/ApiKey" },
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "schema": { "type": "string", "examples": ["amazon.nl"] }
          },
          {
            "name": "q",
            "in": "query",
            "required": true,
            "schema": { "type": "string" }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": { "type": "string", "default": "us" }
          },
          {
            "name": "pages",
            "in": "query",
            "required": false,
            "schema": { "type": "integer", "default": 1 }
          }
        ],
        "responses": {
          "200": {
            "description": "Harvested ASINs",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/AsinCreatorResponse" }
              }
            }
          },
          "401": { "$ref": "#/components/responses/Unauthorized" }
        }
      }
    },
    "/api/v1/google_shopping": {
      "get": {
        "tags": ["offers"],
        "operationId": "googleShoppingSearch",
        "summary": "Google Shopping search results",
        "description": "Keyword search on Google Shopping with pagination and country targeting.",
        "parameters": [
          { "$ref": "#/components/parameters/ApiKey" },
          {
            "name": "keyword",
            "in": "query",
            "required": true,
            "schema": { "type": "string" }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": { "type": "string", "default": "nl" }
          },
          {
            "name": "start",
            "in": "query",
            "required": false,
            "description": "Pagination offset (0, 10, 20, ...)",
            "schema": { "type": "integer", "default": 0 }
          }
        ],
        "responses": {
          "200": {
            "description": "Shopping results",
            "content": {
              "application/json": {
                "schema": { "type": "object", "additionalProperties": true }
              }
            }
          },
          "401": { "$ref": "#/components/responses/Unauthorized" }
        }
      }
    },
    "/v2/channel/google/offers": {
      "post": {
        "tags": ["channel"],
        "operationId": "channelGoogleOffers",
        "summary": "Resolve EAN to Google catalog ID and return live offers",
        "description": "Channel API. Submits a batch of EANs; each item is resolved to a Google Shopping catalog ID and filled with live merchant offers. Auth via X-API-Key header.",
        "servers": [{ "url": "https://enterprise.shoppingscraper.com" }],
        "security": [{ "ApiKeyHeader": [] }],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": { "$ref": "#/components/schemas/ChannelGoogleOffersRequest" },
              "example": {
                "country": "nl",
                "application_id": "my-app",
                "items": [{ "ean": "8719706046244" }]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Per-item catalog match and offers",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/ChannelGoogleOffersResponse" }
              }
            }
          },
          "401": { "$ref": "#/components/responses/Unauthorized" }
        }
      }
    },
    "/shop/api/v1/folwr": {
      "get": {
        "tags": ["ai-answers"],
        "operationId": "folwr",
        "summary": "Google AI Mode answer and cited sources",
        "description": "Returns the Google AI Mode answer for a question with the sources it cited. Use country=us or country=uk for citation checks (AI Mode product cards render only there).",
        "servers": [{ "url": "https://data.shoppingscraper.com" }],
        "parameters": [
          { "$ref": "#/components/parameters/ApiKey" },
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Question, free text, any locale",
            "schema": { "type": "string" }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "gl code (nl uses google.nl; AI Mode product cards render for uk/us)",
            "schema": { "type": "string", "default": "nl" }
          },
          {
            "name": "language",
            "in": "query",
            "required": false,
            "description": "hl code",
            "schema": { "type": "string", "default": "en" }
          }
        ],
        "responses": {
          "200": {
            "description": "AI Mode answer with sources",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/AiAnswerResponse" }
              }
            }
          },
          "401": { "$ref": "#/components/responses/Unauthorized" },
          "402": { "$ref": "#/components/responses/InsufficientCredits" }
        }
      }
    },
    "/shop/api/v1/folif": {
      "get": {
        "tags": ["ai-answers"],
        "operationId": "folif",
        "summary": "Richer AI answer, optionally URL-grounded",
        "description": "Same render shape as folwr, optionally grounded on an ibp=oshop product deeplink.",
        "servers": [{ "url": "https://data.shoppingscraper.com" }],
        "parameters": [
          { "$ref": "#/components/parameters/ApiKey" },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Free-text question. Required unless url is given.",
            "schema": { "type": "string" }
          },
          {
            "name": "url",
            "in": "query",
            "required": false,
            "description": "ibp=oshop product deeplink to ground on",
            "schema": { "type": "string" }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": { "type": "string", "default": "nl" }
          },
          {
            "name": "language",
            "in": "query",
            "required": false,
            "schema": { "type": "string", "default": "en" }
          }
        ],
        "responses": {
          "200": {
            "description": "Grounded AI answer with sources",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/AiAnswerResponse" }
              }
            }
          },
          "401": { "$ref": "#/components/responses/Unauthorized" }
        }
      }
    },
    "/shop/api/v1/folsrch": {
      "get": {
        "tags": ["ai-answers"],
        "operationId": "folsrch",
        "summary": "Google classic-SERP AI Overview unit",
        "description": "Returns the AI Overview shown on the classic Google SERP (the lazy /async/folsrch unit). Also accepts url with fallback=false.",
        "servers": [{ "url": "https://data.shoppingscraper.com" }],
        "parameters": [
          { "$ref": "#/components/parameters/ApiKey" },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Search query. Required unless url is given.",
            "schema": { "type": "string" }
          },
          {
            "name": "url",
            "in": "query",
            "required": false,
            "schema": { "type": "string" }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": { "type": "string", "default": "nl" }
          },
          {
            "name": "language",
            "in": "query",
            "required": false,
            "schema": { "type": "string", "default": "en" }
          },
          {
            "name": "fallback",
            "in": "query",
            "required": false,
            "schema": { "type": "boolean", "default": true }
          }
        ],
        "responses": {
          "200": {
            "description": "AI Overview unit",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/AiAnswerResponse" }
              }
            }
          },
          "401": { "$ref": "#/components/responses/Unauthorized" }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKeyQuery": {
        "type": "apiKey",
        "in": "query",
        "name": "api_key",
        "description": "Dashboard API key, passed as a query parameter."
      },
      "ApiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key",
        "description": "Channel API key, passed as a header."
      }
    },
    "parameters": {
      "ApiKey": {
        "name": "api_key",
        "in": "query",
        "required": true,
        "description": "Your API key (placeholder: YOUR_API_KEY)",
        "schema": { "type": "string" }
      }
    },
    "responses": {
      "Unauthorized": {
        "description": "Missing or invalid api_key"
      },
      "InsufficientCredits": {
        "description": "Valid key without enough credits for this call"
      }
    },
    "schemas": {
      "OfferItem": {
        "type": "object",
        "properties": {
          "sellerName": { "type": "string" },
          "sellerReference": { "type": ["string", "null"] },
          "price": { "type": ["string", "null"] },
          "formerPrice": { "type": ["string", "null"] },
          "shippingPrice": { "type": ["string", "null"] },
          "totalPrice": { "type": ["string", "null"] },
          "condition": { "type": ["string", "null"] },
          "shippingMethod": { "type": ["string", "null"] }
        }
      },
      "OffersResult": {
        "type": "object",
        "properties": {
          "ean": { "type": ["string", "null"] },
          "sku": { "type": ["string", "null"] },
          "url": { "type": ["string", "null"] },
          "title": { "type": ["string", "null"] },
          "thumbnail": { "type": ["string", "null"] },
          "availability": { "type": ["string", "null"] },
          "currency": { "type": ["string", "null"] },
          "offers": {
            "type": "array",
            "items": { "$ref": "#/components/schemas/OfferItem" }
          }
        }
      },
      "OffersResponse": {
        "type": "object",
        "properties": {
          "results": {
            "type": "array",
            "items": { "$ref": "#/components/schemas/OffersResult" }
          }
        }
      },
      "SearchResult": {
        "type": "object",
        "properties": {
          "url": { "type": "string" },
          "title": { "type": ["string", "null"] },
          "price": { "type": ["string", "null"] },
          "image": { "type": ["string", "null"] }
        }
      },
      "SearchResponse": {
        "type": "object",
        "properties": {
          "url": { "type": "string" },
          "query": { "type": "string" },
          "search_url": { "type": ["string", "null"] },
          "redirect_url": { "type": ["string", "null"] },
          "results": {
            "type": "array",
            "items": { "$ref": "#/components/schemas/SearchResult" }
          },
          "total_results": { "type": "integer" },
          "search_form_found": { "type": "boolean" },
          "search_method": { "type": ["string", "null"] },
          "success": { "type": "boolean" },
          "error": { "type": ["string", "null"] }
        }
      },
      "ProductSpec": {
        "type": "object",
        "properties": {
          "name": { "type": "string" },
          "value": { "type": "string" }
        }
      },
      "ProductOffer": {
        "type": "object",
        "properties": {
          "sellerName": { "type": "string" },
          "price": { "type": ["number", "null"] },
          "shippingPrice": { "type": ["number", "null"] },
          "totalPrice": { "type": ["number", "null"] },
          "condition": { "type": ["string", "null"] },
          "availability": { "type": ["string", "null"] },
          "url": { "type": ["string", "null"] },
          "rating": { "type": ["number", "null"] },
          "ratingCount": { "type": ["integer", "null"] }
        }
      },
      "ProductData": {
        "type": "object",
        "properties": {
          "url": { "type": "string" },
          "title": { "type": ["string", "null"] },
          "brand": { "type": ["string", "null"] },
          "identifier": { "type": ["string", "null"] },
          "gtin": { "type": ["string", "null"] },
          "gtin_extra": { "type": "array", "items": { "type": "string" } },
          "image": { "type": ["string", "null"] },
          "images": { "type": "array", "items": { "type": "string" } },
          "description": { "type": ["string", "null"] },
          "description_text": { "type": ["string", "null"] },
          "category": { "type": ["string", "null"] },
          "categories": { "type": "array", "items": { "type": "string" } },
          "price": { "type": ["number", "null"] },
          "price_currency": { "type": ["string", "null"] },
          "price_original": { "type": ["number", "null"] },
          "shipping_cost": { "type": ["number", "null"] },
          "price_with_shipping": { "type": ["number", "null"] },
          "availability": { "type": ["string", "null"] },
          "condition": { "type": ["string", "null"] },
          "seller": { "type": ["string", "null"] },
          "rating": { "type": ["number", "null"] },
          "review_count": { "type": ["integer", "null"] },
          "specs": {
            "type": "array",
            "items": { "$ref": "#/components/schemas/ProductSpec" }
          },
          "offers": {
            "type": "array",
            "items": { "$ref": "#/components/schemas/ProductOffer" }
          },
          "success": { "type": "boolean" },
          "error": { "type": ["string", "null"] }
        }
      },
      "MatchProduct": {
        "type": "object",
        "properties": {
          "title": { "type": ["string", "null"] },
          "price": { "type": ["string", "null"] },
          "seller": { "type": ["string", "null"] },
          "rating": { "type": ["number", "null"] },
          "review_count": { "type": ["integer", "null"] },
          "offer_doc_id": { "type": ["string", "null"] },
          "catalog_id": { "type": ["string", "null"] },
          "image_doc_id": { "type": ["string", "null"] },
          "cluster_id": { "type": ["string", "null"] },
          "merchant_id": { "type": ["string", "null"] },
          "image_url": { "type": ["string", "null"] },
          "generated_url": { "type": ["string", "null"] },
          "offers_url": { "type": ["string", "null"] },
          "generated_oapv_data_url": { "type": ["string", "null"] }
        }
      },
      "MatchResponse": {
        "type": "object",
        "properties": {
          "ean": { "type": ["string", "null"] },
          "asin": { "type": ["string", "null"] },
          "country": { "type": ["string", "null"] },
          "match": {
            "type": "boolean",
            "description": "True when verdict is absolute_match or title_match"
          },
          "title": { "type": ["string", "null"] },
          "product": {
            "oneOf": [
              { "$ref": "#/components/schemas/MatchProduct" },
              { "type": "null" }
            ]
          },
          "reasons": { "type": "array", "items": { "type": "string" } },
          "error": { "type": ["string", "null"] }
        }
      },
      "AsinConversionResult": {
        "type": "object",
        "properties": {
          "asin": { "type": ["string", "null"] },
          "ean": { "type": ["string", "null"] },
          "asins": { "type": "array", "items": { "type": "string" } },
          "eans": { "type": "array", "items": { "type": "string" } },
          "country": { "type": "string" },
          "success": { "type": "boolean" },
          "fallback_used": { "type": "boolean" },
          "product_title": { "type": ["string", "null"] }
        }
      },
      "GtinResponse": {
        "type": "object",
        "description": "GS1 registry record plus optional retailer-page enrichment. Field set varies with source and extended flag.",
        "properties": {
          "gtin": { "type": ["string", "null"] },
          "title": { "type": ["string", "null"] },
          "brand": { "type": ["string", "null"] },
          "description": { "type": ["string", "null"] },
          "images": { "type": "array", "items": { "type": "string" } },
          "price": { "type": ["string", "null"] },
          "specs": {
            "type": "array",
            "items": { "type": "object", "additionalProperties": true }
          },
          "company": {
            "oneOf": [
              { "$ref": "#/components/schemas/CompanyInfo" },
              { "type": "null" }
            ]
          },
          "extended": {
            "type": "array",
            "items": { "type": "object", "additionalProperties": true }
          }
        }
      },
      "CompanyInfo": {
        "type": "object",
        "properties": {
          "company_name": { "type": ["string", "null"] },
          "employee_count": { "type": ["string", "null"] },
          "founding_year": { "type": ["string", "null"] },
          "owner_ceo": { "type": ["string", "null"] },
          "description": { "type": ["string", "null"] },
          "industry": { "type": ["string", "null"] },
          "city": { "type": ["string", "null"] },
          "country": { "type": ["string", "null"] },
          "full_address": { "type": ["string", "null"] }
        }
      },
      "EanCreatorResponse": {
        "type": "object",
        "properties": {
          "q": { "type": "string" },
          "country": { "type": "string" },
          "language": { "type": "string" },
          "rounds_requested": { "type": "integer" },
          "rounds_fetched": { "type": "integer" },
          "total_results": { "type": "integer" },
          "excluded_domains": { "type": "array", "items": { "type": "string" } },
          "eans": { "type": "array", "items": { "type": "string" } },
          "hits": { "type": "array", "items": { "type": "object", "additionalProperties": true } }
        }
      },
      "AsinCreatorResponse": {
        "type": "object",
        "properties": {
          "domain": { "type": "string" },
          "q": { "type": "string" },
          "site_query": { "type": "string" },
          "country": { "type": "string" },
          "language": { "type": "string" },
          "pages_requested": { "type": "integer" },
          "pages_fetched": { "type": "integer" },
          "total_results": { "type": "integer" },
          "asins": { "type": "array", "items": { "type": "string" } },
          "hits": { "type": "array", "items": { "type": "object", "additionalProperties": true } }
        }
      },
      "ChannelGoogleOffersRequest": {
        "type": "object",
        "required": ["items"],
        "properties": {
          "country": { "type": "string", "examples": ["nl"] },
          "application_id": { "type": "string" },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "required": ["ean"],
              "properties": {
                "ean": { "type": "string", "examples": ["8719706046244"] }
              }
            }
          }
        }
      },
      "ChannelOffer": {
        "type": "object",
        "properties": {
          "merchant": { "type": "string" },
          "price": { "type": "number" },
          "shipping": { "type": "number" },
          "total_price": { "type": "number" },
          "condition": { "type": "string" },
          "in_stock": { "type": "boolean" },
          "direct_link": { "type": "string" }
        }
      },
      "ChannelGoogleItem": {
        "type": "object",
        "properties": {
          "ean": { "type": "string" },
          "catalog_id": { "type": ["string", "null"] },
          "matched": { "type": "boolean" },
          "title": { "type": ["string", "null"] },
          "brand": { "type": ["string", "null"] },
          "currency": { "type": ["string", "null"] },
          "offers_count": { "type": "integer" },
          "min_price": { "type": ["number", "null"] },
          "offers": {
            "type": "array",
            "items": { "$ref": "#/components/schemas/ChannelOffer" }
          }
        }
      },
      "ChannelGoogleOffersResponse": {
        "type": "object",
        "properties": {
          "status": { "type": "string", "examples": ["success"] },
          "country": { "type": "string" },
          "application_id": { "type": ["string", "null"] },
          "items": {
            "type": "array",
            "items": { "$ref": "#/components/schemas/ChannelGoogleItem" }
          }
        }
      },
      "AiCitation": {
        "type": "object",
        "properties": {
          "uuid": { "type": ["string", "null"] },
          "site_name": { "type": ["string", "null"] },
          "goto_url": { "type": ["string", "null"] },
          "domains": { "type": "array", "items": { "type": "string" } }
        }
      },
      "AiAnswerResponse": {
        "type": "object",
        "description": "Shared render shape for folwr, folif and folsrch.",
        "properties": {
          "question": { "type": ["string", "null"] },
          "effective_query": { "type": ["string", "null"] },
          "country": { "type": "string" },
          "language": { "type": "string" },
          "attempts": { "type": "integer" },
          "processing_time_seconds": { "type": "number" },
          "answer_text": { "type": ["string", "null"] },
          "answer_blocks": {
            "type": "array",
            "items": { "type": "object", "additionalProperties": true }
          },
          "links": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "text": { "type": ["string", "null"] },
                "url": { "type": ["string", "null"] },
                "goto_url": { "type": ["string", "null"] },
                "kind": { "type": ["string", "null"] }
              }
            }
          },
          "products": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "title": { "type": ["string", "null"] },
                "product_url": { "type": ["string", "null"] },
                "catalog_id": { "type": ["string", "null"] },
                "gpcid": { "type": ["string", "null"] },
                "mid": { "type": ["string", "null"] },
                "headline_offer_docid": { "type": ["string", "null"] }
              }
            }
          },
          "source_cards": {
            "type": "array",
            "items": { "type": "object", "additionalProperties": true }
          },
          "sources": {
            "type": "array",
            "items": { "$ref": "#/components/schemas/AiCitation" }
          },
          "grounded_url": { "type": ["string", "null"] },
          "thread_id": { "type": ["string", "null"] }
        }
      }
    }
  }
}
