Skip to main content
OCLC Support

PID Lookup API

  1. Last updated
  2. Save as PDF
Discover the details of the Persistent Identifier (PID) Lookup API.

Overview

Based on a known Persistent Identifier (PID), find other semantically related PIDs. 

 Note: Included with OCLC Meridian Subscription.

To learn about OCLC APIs and get started with the PID Lookup API, see:

If you're ready to start using the PID Lookup API, the OCLC Developer Network can help you learn more. The OCLC Developer Network allows you to learn about OCLC APIs, view OCLC API documentation, and participate in the OCLC APIs community.

About PID Lookup API

entity_url table

entity_url table definitions:

id - The resource identifier assigned by the curating body.  Depending on the curator, it can correspond to the last segment of a URI path (e.g. http://id.loc.gov/authorities/names/n50031316)
curator - The label given to a body that assigns and manages authoritative resource ids.
uri - The entity URI has a same as relationship to the id + curator
entityMd5 - The entity's unique digital signature.

id curator uri
n50031316 dlcnames https://id.oclc.org/worldcat/entity/E39PBJx8JRbWpdcDTRw4GFVt8C
99251 fast https://id.oclc.org/worldcat/entity/E39PBJvd4Mwd74PrC378WH3vpP
ncf10891264 caoonl https://id.oclc.org/worldcat/entity/E39PBJgMv8x9xvDRdWk8bGJJjC
XX821717 bne https://id.oclc.org/worldcat/entity/E39PBJfCqFMHqxbm7wfwdRB9Dq

curator table

curator table definitions:

curator - The label given to a body that assigns and manages authoritative resource ids.
uri_pattern - The fixed path portion of the URI that is used by a curator (e.g. http://id.loc.gov/authorities/names/).
entity_label - The value of a label associated with a curator in the identifiedBy portion of an Entity JSON-LD record.
parenthetical - The leading value in an authority controlled heading link node, usually in the form of a MARC Organization Code surrounded by parentheses (e.g. (SpMaBN)).
source - The source attribute value in an authority controlled heading, usually relating to an internal data store (e.g. nlleocl).
description - The name of the curating body, and other metadata.
rules - When appropriate, these spell out edits that need to be performed when going from a resource id to a URI.

Curator Entity Label Description URI Pattern
arbabn ARBABN ID National Library of Argentina  
b2q B2Q ID National Library and Archives of Québec  
bav B2Q ID Vatican Library  
blbnd BLBND ID National Library of Brazil  
bnc BNC ID National Library of Catalonia  
bnchl BNCHL ID National Library of Chile  
bne (SpMaBN) National Library of Spain http://datos.bne.es/resource/
bnf   National Library of France https://data.bnf.fr/ark:/12148/
bnl BNL ID National Library of Luxembourg  
caoonl CAOONL ID Library and Archives Canada  
dbc DBC ID DBC Digital (Denmark)  
de633   International Inventory of Musical Sources http://data.rism.info/id/rismid/
dlc   Library of Congress http://id.loc.gov/authorities/
dlcnames (DLC) Library of Congress Names http://id.loc.gov/authorities/names/
dlcsubjects (DLC) Library of Congress Subjects http://id.loc.gov/authorities/subjects/
dnb (DE-588) German National Library http://d-nb.info/gnd/
doi   The DOI Foundation http://dx.doi.org/
egaxa EGAXA ID Bibliotheca Alexandrina (Egypt)  
errr ERRR ID ELNET Consortium of Estonian Libraries  
geonames   Geonames http://sws.geonames.org/
grateve   National Library of Greece http://data.nlg.gr/resource/authority/
hathitrust HathiTrust ID HathiTrust Digital Library  
iccu ICCU ID Central Institute for the Union Catalogue of Italian Libraries and for Bibliographic Information (ICCU)  
isni   ISNI International https://isni.org/isni/
j9u J9U ID National Library of Israel  
krnlk   National Library of Korea http://lod.nl.go.kr/resource/
lac LAC ID Library and Archives Canada (new work for OCLC/Canada)
lih LIH ID Martynas Mažvydas National Library of Lithuania  
lnb LNB ID National Library of Latvia  
mbz   MusicBrainz http://musicbrainz.org/work/
mrbnr MRBNR ID National Library of the Kingdom of Morocco  
ncl NCL ID National Central Library in Taiwan  
ndl   National Diet Library, Japan http://id.ndl.go.jp/auth/ndlna/
nkc NKC ID National Library of the Czech Republic  
nks NKS ID National and University Library in Zagreb  
nla NLA ID National Library of Australia  
nlb NLB ID National Library Board Singapore  
nli NLI ID National Library of Israel  
nlp NLP ID National Library of Poland  
nlr NLR ID National Library of Russia  
nszl NSZL ID National Széchényi Library, Hungary  
nta (NL-LeOCL) National Library of the Netherlands http://data.bibliotheken.nl/doc/thes/
nukat NUKAT ID University of Warsaw Library  
orcid   Orcid Inc. https://orcid.org/
perseus   Perseus Digital Library http://catalog.perseus.org/catalog/
plwabn PLWABN ID National Library of Poland  
ptbnp   National Library of Portugal http://id.bnportugal.gov.pt/aut/catbnp/
rero RERO ID Library Network of Western Switzerland  
selibr   National Library of Sweden http://libris.kb.se/resource/auth/
simacob SIMACOB ID Regional library network for Slovenia, Serbia, Macedonia, Bosnia and Herzegovina, Montenegro, Bulgaria, Albania, Kosovo  
skmasnl SKMASNL ID Slovak National Library  
sudoc   Bibliographic Agency for Higher Education http://www.idref.fr/
sz SZ ID Swiss National Library  
uiy UIY ID National Library of Iceland  
ulan   Getty Vocabularies - The Union List of Artist Names (ULAN) http://vocab.getty.edu/ulan/
viaf   VIAF http://viaf.org/viaf/
vlacc VLACC ID VLACC: Flemish Central Catalogue  
w2z   National Library of Norway https://livedata.bibsys.no/authority/
wikidata   Wikidata http://www.wikidata.org/entity/
wce   WorldCat Entities https://id.oclc.org/worldcat/entity/
fast (OCoLC) Faceted Application of Subject Terminology http://id.worldcat.org/fast/
yvnd YVND ID Yad Vashem Names Database - The World Holocaust Remembrance Center  

Path

v1/pid-lookup

Authorization scope

pidLookup

Example

To GET a request of all PID curators for OCLC Meridian:

GET command: https://entities.api.oclc.org/v1/pid-lookup/curator

PID Lookup API - Example
{
    "curator_id_map": [
        {
            "curator": "wce",
            "id": "E39PBJvcWMmYKPccxQcWQJPbBP",
            "scope":  ["all"]
        }
    ]
}
 
---------------------------------------------------------------------------------------------------------------------------------
 
{
    "total": 1,
    "results": [
        {
            "entityUri": https://id.oclc.org/worldcat/entity/E39PBJvcWMmYKPccxQcWQJPbBP,
            "target": "E39PBJvcWMmYKPccxQcWQJPbBP",
            "type": [
                "Person"
            ],
            "entityMd5": "dc7fa464dd1949c70d087db07b3b237c",
            "sameAsIdentifiers": [
                "NLP ID A12018958",
                "B2Q ID 0000021309",
                "BAV ID ADV10183446",
                "BLBND ID 000209751",
                "BNC ID a10281757",
                "NLR ID 7756377",
                "NKS ID 000014086",
                "NUKAT ID n97038230",
                "CAOONL ID ncf10125929",
                "LAC ID 0006C1279",
                "LIH ID LNB:V*159893374;=Bj",
                "LNB ID 000051119",
                "NKC ID jn20000720076",
                "NLI ID 000048721",
                "PLWABN ID 9810560667105606",
                "BNCHL ID 000010868",
                "DBC ID 87097968321034",
                "EGAXA ID vtls000824836",
                "NLA ID 35100032",
                "ERRR ID a11231828",
                "ICCU ID ITICCUCFIV071766",
                "J9U ID 987007261487405171",
                "SIMACOB ID 14762339",
                "SKMASNL ID vtls010595007",
                http://viaf.org/viaf/56609913,
                http://id.worldcat.org/fast/34115,
                http://www.wikidata.org/entity/Q34969,
                https://isni.org/isni/0000000121339941,
                http://id.loc.gov/authorities/names/n79043402,
                http://d-nb.info/gnd/118534912,
                https://data.bnf.fr/ark:/12148/cb119034658,
                https://data.bnf.fr/ark:/12148/cb11903465,
                http://id.ndl.go.jp/auth/ndlna/00440037,
                http://datos.bne.es/resource/XX877138,
                http://vocab.getty.edu/ulan/500331804,
                http://vocab.getty.edu/ulan/500331804-agent,
                https://livedata.bibsys.no/authority/90052017,
                http://www.idref.fr/026873478,
                http://lod.nl.go.kr/resource/KAC199609215,
                http://data.nlg.gr/resource/authority/A69541,
                http://data.bibliotheken.nl/doc/thes/p06836010X,
                http://data.rism.info/id/rismid/pe30016155,
                http://id.bnportugal.gov.pt/aut/catbnp/42484,
                http://libris.kb.se/resource/auth/54072
            ]
        }
    ]
}