data

Search, analyze and map patent landscapes across major jurisdictions (US, EP, WO, CN, JP, KR). Three modes: (1) search —

Search, analyze and map patent landscapes across major jurisdictions (US, EP, WO, CN, JP, KR). Three modes: (1) search — find patents by keywords, company name or inventor name; (2) landscape — aggregate distributions: top assignees, top inventors, CPC class breakdown, filings by year, citation leaders, white-space innovation opportunities; (3) lookup — retrieve a specific patent by number (e.g. US10000000B2, EP3456789A1, WO2023/123456). Primary source: WIPO PatentScope (WO PCT, keyless). Optional sources: USPTO PatentsView (US, env PATENTSVIEW_API_KEY), EPO OPS (EP/WO, env EPO_OPS_CONSUMER_KEY + EPO_OPS_CONSUMER_SECRET), Lens.org (global, env LENS_API_TOKEN). Use cases: freedom-to-operate (FTO) analysis, R&D gap identification, VC due diligence IP audit, competitor patent portfolio mapping, inventor network analysis. SLA: <=24s p95 (parallel fetches, 8s per source). Cache: 24h TTL (patent data stable). Quality score: 30 pts per retrieved source (max 90), +10 if >=10 patents, +10 bonus for landscape mode with non-empty top_assignees.

post/api/v1/call/patent_landscape

Request

  • Base URL: https://mcp.gapup.io
  • URL: https://mcp.gapup.io/api/v1/call/patent_landscape
  • Auth: HTTP bearer

Request body

querystring required

Keywords, company/inventor name, or patent number (e.g. "machine learning", "Tesla Inc", "US10000000B2")

mode'search' | 'landscape' | 'lookup'

search: keyword/inventor/assignee search; landscape: aggregate distributions; lookup: fetch by patent number. Default: "search"

jurisdictionsstring[]

Jurisdictions to include. Default: ["US","EP","WO"]

date_fromstring

ISO date YYYY-MM-DD — earliest filing date

date_tostring

ISO date YYYY-MM-DD — latest filing date

max_resultsnumber

Max patents to return (5-50). Default: 20

asyncboolean

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.

Response

Tool result

toolstring
request_idstring
source'rest-api'
msnumber

Changes

No recorded changes to this operation across all 1 revision of this API.