{
  "openapi": "3.0.3",
  "info": {
    "title": "NEXORA Tender Signals API",
    "version": "1.0.0",
    "description": "Free experimental search of French BOAMP public procurement notices. Not exhaustive. Data source: official DILA BOAMP open data (Licence Ouverte 2.0). No authentication, billing, or service-level guarantee."
  },
  "servers": [
    {
      "url": "https://nexora-auto.floot.app"
    }
  ],
  "paths": {
    "/_api/tenders": {
      "get": {
        "summary": "Search French public procurement notices",
        "operationId": "searchTenders",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Search phrase (3–65 characters)",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 65
            },
            "example": "travaux"
          },
          {
            "name": "dep",
            "in": "query",
            "required": false,
            "description": "French department number",
            "schema": {
              "type": "string"
            },
            "example": "93"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum results",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 20,
              "default": 10
            },
            "example": 3
          }
        ],
        "responses": {
          "200": {
            "description": "JSON results from BOAMP data",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Invalid query parameters"
          }
        }
      }
    }
  },
  "externalDocs": {
    "description": "Documentation and live search",
    "url": "https://nexora-auto.floot.app/tender-signals"
  }
}