Linked open EP data

API Reference

This is the reference documentation for EPO linked data API. It lists the available endpoints, provides a brief description of the endpoint and a list of any specific viewers defined for the endpoint. The standard viewers, basic, describe, labelled describe and none (see the api overview document for a list of these) are available on all endpoints.

Endpoints

/linked-data/data/address
Returns a list of addresses. For privacy reasons the full address data is not provided.
Example Request Path: /linked-data/data/address
/linked-data/data/address/{signature}
Returns an address identified by a hash of the data from the address. For privacy reasons the full address is not provided.
/linked-data/data/publication
Returns bibliographic data from patent publications.
Viewers: short normal
Example Request Path: /linked-data/data/publication
/linked-data/data/publication/{st3Code}
Returns bibliographic data from publications published by a publication authority identified by its WIPO ST.3 code.
Viewers: short normal
Example Request Path: /linked-data/data/publication/EP
/linked-data/data/publication/{st3Code}/{publicationNumber}
Returns data for all publications for a patent identified by the WIPO ST.3 code of the publication authority and its publication number
Viewers: short normal
/linked-data/data/publication/{st3Code}/{publicationNumber}/{pubKind}
Returns bibliographic data from a specific kind of publication for a specific application identified by its publication number. There may be more than one publication.
Viewers: short normal
/linked-data/data/publication/{st3Code}/{publicationNumber}/{pubKind}/{pubDate}
Returns bibliographic data from a patent publication identified by its application authority {st3}, publication number, publication kind (A1, B2 etc) and publication date. The date component should be '-' in all cases except EPO A8, A9, B3, B8 and B9 publications, WO A3 publications, DE T3 publications and EA B2 publications.
Viewers: normal
/linked-data/data/publication/{st3Code}/{publicationNumber}/{pubKind}/{pubDate}/citation
Returns data for the citations for a publication. The publication is identified by the WIPO ST.3 code of the publication's publication authority, its publication number, publication kind and publication date as described the publication endpoint.
Viewers: normal
/linked-data/data/publication/{st3Code}/{publicationNumber}/{pubKind}/{pubDate}/citation/{hash}
Returns data for a particular citation. The publication with the citation is identified {st3Code}, {publicationNumber}, {pubKind} and {pubDate} as for the publication resource endpoint. The particular citation is identified by its hash value.
/linked-data/data/simple-family
Returns a list of simple families
Viewers: normal
Example Request Path: /linked-data/data/simple-family
/linked-data/data/simple-family/{familyId}
Returns data about a simple simple family.
Viewers: normal
/linked-data/data/vc
Returns a list of vcards.
Viewers: normal
Example Request Path: /linked-data/data/vc
/linked-data/data/vc/{signature}
Returns name and address information from a VCard identified by a hash of the vcard data. For privacy reasons a full address is not given.
Viewers: normal
/linked-data/def/
Returns a list of vocabularies organised under http://data.epo.org/linked-data/def/
Viewers: none scheme
Example Request Path: /linked-data/def/
/linked-data/def/cpc/scheme
Returns data about the CPC scheme
Viewers: normal
Example Request Path: /linked-data/def/cpc/scheme
/linked-data/def/cpc/{symbol}
Returns data about a CPC classification or other node.
Viewers: normal
Example Request Path: /linked-data/def/cpc/A
/linked-data/def/ipc/{symbol}
Returns data about an IPC classification
Viewers: normal
Example Request Path: /linked-data/def/ipc/A
/linked-data/def/st3/conceptScheme
returns data about the WIPO ST3 controlled vocabulary of countries and organizations.
Viewers: normal
Example Request Path: /linked-data/def/st3/conceptScheme
/linked-data/def/{scheme}
Returns a paged list of vocabulary terms from a given vocabulary.
Viewers: definition
Example Request Path: /linked-data/def/patent
/linked-data/def/{scheme}/
Returns information about a particular vocabulary.
Viewers: scheme
Example Request Path: /linked-data/def/patent/
/linked-data/def/{scheme}/{term}
Returns individual term definitions from a vocabulary.
Viewers: definition property class skos
Example Request Path: /linked-data/def/patent/Application
/linked-data/doc/application
Returns a list of applications. This endpoint will normally be used with filters to select the applications to return.
Viewers: full short
/linked-data/doc/application/{st3Code}
Returns a list of applications identified by the WIPO ST.3 code of their application authority.
Viewers: full short
Example Request Path: /linked-data/doc/application/EP
/linked-data/doc/application/{st3Code}/{applicationNumber}
Returns data about a patent application identified by the application authority (st3Code} and application number.
Viewers: full short
/linked-data/doc/st3
Returns a list of counties and organizations in the WIPO ST.3 controlled vocabulary.
Example Request Path: /linked-data/doc/st3
/linked-data/doc/st3/{st3Code}
Returns information about a country or organization identified by its WIPO ST.3 code.
Example Request Path: /linked-data/doc/st3/EP

