Patent Search API - IFI CLAIMS Families, Citations, Status avatar

Patent Search API - IFI CLAIMS Families, Citations, Status

Pricing

$10.00 / 1,000 patent record returneds

Go to Apify Store
Patent Search API - IFI CLAIMS Families, Citations, Status

Patent Search API - IFI CLAIMS Families, Citations, Status

Search 180M+ global patent documents with the IFI CLAIMS Direct API: keywords, assignee, inventor, CPC, country and date filters, plus simple and extended patent families, IFI status and expiry dates, and forward and backward citations. Bring your own CLAIMS Direct login.

Pricing

$10.00 / 1,000 patent record returneds

Rating

0.0

(0)

Developer

Nabeel Hassan

Nabeel Hassan

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

a month ago

Last modified

Features

Limited permissions

Share

Search more than 180 million global patent records and read patent families, IFI patent status and anticipated expiration dates, and forward and backward citations, from the IFI CLAIMS Direct Web Services API with your own login, as clean dataset rows.

Works with the official CLAIMS Direct Web Services (CDWS) REST API from IFI CLAIMS Patent Services: the Solr powered Search service, the Family service (simple and extended families and family status) and the Citation service. Each patent document becomes one row with ucid, title, abstract, publication, filing and priority dates, applicants, IFI standardized assignee names, inventors, IPC and CPC classes and DOCDB family ID. Download as JSON, CSV or Excel, schedule it, or feed it into prior art searches, freedom to operate screening, competitor patent monitoring, portfolio analytics, licensing research, Google Sheets and AI agents. Bring your own CLAIMS Direct user name and password.

BYOK, not live-tested: every endpoint, parameter and field comes from IFI CLAIMS' public CLAIMS Direct documentation (docs.ificlaims.com), and the host and header authentication were confirmed on cdws21.ificlaims.com, but the actor has not been run against a live CLAIMS Direct subscription.

What it does

  • Patent search: a Solr query over the full CLAIMS Direct index, built from simple filters (keywords in title, abstract and claims; applicant or assignee; inventor; patent offices; CPC classes; publication date range) or written by hand in the Lucene query language. Sort by publication, filing or priority date, or by relevance. Pages 100 documents per request, up to 30,000 results.
  • Patent family: the simple family (same priorities, with the DOCDB family ID) or the extended family (every document linked through any shared priority, like an INPADOC family) of each ucid, one row per member.
  • Family status and expiry: every simple family member with the IFI calculated patent status (such as Ceased), the anticipated expiration date and the EPO INPADOC legal status events.
  • Patent citations: backward citations (the prior art a patent cites) or forward citations (the later patents that cite it), with publication date, first applicant or assignee, inventor and first CPC class, and optionally the citation source (search report, examiner, applicant).
  • Batching: family, status and citation lookups send up to 100 ucids per request, the documented limit.
  • Pay only for results: refused and empty queries are recorded as a free row that says why, never charged.

How to get CLAIMS Direct credentials

CLAIMS Direct access is sold by IFI CLAIMS Patent Services (part of Digital Science), not self-served. Use the contact form on ificlaims.com to request a CLAIMS Direct trial or subscription for the shared web services (CDWS). IFI CLAIMS issues a web services user name and password. Paste the user name into CLAIMS Direct user name and the password into CLAIMS Direct password, or set the DATA_API_KEY secret as user:password. They are sent only in the x-user and x-password headers to cdws21.ificlaims.com and are never logged. Your subscription decides which countries, services and data (for example full text, IFI Snapshots, legal status) you can read.

Input

FieldModesDescription
modeallsearch, family, familyStatus or citations
keywordssearchSearched in titles, abstracts and claims (tac), Lucene syntax allowed
assigneesearchApplicant, assignee or reassignee name, searched as a phrase (pa)
inventorsearchInventor name as a phrase, family name first (inv)
countriessearchPublishing office codes such as US, EP, WO, CN, JP (pnctry)
cpcClassessearchCPC symbols at any level: H01M, H01M 10, H01M 10/0525 (cpc)
publishedFrom, publishedTosearchPublication date range, YYYY-MM-DD (pd)
querysearchAny CLAIMS Direct Solr query, combined with the filters by AND
sortsearchpd desc (default), pd asc, ad desc, ad asc, prid asc, score desc
includeFamily, includeCitationssearchAsk the search service for the simple family and citations of each result
ucidsfamily, familyStatus, citationsCLAIMS Direct ucids such as US-5551212-A or EP-0700000-B1
familyTypefamilysimple (default) or extended
citationDirectioncitationsbackward (default) or forward
citationDetailscitationsAdd date, applicant, inventor and CPC of each citation (default on)
citationSourcecitationsAdd the citation source category
maxResultsallRow ceiling for the run (default 100)
requestsPerMinuteallPacing, default 30
apiUser, apiPasswordallYour CLAIMS Direct login (or the DATA_API_KEY secret as user:password)

Example: newest US and EP solid state battery patents in CPC H01M filed by Toyota.

{
"mode": "search",
"keywords": "\"solid state battery\" OR \"solid electrolyte\"",
"assignee": "toyota",
"countries": ["US", "EP"],
"cpcClasses": ["H01M"],
"publishedFrom": "2023-01-01",
"maxResults": 200
}

