{
  "openapi": "3.1.0",
  "info": {
    "title": "Chile Procurement Intel",
    "version": "1.7.0",
    "description": "Agent-native Chile public procurement demand intelligence from official ChileCompra OCDS data.",
    "x-guidance": "Use the free medical-equipment preview to evaluate freshness and demand signal. Use the paid buyer-map to unlock named buyers, buyer IDs, regions, repeat-demand evidence and deterministic provenance."
  },
  "servers": [
    {
      "url": "https://exp-100k-001-v2.vercel.app"
    }
  ],
  "paths": {
    "/v1/buyers/search/preview": {
      "post": {
        "operationId": "previewBuyerSearch",
        "summary": "Preview a Chile public procurement buyer search for free",
        "description": "Checks the full July 2026 ChileCompra OCDS population and returns coverage plus how many buyers match, without revealing ranked buyer identities.",
        "tags": [
          "procurement-search",
          "chile",
          "buyer-leads",
          "ChileCompra",
          "OCDS"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "query": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 160,
                    "description": "Natural-language procurement demand query, product, service, buyer intent or UNSPSC-related phrase."
                  },
                  "region": {
                    "type": "string",
                    "maxLength": 120,
                    "description": "Optional Chilean region filter."
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 5
                  }
                },
                "required": [
                  "query"
                ],
                "additionalProperties": false
              },
              "example": {
                "query": "hospitales que compran equipamiento médico",
                "region": "Región Metropolitana de Santiago",
                "limit": 5
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Free buyer-search preview"
          }
        }
      }
    },
    "/v1/buyers/search": {
      "post": {
        "operationId": "searchChilePublicBuyers",
        "summary": "Search Chile public procurement buyers",
        "description": "Searches all 8,004 July 2026 ChileCompra OCDS procurement processes and ranks public-sector buyers matching a product, service or procurement intent. Returns buyer IDs, regions, observed matching tenders, known budget evidence, UNSPSC codes and official source URLs.",
        "tags": [
          "procurement-search",
          "chile",
          "public-buyers",
          "buyer-leads",
          "sales-prospecting",
          "government-sales",
          "supplier-discovery",
          "ChileCompra",
          "OCDS"
        ],
        "x-payment-info": {
          "protocols": [
            {
              "x402": {}
            }
          ],
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.01"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "query": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 160,
                    "description": "Natural-language procurement demand query, product, service, buyer intent or UNSPSC-related phrase."
                  },
                  "region": {
                    "type": "string",
                    "maxLength": 120,
                    "description": "Optional Chilean region filter."
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 5
                  }
                },
                "required": [
                  "query"
                ],
                "additionalProperties": false
              },
              "example": {
                "query": "hospitales que compran equipamiento médico",
                "region": "Región Metropolitana de Santiago",
                "limit": 5
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid ranked public-buyer search results"
          },
          "400": {
            "description": "Invalid search input"
          },
          "402": {
            "description": "x402 payment required"
          }
        }
      }
    },
    "/v1/verticals/medical-equipment/preview": {
      "get": {
        "operationId": "previewMedicalEquipmentDemand",
        "summary": "Free preview of Chile medical-equipment procurement demand intelligence",
        "tags": [
          "procurement",
          "chile",
          "medical-equipment",
          "ChileCompra",
          "OCDS"
        ],
        "security": [],
        "responses": {
          "200": {
            "description": "Free demand preview"
          }
        }
      }
    },
    "/v1/verticals/medical-equipment/buyer-map": {
      "get": {
        "summary": "Find Chile hospital buyers for medical equipment",
        "description": "Named Chilean hospital and public health-service buyer leads with buyer IDs, regions, repeat-demand signals, budget evidence and ChileCompra OCDS provenance for sales prospecting and sourcing agents.",
        "tags": [
          "procurement",
          "chile",
          "medical-equipment",
          "hospital-buyers",
          "buyer-leads",
          "sales-prospecting",
          "government-sales",
          "ChileCompra",
          "OCDS"
        ],
        "x-payment-info": {
          "protocols": [
            {
              "x402": {}
            }
          ],
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.01"
          }
        },
        "operationId": "getMedicalEquipmentBuyerMap",
        "responses": {
          "200": {
            "description": "Paid buyer-demand intelligence",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "product": {
                      "type": "string"
                    },
                    "vertical": {
                      "type": "string"
                    },
                    "unspsc_segment": {
                      "type": "string"
                    },
                    "data_freshness": {
                      "type": "object"
                    },
                    "demand_signal": {
                      "type": "object"
                    },
                    "top_buyers": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "provenance": {
                      "type": "object"
                    }
                  },
                  "required": [
                    "product",
                    "vertical",
                    "demand_signal",
                    "top_buyers",
                    "provenance"
                  ]
                }
              }
            }
          },
          "402": {
            "description": "x402 payment required"
          }
        }
      }
    },
    "/v1/opportunities/match": {
      "post": {
        "operationId": "matchChileProcurementDemand",
        "summary": "Find Chile public procurement sales opportunities for a supplier",
        "description": "Matches a supplier offering to supported ChileCompra demand and returns structured public-buyer leads and evidence for lead generation, prospecting and opportunity discovery.",
        "tags": [
          "procurement",
          "chile",
          "supplier-matching",
          "buyer-leads",
          "lead-generation",
          "sales-prospecting",
          "government-sales",
          "opportunities",
          "ChileCompra",
          "OCDS"
        ],
        "x-payment-info": {
          "protocols": [
            {
              "x402": {}
            }
          ],
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.05"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "need": {
                    "type": "string",
                    "minLength": 3,
                    "description": "Natural-language description of what the supplier sells or the demand it wants to find in Chile public procurement."
                  },
                  "region": {
                    "type": "string",
                    "description": "Optional Chilean region filter. Current validation sample may not contain enough rows for hard filtering."
                  },
                  "max_results": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  }
                },
                "required": [
                  "need"
                ],
                "additionalProperties": false
              },
              "example": {
                "need": "Vendemos ecógrafos y equipamiento clínico en Chile",
                "region": "Región Metropolitana de Santiago",
                "max_results": 10
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid supplier-to-demand match",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "matched": {
                      "type": "boolean"
                    },
                    "matched_vertical": {
                      "type": "string"
                    },
                    "unspsc_segment": {
                      "type": "string"
                    },
                    "demand_summary": {
                      "type": "object"
                    },
                    "top_buyers": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "provenance": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "402": {
            "description": "x402 payment required"
          }
        }
      }
    }
  },
  "x-discovery": {}
}