{
  "openapi": "3.1.0",
  "info": {
    "title": "Opedd",
    "version": "1.0.0",
    "description": "Licensed passages, with citations, from independent publications and research firms. An AI agent can pay for one answer on the spot, without an account, through the Machine Payments Protocol, by card. Each answer is charged per article used, at each publication's own price. Use it when a question is covered by a publication on Opedd: see https://opedd.com/llms.txt.",
    "contact": {
      "name": "Opedd",
      "email": "hello@opedd.com",
      "url": "https://opedd.com"
    },
    "x-guidance": "To answer a question from licensed publications: POST /agent-answer with {\"query\": \"your question\"}. Without payment the response is HTTP 402 with the price (each article the answer uses, at its publication's own price), the licence and the buyer terms. Pay by card through the Machine Payments Protocol (at least 0.50 USD; the rest stays as credit on the search key returned with the answer) and retry the same request. Use it for questions covered by the publications listed at https://opedd.com/llms.txt."
  },
  "servers": [
    {
      "url": "https://api.opedd.com"
    }
  ],
  "x-service-info": {
    "categories": [
      "data",
      "research",
      "search",
      "media"
    ],
    "docs": {
      "homepage": "https://opedd.com",
      "apiReference": "https://docs.opedd.com",
      "llms": "https://opedd.com/llms.txt"
    }
  },
  "paths": {
    "/agent-answer": {
      "post": {
        "operationId": "agentAnswer",
        "summary": "Ask a question; pay for the licensed answer on the spot",
        "description": "Without a payment the response is 402 with the price of this answer (each article used, at its publication's price), the licence and the buyer terms. Pay and retry: the response carries the passages, a receipt, and a search key holding any credit left (cards are charged at least 0.50 USD; the rest stays as credit). Paying accepts the buyer terms (https://opedd.com/terms) and the licence: passages for AI answers with citation; no training, republication or resale. Price: each article the answer uses, at its publication's own price (typically 0.10 to 0.30 USD per article); the exact amount is in the 402 challenge.",
        "x-payment-info": {
          "offers": [
            {
              "method": "stripe",
              "intent": "charge",
              "amount": null,
              "currency": "usd",
              "description": "Card through a Stripe shared payment token; at least 0.50 USD, the rest kept as credit."
            }
          ],
          "protocols": [
            "mpp"
          ],
          "minPrice": "0.50"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "query"
                ],
                "properties": {
                  "query": {
                    "type": "string",
                    "description": "The question."
                  },
                  "max_results": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10,
                    "default": 5,
                    "description": "Passages to return."
                  },
                  "publishers": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Only these publications (names or ids)."
                  },
                  "published_after": {
                    "type": "string",
                    "format": "date"
                  },
                  "published_before": {
                    "type": "string",
                    "format": "date"
                  },
                  "max_charge_cents": {
                    "type": "integer",
                    "minimum": 1,
                    "description": "Never charge more than this for the answer."
                  }
                }
              },
              "example": {
                "query": "What is happening with embedded finance in Europe?"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The licensed passages with citations, the receipt, and the key holding any credit left. Or, when nothing on Opedd answers the question: no passages and nothing to pay."
          },
          "402": {
            "description": "Payment required: the price of this answer, the payment methods, the licence and the buyer terms."
          },
          "400": {
            "description": "The question is malformed."
          },
          "429": {
            "description": "Too many requests."
          },
          "503": {
            "description": "Temporarily unavailable."
          }
        }
      }
    }
  }
}