{
  "openapi": "3.1.0",
  "info": {
    "title": "PatentPulse API",
    "description": "PatentPulse \u2014 global IP intelligence: USPTO/EPO/WIPO/JPO/CNIPA patent search, FTO analysis, SEP licensing, trademark clearance, prior art, and competitor patent landscape. Multilingual.",
    "version": "2.1.0",
    "contact": {
      "url": "https://patentpulse.vercel.app"
    },
    "x-agent-use-case": "on-demand",
    "x-agent-chaining": "Follow up with /filingspulse for SEC filings on assignee companies; /tradepulse for export-control classification on patented technologies; /alphapulse for investment signals on patent-rich sectors."
  },
  "servers": [
    {
      "url": "https://patentpulse.vercel.app"
    }
  ],
  "components": {
    "securitySchemes": {
      "x402": {
        "type": "apiKey",
        "in": "header",
        "name": "PAYMENT-SIGNATURE",
        "description": "x402 payment signature. Send a GET request without this header to receive a 402 with payment requirements. Sign the payment and retry with the PAYMENT-SIGNATURE header.",
        "required": true
      }
    }
  },
  "security": [
    {
      "x402": []
    }
  ],
  "paths": {
    "/api/patent/global": {
      "get": {
        "summary": "Jurisdiction-specific patent search \u2014 EPO, CNIPA, KIPO, JPO, WIPO PCT, DPMA, UKIPO, CIPO, IP Australia, INPI",
        "description": "Explicitly route a patent search to any of 12 patent offices worldwide. US queries hit real USPTO PatentsView API. EP queries hit real EPO OPS API for structured European patent data. All others use Tavily targeting the official patent office database. Returns top findings with assignees, dates, prosecution tips, and competitive landscape for the jurisdiction. Service links to Google Patents and Lens.org included. x-agent-use-case: on-demand for any non-US patent search, FTO in a specific market, or competitive intelligence in a specific jurisdiction.",
        "operationId": "patentGlobal",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Search query \u2014 technology keyword or assignee/company name"
          },
          {
            "name": "jurisdiction",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "US",
                "EP",
                "WO",
                "JP",
                "CN",
                "KR",
                "DE",
                "GB",
                "CA",
                "AU",
                "IN",
                "BR"
              ],
              "default": "WO"
            },
            "description": "Patent office code. EP = EPO (Europe), WO = WIPO PCT (international), CN = CNIPA (China), KR = KIPO (Korea), JP = JPO (Japan), DE = DPMA (Germany), GB = UKIPO, CA = CIPO (Canada), AU = IP Australia, IN = IPO India, BR = INPI (Brazil)"
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "keyword",
                "assignee"
              ],
              "default": "keyword"
            }
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Jurisdiction-specific patent intelligence with prosecution tips, competitive landscape, service links"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.1,
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Use /api/patent/fto to go deeper on blocking patents found here; use /api/patent/assignee on a company found here"
      }
    },
    "/api/patent/search": {
      "get": {
        "summary": "Global patent search (USPTO + global synthesis)",
        "description": "Search patents across USPTO (real API via PatentsView), EPO, WIPO, and JPO using real-time Tavily sourcing. Supports keyword, assignee, inventor, and title search modes. Best for broad multi-jurisdiction searches; use /api/patent/global for jurisdiction-specific deep dives. x-agent-use-case: on-demand when researching who holds patents in a technology area.",
        "operationId": "patentSearch",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Search query \u2014 keyword, company name, inventor name, or patent title"
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "keyword",
                "assignee",
                "inventor",
                "title"
              ],
              "default": "keyword"
            },
            "description": "Search type"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Response language (e.g. es, fr, ja, zh, de). Defaults to en."
          }
        ],
        "responses": {
          "200": {
            "description": "Patent search results with global coverage"
          },
          "402": {
            "description": "Payment required",
            "headers": {
              "PAYMENT-REQUIRED": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        },
        "x-price-usd": 0.08,
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Use /api/patent/assignee on a company found here; use /api/patent/fto on a technology found here"
      }
    },
    "/api/patent/cliff": {
      "get": {
        "summary": "Pharma patent cliff analysis",
        "description": "Drug patent cliff calendar covering US FDA Orange Book exclusivities, EU EMA data exclusivity, and Japan timelines. Returns generic entry dates, biosimilar entry windows, remaining patent term, revenue at risk, and investment implications. Used by pharma investors, generics manufacturers, and healthcare analysts. x-agent-use-case: on-demand when researching a specific drug for generic/biosimilar entry opportunities.",
        "operationId": "patentCliff",
        "parameters": [
          {
            "name": "drug",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Drug name \u2014 generic or brand (e.g. humira, ozempic, keytruda)"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Response language"
          }
        ],
        "responses": {
          "200": {
            "description": "Patent cliff analysis with multi-market expiry timeline"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.1,
        "x-agent-use-case": "on-demand"
      }
    },
    "/api/patent/fto": {
      "get": {
        "summary": "Freedom-to-operate analysis",
        "description": "Global FTO (freedom-to-operate) clearance analysis. Identifies blocking patents across USPTO (real API), EPO, WIPO, CNIPA, and JPO. Returns risk level (clear/caution/blocked), specific blocking patents with expiry dates, design-around suggestions, licensing contacts, and jurisdiction-specific risk assessment. Essential before product launch or market entry. x-agent-use-case: on-demand before any product launch or when evaluating IP risk in a technology area.",
        "operationId": "patentFTO",
        "parameters": [
          {
            "name": "technology",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Technology or product description for FTO analysis"
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "global"
            },
            "description": "Target jurisdiction (e.g. US, EU, China, Japan, global)"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "FTO analysis with blocking patents and risk assessment"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.15,
        "x-agent-use-case": "on-demand",
        "x-agent-chaining": "Use /api/patent/global with specific jurisdiction codes for deeper per-market FTO"
      }
    },
    "/api/patent/assignee": {
      "get": {
        "summary": "Company patent portfolio intelligence",
        "description": "Comprehensive patent portfolio analysis for any company or institution. Covers filing velocity, technology focus, competitive positioning, and licensing strategy.",
        "operationId": "patentAssignee",
        "parameters": [
          {
            "name": "company",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Company or institution name (e.g. Qualcomm, MIT, Samsung)"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Portfolio analysis with R&D intelligence"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.08,
        "x-agent-use-case": "on-demand"
      }
    },
    "/api/patent/prior-art": {
      "get": {
        "summary": "Prior art search",
        "description": "Preliminary prior art search for an invention with novelty and patentability assessment. Searches USPTO, EPO, WIPO, and academic literature.",
        "operationId": "patentPriorArt",
        "parameters": [
          {
            "name": "invention",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Invention description \u2014 be specific about the novel aspects"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Prior art search report with patentability assessment"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.1,
        "x-agent-use-case": "on-demand"
      }
    },
    "/api/patent/status": {
      "get": {
        "summary": "Patent status lookup",
        "description": "Full details for a specific patent \u2014 grant date, remaining life, assignee history, claim scope, and citation profile.",
        "operationId": "patentStatus",
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Patent number (e.g. 10000000 or US10,000,000)"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Patent status and details"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.05,
        "x-agent-use-case": "on-demand"
      }
    },
    "/api/patent/trends": {
      "get": {
        "summary": "Patent filing trends",
        "description": "Technology area filing trend analysis \u2014 top filers globally, geographic breakdown (US/China/EU/Japan), sub-areas, and investment signals.",
        "operationId": "patentTrends",
        "parameters": [
          {
            "name": "area",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Technology area (e.g. CRISPR, solid-state battery, large language models)"
          },
          {
            "name": "cpc",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "CPC classification code (e.g. G06N, H01M)"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Patent trend analysis"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.08,
        "x-agent-use-case": "on-demand"
      }
    },
    "/api/patent/sep": {
      "get": {
        "summary": "Standard Essential Patent landscape",
        "description": "SEP holder analysis, patent pools, FRAND licensing rates, and litigation landscape for a technology standard.",
        "operationId": "patentSEP",
        "parameters": [
          {
            "name": "standard",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "5g",
                "lte",
                "4g",
                "wifi",
                "wifi6",
                "bluetooth",
                "hevc",
                "h265",
                "h264",
                "avc",
                "av1",
                "vvc",
                "usbc",
                "nfc",
                "mp3",
                "aac"
              ]
            },
            "description": "Technology standard"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "SEP landscape with holders, pools, and FRAND analysis"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.12,
        "x-agent-use-case": "on-demand"
      }
    },
    "/api/patent/competitor": {
      "get": {
        "summary": "Competitor R&D intelligence",
        "description": "Decode a competitor's product roadmap and strategy from their patent filing patterns. Reveals emerging focus areas 18 months before products launch.",
        "operationId": "patentCompetitor",
        "parameters": [
          {
            "name": "company",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Company to analyze (e.g. Apple, Huawei, Samsung, Tesla)"
          },
          {
            "name": "area",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Optional focus area to narrow analysis"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Competitor R&D intelligence report"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.12,
        "x-agent-use-case": "on-demand"
      }
    },
    "/api/patent/trademark": {
      "get": {
        "summary": "Trademark clearance search",
        "description": "USPTO trademark clearance analysis \u2014 TESS database conflicts, confusion likelihood (sound, appearance, meaning, goods proximity), filing strategy recommendations, and international coverage guidance. Includes LegalZoom and USPTO TEAS direct filing links for immediate action after clearance. x-agent-use-case: on-demand before naming a company, product, or brand.",
        "operationId": "patentTrademark",
        "parameters": [
          {
            "name": "mark",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Trademark to search (e.g. PulsePay, NeuralFlow)"
          },
          {
            "name": "goods",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Goods or services description (e.g. payment software, clothing, restaurant services)"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Trademark clearance analysis"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-price-usd": 0.08,
        "x-agent-use-case": "on-demand"
      }
    }
  }
}