Short Names

The API is configured with a set of short names that identify classes and properties that it is convenient to use in place of the longer and more verbose URLs that identify those classes and properties.

The following table lists those short names alongside the URLs they may be used to replace

Short Name URL
Class http://www.w3.org/2002/07/owl#Class
ConceptScheme http://www.w3.org/2004/02/skos/core#ConceptScheme
Datatype http://www.w3.org/2000/01/rdf-schema#Datatype
abstract http://purl.org/dc/terms/abstract
additionOf http://data.epo.org/linked-data/def/patent/additionOf
agentVC http://data.epo.org/linked-data/def/patent/agentVC
applicantVC http://data.epo.org/linked-data/def/patent/applicantVC
application http://data.epo.org/linked-data/def/patent/application
applicationAuthority http://data.epo.org/linked-data/def/patent/applicationAuthority
applicationKind http://data.epo.org/linked-data/def/patent/applicationKind
applicationNumber http://data.epo.org/linked-data/def/patent/applicationNumber
applicationNumberEpodoc http://data.epo.org/linked-data/def/patent/applicationNumberEpodoc
applicationNumberOriginal http://data.epo.org/linked-data/def/patent/applicationNumberOriginal
broader http://www.w3.org/2004/02/skos/core#broader
citation http://data.epo.org/linked-data/def/patent/citation
citationNPL http://data.epo.org/linked-data/def/patent/citationNPL
citationText http://data.epo.org/linked-data/def/patent/citationText
citesPatentPublication http://data.epo.org/linked-data/def/patent/citesPatentPublication
classificationCPCAdditional http://data.epo.org/linked-data/def/patent/classificationCPCAdditional
classificationCPCInventive http://data.epo.org/linked-data/def/patent/classificationCPCInventive
classificationIPCAdditional http://data.epo.org/linked-data/def/patent/classificationIPCAdditional
classificationIPCInventive http://data.epo.org/linked-data/def/patent/classificationIPCInventive
comment http://www.w3.org/2000/01/rdf-schema#comment
concordantCPC http://data.epo.org/linked-data/def/cpc/concordantCPC
concordantIPC http://data.epo.org/linked-data/def/cpc/concordantIPC
corrects http://data.epo.org/linked-data/def/patent/corrects
countryCode http://data.epo.org/linked-data/def/patent/countryCode
countryName http://www.w3.org/2006/vcard/ns#country-name
cpc-scheme http://data.epo.org/linked-data/def/cpc/scheme
cpcClassification http://data.epo.org/linked-data/def/cpc/classification
cpcSymbol http://data.epo.org/linked-data/def/cpc/symbol
date http://purl.org/dc/terms/date
divisionalOf http://data.epo.org/linked-data/def/patent/divisionalOf
domain http://www.w3.org/2000/01/rdf-schema#domain
family http://data.epo.org/linked-data/def/patent/familyMemberOf
familyMember http://data.epo.org/linked-data/def/patent/familyMember
filingDate http://data.epo.org/linked-data/def/patent/filingDate
filingLanguage http://data.epo.org/linked-data/def/patent/filingLanguage
fn http://www.w3.org/2006/vcard/ns#fn
format http://purl.org/dc/terms/format
fullTitle http://data.epo.org/linked-data/def/cpc/fullTitle
grantDate http://data.epo.org/linked-data/def/patent/grantDate
guidanceHeading http://data.epo.org/linked-data/def/cpc/guidanceHeading
hasAddress http://www.w3.org/2006/vcard/ns#hasAddress
hasCorrection http://data.epo.org/linked-data/def/patent/hasCorrection
hasTopConcept http://www.w3.org/2004/02/skos/core#hasTopConcept
hasVersion http://purl.org/dc/terms/hasVersion
internationalApplication http://data.epo.org/linked-data/def/patent/internationalApplication
inventorVC http://data.epo.org/linked-data/def/patent/inventorVC
ipcClassification http://data.epo.org/linked-data/def/ipc/classification
ipcSymbol http://data.epo.org/linked-data/def/ipc/symbol
isDefinedBy http://www.w3.org/2000/01/rdf-schema#isDefinedBy
isReplacedBy http://purl.org/dc/terms/isReplacedBy
isVersionOf http://purl.org/dc/terms/isVersionOf
label http://www.w3.org/2000/01/rdf-schema#label
language http://purl.org/dc/terms/language
level http://data.epo.org/linked-data/def/cpc/level
locality http://www.w3.org/2006/vcard/ns#locality
member http://www.w3.org/2004/02/skos/core#member
modified http://purl.org/dc/terms/modified
narrower http://www.w3.org/2004/02/skos/core#narrower
notation http://www.w3.org/2004/02/skos/core#notation
priority http://data.epo.org/linked-data/def/patent/priority
proceduralLanguage http://data.epo.org/linked-data/def/patent/proceduralLanguage
publication http://data.epo.org/linked-data/def/patent/publication
publicationAuthority http://data.epo.org/linked-data/def/patent/publicationAuthority
publicationDate http://data.epo.org/linked-data/def/patent/publicationDate
publicationKind http://data.epo.org/linked-data/def/patent/publicationKind
publicationKindLabel http://data.epo.org/linked-data/def/patent/publicationKindLabel
publicationNumber http://data.epo.org/linked-data/def/patent/publicationNumber
range http://www.w3.org/2000/01/rdf-schema#range
replaces http://purl.org/dc/terms/replaces
representation http://data.epo.org/linked-data/def/patent/representation
representativeFamilyMember http://data.epo.org/linked-data/def/patent/representativeFamilyMember
seeAlso http://www.w3.org/2000/01/rdf-schema#seeAlso
sortKey http://data.epo.org/linked-data/def/cpc/sortKey
sourcePublication http://data.epo.org/linked-data/def/patent/sourcePublication
streetAddress http://www.w3.org/2006/vcard/ns#street-address
subClassOf http://www.w3.org/2000/01/rdf-schema#subClassOf
subPropertyOf http://www.w3.org/2000/01/rdf-schema#subPropertyOf
title http://purl.org/dc/terms/title
titleOfInvention http://data.epo.org/linked-data/def/patent/titleOfInvention
titleXML http://data.epo.org/linked-data/def/cpc/titleXML
topConceptOf http://www.w3.org/2004/02/skos/core#topConceptOf
type http://www.w3.org/1999/02/22-rdf-syntax-ns#type
vcAgentOf http://data.epo.org/linked-data/def/patent/vcAgentOf
vcApplicantOf http://data.epo.org/linked-data/def/patent/vcApplicantOf
vcInventorOf http://data.epo.org/linked-data/def/patent/vcInventorOf