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.

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
            ]
        }
    ]
}