patents

Search US patent applications and grants via the USPTO Open...

Search US patent applications and grants via the USPTO Open Data Portal. Query: q (required, 2+ chars), yearFrom / yearTo (optional filing-year bounds), applicationType (optional: Utility|Design|Plant|Reissue), limit (1-100, default 10), offset (0-based, default 0). Returns { total, returned, offset, limit, hits[{ applicationNumber, title, applicationType, firstInventor, inventors[], applicants[], filingDate, effectiveFilingDate, status:{ code, description, updatedAt }, cpcSymbols[], uspcSymbol, url }] }. URLs link to USPTO Patent Center for the public file wrapper.

get/api/patents/search

Request

  • Base URL: https://2s.io
  • URL: https://2s.io/api/patents/search
  • Auth: API key in header PAYMENT-SIGNATURE

Query parameters

qstring required

Free-text search query.

yearFrominteger

Year from.

yearTointeger

Year to.

applicationType'Utility' | 'Design' | 'Plant' | 'Reissue'

Application type.

limitinteger

Maximum number of results to return.

offsetinteger

Number of results to skip before returning (pagination offset).

trial1

Try before you buy. Set to 1 for one free real call per endpoint per hour — no wallet or payment needed — to verify the endpoint before paying. Equivalent to sending the "X-2s-Trial: 1" request header. Listed only on operations that offer a trial; the others always answer 402.

Response

(unresolved $ref)

Changes

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