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:

• OCLC APIs > Get Started
• WorldCat Entities API context JSON
• WorldCat ontology guidelines and standards

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.

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.

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.

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

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

Example code:

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