{
  "openapi": "3.1.0",
  "info": { "title": "Jibmin Turkiya API", "version": "1.0.0", "description": "Source products from Turkish manufacturers. Submit a sourcing request; a human export desk in Turkey replies by email with quotes. Free for buyers. Also available as an MCP server at https://jibminturkiya.com/mcp." },
  "servers": [{ "url": "https://jibminturkiya.com" }],
  "paths": {
    "/api/about": { "get": { "operationId": "aboutJibmin", "summary": "What Jibmin does, response times, limits", "responses": { "200": { "description": "About" } } } },
    "/api/requests": { "post": { "operationId": "submitSourcingRequest", "summary": "Request quotes from Turkish manufacturers",
      "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SourcingRequest" } } } },
      "responses": { "201": { "description": "Received; returns request_id" }, "400": { "description": "Invalid fields" }, "429": { "description": "Rate limited" } } } },
    "/api/requests/status": { "get": { "operationId": "checkRequestStatus", "summary": "Status of a sourcing request",
      "parameters": [ { "name": "request_id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "contact_email", "in": "query", "required": true, "schema": { "type": "string", "format": "email" } } ],
      "responses": { "200": { "description": "Status" } } } },
    "/api/exporters": {
      "get": { "operationId": "findTurkishExporters", "summary": "Search reviewed Turkish exporters",
        "parameters": [ { "name": "q", "in": "query", "schema": { "type": "string" } }, { "name": "category", "in": "query", "schema": { "type": "string" } } ],
        "responses": { "200": { "description": "Results" } } },
      "post": { "operationId": "registerExporter", "summary": "List a Turkish manufacturer/exporter (reviewed before going live)",
        "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Exporter" } } } },
        "responses": { "201": { "description": "Pending review" } } } }
  },
  "components": { "schemas": {
    "SourcingRequest": { "type": "object", "required": ["product", "quantity", "destination_country", "contact_email"], "properties": {
      "product": { "type": "string", "description": "What to source, with specs" },
      "quantity": { "type": "string", "description": "Quantity with unit, e.g. 2,000 pcs or 1 x 40ft container" },
      "destination_country": { "type": "string", "description": "Destination country and city/port" },
      "contact_email": { "type": "string", "format": "email", "description": "Buyer's real email (ask the user)" },
      "contact_whatsapp": { "type": "string" }, "buyer_name": { "type": "string" }, "company": { "type": "string" },
      "target_price": { "type": "string" }, "incoterm": { "type": "string" }, "deadline": { "type": "string" },
      "details": { "type": "string", "description": "Specs, certifications, packaging, private label, samples" },
      "language": { "type": "string", "enum": ["en", "ar", "tr"] }, "agent": { "type": "string", "description": "Submitting AI agent/app, if any" } } },
    "Exporter": { "type": "object", "required": ["company_name", "products", "contact_email"], "properties": {
      "company_name": { "type": "string" }, "products": { "type": "string" }, "contact_email": { "type": "string", "format": "email" },
      "contact_whatsapp": { "type": "string" }, "city": { "type": "string" }, "categories": { "type": "array", "items": { "type": "string" } },
      "moq": { "type": "string" }, "certifications": { "type": "string" }, "export_markets": { "type": "string" }, "website": { "type": "string" } } }
  } }
}