Maxwell International Uspto API
The uspto API from Maxwell International — 1 operation(s) for uspto.
The uspto API from Maxwell International — 1 operation(s) for uspto.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/maxwellinternational-ai:maxwellinternational-ai-uspto-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Maxwell International Data (x402) Uspto API
version: 1.0.0
description: Machine-only pay-per-call data API over x402. Prices are per request in USDC.
x-guidance: 'Pay-per-call data for ski trips and public records, plus x402 Doctor, which tests other x402 endpoints for you. Ski: a directory of about 6,000 ski resorts worldwide, lift-ticket prices for the resorts listed at /v1/ski/coverage, a model forecast for every resort (station readings where one of 11 European met services has a station), lift status and snow reports only at about 50 resorts with their own feed (in Poland, Slovakia, Switzerland, Liechtenstein and Friuli in Italy; only while current), insider tips, and the Trip Wizard (a free map, then one paid call per trip step). Food: restaurants around ski resorts in every country listed at /v1/food/coverage (free, with per-country counts), with opening hours, website and contacts where known. Menus and prices only where read (withMenu): in Andorra, Austria, Bulgaria, Czechia, Finland, France, Germany, Italy, Liechtenstein, Norway, Poland, Slovakia, Slovenia, Spain, Sweden and Switzerland from the restaurant’s own website or, where none is published, a delivery app; in every other country only where a delivery app (Wolt, Bolt Food, Glovo, Pyszne.pl) lists the restaurant, as restaurants’ own websites are read for menus only in those 16 countries. Public data: SEC EDGAR, government registers and legislation of 13 countries and the EU, OFAC SDN, NVD CVEs, openFDA, NOAA weather (US), ECB FX, FRED, npm, RDAP domain records, crypto market quotes, US court opinions, US patents. Paid operations are GET, except doctor.payment and llm.chat (POST with a JSON body). Call one without payment to receive HTTP 402 with a PAYMENT-REQUIRED header (x402 v2): USDC on Base (eip155:8453) or Solana, settled through the Coinbase CDP facilitator. Send the same request again with a PAYMENT-SIGNATURE header. You are charged only for a 2xx answer. Missing or ambiguous parameters get a free 400 or 409 and a request with no data on file a free 404, both with charged:false. A search that runs and finds nothing is a 2xx answer (match:false) and is charged. Most routes check parameters before asking for payment. A bare path (directory probes), ski.prices without country, gov.de legislation and open data, and a POST without the fields it needs get the 402 first; after payment a request that cannot be answered still gets a free 400 (ski.prices answers if the resort id is unique). food.menu without restaurantId is a free 404. Paid answers that can look empty: a search with no matches (match:false), an RDAP lookup of an unregistered domain (registered:false) or of a registry without RDAP (rdapAvailable:false), and gov.de legislation or open data without q or id (the index of what is cached). doctor.buy and llm.chat collect the payment before they run: doctor.buy charges for the attempt, delivered or not; if the llm.chat model fails after payment, the answer (HTTP 503, llm_failed_after_payment) says charged:true and the payment is refunded by hand. A lookup of one item that is not cached yet (CVE, accession, company number, coordinates) is usually queued: retry after retryAfterSec. Priced per request (x-payment-info mode dynamic, with min and max where there is one): doctor.buy, llm.chat, trip.bundle; the 402 quotes the exact amount. Every other product has one price. Each response carries fetchedAt or generatedAt. Forecasts refresh every 6 hours, and lift status every 15 minutes where the resort has a feed. Hand-checked lift-ticket prices were read from official price lists on Oct 7-9, 2026 (rechecks from Nov 8); the others come from a weekly crawl of the resort''s price pages or from an earlier collection (operator shops, price pages); every row has its source link and read date. Public records refresh on each source''s schedule (age per family at /health). Free status and coverage endpoints are listed at /catalog.json; terms at /terms.json. Free samples: most products have one real request you can call free to check the data first (freeSampleUrl in /catalog.json, x-free-sample here, freeSample in every 402): the same answer a buyer of that request gets.'
contact:
name: Maxwell International
email: accounts@maxwellinternational.ai
url: https://api.maxwellinternational.ai/terms.json
termsOfService: https://api.maxwellinternational.ai/terms.json
servers:
- url: https://api.maxwellinternational.ai
tags:
- name: uspto
paths:
/v1/uspto/patent:
get:
operationId: uspto_patent
summary: US patent search by keywords (?q=, every word must match; up to 10 USPTO…
description: 'US patent search by keywords (?q=, every word must match; up to 10 USPTO applications and grants, newest filing first) or one patent by number (?patentNumber=US11000000). Each result: title, assignee, inventors, CPC classes, filing and grant dates, USPTO status, and patentNumber for granted patents or applicationNumber for pending applications. Uncached: 404, not charged.'
tags:
- uspto
parameters:
- name: q
in: query
required: false
schema:
type: string
description: Keyword search; use q or patentNumber
example: lithium battery anode
- name: patentNumber
in: query
required: false
schema:
type: string
description: US granted patent number
example: US11000000
x-payment-info:
price:
mode: fixed
currency: USD
amount: '0.005'
protocols:
- x402: {}
x-free-sample:
url: https://api.maxwellinternational.ai/v1/uspto/patent?q=lithium%20battery%20anode&sample=1
note: 'This exact request is free (a few per hour): the same answer a buyer gets.'
responses:
'200':
description: Paid response (charged)
content:
application/json:
schema:
type: object
properties:
sku:
type: string
mode:
type: string
query:
type: string
hits:
type: array
items:
type: object
properties:
patentNumber: {}
applicationNumber:
type: string
title:
type: string
assignee:
type: string
inventors:
type: array
items:
type: string
cpc:
type: array
items:
type: string
filingDate:
type: string
grantDate: {}
status:
type: string
granted:
type: boolean
count:
type: integer
totalCount:
type: integer
fetchedAt:
type: string
source:
type: string
granted:
type: boolean
notice:
type: string
match:
type: boolean
example:
sku: uspto.patent
mode: search
query: lithium battery anode
hits:
- patentNumber: null
applicationNumber: '19708778'
title: SECONDARY LITHIUM BATTERY ANODE AND SECONDARY LITHIUM BATTERY INCLUDING SAME
assignee: SAMSUNG SDI CO., LTD.
inventors: []
cpc: []
filingDate: '2026-06-15'
grantDate: null
status: Docketed New Case - Ready for Examination
granted: false
count: 10
totalCount: 1212
fetchedAt: '2026-10-05T02:30:44.990Z'
source: uspto-odp
granted: false
notice: 'Source: USPTO Open Data Portal (U.S. government public data). Status is the U…'
match: true
'400':
description: Missing, malformed or ambiguous parameters; not charged (charged:false). Most routes answer it before asking for payment.
'402':
description: Payment Required
'404':
description: No data on file for this request (not cached or not found); not charged (charged:false)