Example: forward citations of two patents.

{
"mode": "citations",
"ucids": ["US-5551212-A", "EP-0700000-A2"],
"citationDirection": "forward"
}

Example output

An illustrative search row, shaped like the documented CLAIMS Direct search response (values are an example, not real data).

{
"mode": "search",
"recordType": "patent",
"identifier": "tac:(\"solid state battery\") AND pnctry:(US OR EP)",
"found": true,
"ucid": "US-11811234-B2",
"country": "US",
"kindCode": "B2",
"title": "Solid state battery with sulfide electrolyte layer",
"abstract": "A solid state battery includes a cathode layer, an anode layer and a sulfide solid electrolyte layer...",
"publicationNumber": "US-11811234-B2",
"publicationDate": "2025-11-07",
"filingDate": "2022-03-14",
"applicationNumber": "US-202217694512-A",
"applicants": ["TOYOTA MOTOR CORP"],
"ifiAssignees": ["Toyota Motor Corp"],
"inventors": ["YAMADA TARO"],
"ipcClasses": ["H01M 10/0562 20100101AFI20251107BHUS"],
"cpcClasses": ["H01M 10/0562 20130101 FI20251107BHUS"],
"familyId": 81234567,
"priorityNumbers": ["JP-2021052211-A"],
"earliestPriorityDate": "2021-03-25",
"claimsCount": 12,
"independentClaimsCount": 2,
"score": 7.31,
"titles": { "en": "Solid state battery with sulfide electrolyte layer" },
"extras": null,
"retrievedAt": "2026-10-17T08:00:00.000Z",
"note": null
}

A family status row adds rootUcid, ifiStatus (such as Ceased), anticipatedExpiration, epoLegalStatus (country, impact, code, title, date) and latestLegalEvent. A citation row adds rootUcid, citationDirection and citationSource.

FAQ

What is the IFI CLAIMS Direct API?

CLAIMS Direct is the global patent data platform of IFI CLAIMS Patent Services, a Digital Science company. Its Web Services (CDWS) are REST services on cdws21.ificlaims.com authenticated with x-user and x-password headers, covering search, full text XML, reporting, attachments, citations, legal status, families, IPC and CPC descriptions, standardized names and litigation, over more than 180 million patent records.

What is a ucid?

A ucid (unique character identifier) is how CLAIMS Direct names a publication: country code, number and kind code joined by hyphens, such as US-5551212-A, EP-0700000-B1 or US-20100077592-A1. The ucid column of every search row can be pasted into the family, status and citation modes.

What is the difference between a simple and an extended patent family?

A simple family groups documents that share exactly the same priorities and carries the DOCDB family ID assigned by the EPO. An extended family, similar to an INPADOC family, adds every document connected through any shared priority, so it is usually larger. CLAIMS Direct builds extended families on request.

How does CLAIMS Direct know if a patent is still in force?

For countries with IFI Snapshots (US, EP, AU, CA, DE, ES, FR, GB, JP, and CN on Premium Plus), IFI calculates a current status and an anticipated expiration date from legal events, term adjustments, terminal disclaimers and regulatory extensions. EPO INPADOC legal events are included too. IFI notes these indicators are not authoritative: consult an attorney or the patent office before relying on an expiry date.

Which fields can a search return?

Only the stored Solr fields: ucid, publication number, titles and abstracts in every language, publication, filing and earliest priority dates, application number, applicants, IFI assignees, inventors, IPC and CPC display classes, family ID, priority numbers and claim counts. Every indexed field can still be searched in the Solr query, including full text descriptions and claims.

Are there rate limits?

Yes. CLAIMS Direct shared services allow 60 to 240 request units per 60 second window per login, where a search request weighs 1.5 units and a family or citation request 1 unit. The actor paces itself (30 requests per minute by default) and waits out any HTTP 429. Search cannot page deeper than 30,000 results.

What do I pay?

Pay per result: 0.01 USD per row, where a row is one patent document, family member, family status record or citation. Refused and empty queries are never charged. Your CLAIMS Direct subscription is billed separately by IFI CLAIMS.

Pricing

EventPriceCharged for
patent-record0.01 USDEach patent document, family member, family status record or citation

Keyword map

patent search API, patent data API, IFI CLAIMS API, CLAIMS Direct API, global patent database, patent family API, INPADOC family, DOCDB family ID, patent citation API, forward citations, backward citations, prior art search, patent expiration date, patent legal status, standardized assignee names, CPC classification search, IPC classification, competitor patent monitoring, freedom to operate, patent analytics, patent data for AI agents.

Terms and data use

CLAIMS Direct data is licensed under your agreement with IFI CLAIMS. The public IFI website terms limit use of the service to your own internal use unless IFI agrees otherwise in writing, and forbid redistributing the content, making it available to others, or using it to power products or search tools for other people; your CLAIMS Direct contract prevails where it differs. The shared services also prohibit bulk downloading. Run this actor with your own login, keep the results for your own internal use within your licence, and contact IFI CLAIMS before sharing, publishing or reselling the data. This actor is not affiliated with or endorsed by IFI CLAIMS Patent Services or Digital Science.