{"uid":"cap_iODdtqR32fA14EPc84GbE","slug":"gapup-patent-landscape-api-fe47aa9b","name":"Gapup Patent Landscape API","description":"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.","url":"https://mcp.gapup.io/api/v1/call/patent_landscape","method":"POST","headers":{},"bodySchema":{"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\"]"}}},"responseSchema":{"type":"json","example":{"tool":"patent_landscape","result":{},"source":"rest-api"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.08","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.08/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CcKS-ih3ftcdhVWXHZOYz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.08","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search, analyze, and explore patent landscapes by keyword, company, inventor, or patent number across major jurisdictions","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Competitive patent analysis for new market entry","prompt":"I need to understand the patent landscape around AI-powered supply chain optimization. Can you search for patents from the last three years across US and EU jurisdictions, group the results by assignee company, and tell me who the major players are in this space?"},{"title":"Due diligence for acquisition target","prompt":"We're evaluating a company that claims expertise in quantum error correction. Can you look up all patents they've filed related to quantum computing and error correction, show me the filing dates and jurisdictions, and give me a summary of their patent portfolio strength?"},{"title":"Technology freedom-to-operate assessment","prompt":"Before we launch our new blockchain-based authentication product, can you search for existing patents in biometric authentication and decentralized identity across major jurisdictions? I want to see if there are any potential infringement risks we should be aware of."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:31:00.027Z","isFirstParty":false}