# Gapup Patent Landscape API

> Gapup Patent Landscape API is a paid API for AI agents from mcp.gapup.io, paid per call via x402, $0.08/call, status unknown (last checked 2026-09-14).

Search, analyze, and explore patent landscapes by keyword, company, inventor, or patent number across major jurisdictions

## Facts

- Endpoint: POST https://mcp.gapup.io/api/v1/call/patent_landscape
- Price: $0.08/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gapup-patent-landscape-api-fe47aa9b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iODdtqR32fA14EPc84GbE

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gapup-patent-landscape-api-fe47aa9b -d '<json body>'
```

Example prompt: Can you pull a patent landscape for 'solid-state battery' technology filed between 2019-01-01 and 2024-01-01, covering US, EP, and WO jurisdictions, returning up to 30 results?

## When to prefer this

Use this endpoint when you need to search or analyze patent data across major global jurisdictions (US, EP, WO, CN, JP, KR) by keyword, company, inventor, or patent number. Prefer this over general web search when you need structured patent data with filing dates, assignees, and jurisdictional coverage. The async mode is valuable for broad landscape queries that may take longer to process.

## Known failure modes

- Invalid query length (below 2 or above 500 characters) returns validation error
- Unsupported jurisdiction code returns error
- Date range in wrong format (not YYYY-MM-DD) returns parse error
- max_results outside 5-50 range returns validation error
- Missing or invalid API key returns 401 Unauthorized
- Payment not processed (x402 protocol) returns 402 Payment Required
- Async job_id poll returning pending if result not ready yet

## How this service works

REST gateway for the Gapup MCP catalogue — 271 AI tools accessible via standard HTTP. Authentication via Authorization: Bearer <api_key>. Native MCP transport available at /mcp.

## Output

Returns a JSON object with patent records or aggregate landscape distributions depending on mode. In search mode: list of matching patents with metadata. In landscape mode: aggregate statistics and distributions. In lookup mode: detailed record for a specific patent. If async=true, returns a job_id to poll for the result.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "search",
    "landscape",
    "lookup"
   ],
   "type": "string",
   "description": "search: keyword/inventor/assignee search; landscape: aggregate distributions; lookup: fetch by patent number. Default: \"search\""
  },
  "async": {
   "type": "boolean",
   "description": "If true, returns a job_id immediately (<200ms) instead of waiting for the result. Poll the result with job_result(job_id). Use for slow tools to avoid client timeouts."
  },
  "query": {
   "type": "string",
   "maxLength": 500,
   "minLength": 2,
   "description": "Keywords, company/inventor name, or patent number (e.g. \"machine learning\", \"Tesla Inc\", \"US10000000B2\")"
  },
  "date_to": {
   "type": "string",
   "description": "ISO date YYYY-MM-DD — latest filing date"
  },
  "date_from": {
   "type": "string",
   "description": "ISO date YYYY-MM-DD — earliest filing date"
  },
  "max_results": {
   "type": "number",
   "maximum": 50,
   "minimum": 5,
   "description": "Max patents to return (5-50). Default: 20"
  },
  "jurisdictions": {
   "type": "array",
   "items": {
    "enum": [
     "US",
     "EP",
     "WO",
     "CN",
     "JP",
     "KR"
    ],
    "type": "string"
   },
   "description": "Jurisdictions to include. Default: [\"US\",\"EP\",\"WO\"]"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": "patent_landscape",
  "result": {},
  "source": "rest-api"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gapup-patent-landscape-api-fe47aa9b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.gapup.io](https://www.zero.xyz/host/mcp.gapup.io/llms.txt)