Direkt zum Hauptinhalt

Primo REST API Search (geschlossen)

Primo Search bietet die Möglichkeit, in den Primo Pnx-Records nach Stichworten in den Indices title, creator, subject, usertag sowie in allen Indices ("überall") zu suchen. Für die Nutzung wird ein API Key benötigt, der nur für bibliotheksinterne Zwecke vergeben wird.

Resource URL

GET /primo/v1/search 

Ex Libris Dokumentation

https://developers.exlibrisgroup.com/primo/apis/docs/primoSearch/R0VUIC9wcmltby92MS9zZWFyY2g=/

Beschreibung

Primo Search liefert standardmässig JSON zurück.

Es werden 10 Records auf einmal zurückgegeben. Um die nächsten 10 zu erhalten, kann "&offset=10" an die URL angehängt werden (bei Offset 10 kommt Record 11 als erstes zurück).

Datengrundlage im Primo-Search-Index ist das sogenannte PNX-Record. Infos dazu finden sich hier: https://knowledge.exlibrisgroup.com/Primo/Product_Documentation/020Primo_VE/Primo_VE_(English)/120Other_Configurations/Mapping_to_the_Display%2C_Facets%2C_and_Search_Sections_in_the_Primo_VE_Record.

Allerdings scheinen nicht alle Indexfelder des PNX-Records dokumentiert zu sein, z.B. "lsr_56" fehlt, obwohl es in den Daten vorkommt (siehe Bsp. zu DDC unten).

Required arguments

  • vid
    vid=41SLSP_UZB:UZB

  • tab
    tab=default_tab

  • scope
    scope=default_scope

  • q
    Dieser Parameter enthält die eigentliche Suchabfrage. Syntax:
    field,precision,value

    Mögliche Werte für "fields":

    • any (for any field)
    • title
    • creator
    • sub (for subject)
    • usertag (for tag)


    Mögliche Werte für "precision":

    • exact
    • begins_with
    • contains


    Mögliche Werte für "value":
    The search terms, which can be a word, phrase, or exact phrase (group of words enclosed by quotes), and can include the following logical operators: AND, OR, and NOT.

    Beispiele:

      q=title,contains,home
      q=title,contains,pop music,AND;sub,contains,korean
    

Abfrage-Beispiele

Records mit Autor "Steinfels":

https://api-eu.hosted.exlibrisgroup.com/primo/v1/search?vid=41SLSP_UZB:UZB&tab=default_tab&scope=default_scope&q=creator,contains,steinfels&apikey=myapikey

Records mit Thema "Digital Humanities":

https://api-eu.hosted.exlibrisgroup.com/primo/v1/search?vid=41SLSP_UZB:UZB&tab=default_tab&scope=default_scope&q=sub,exact,%22digital%20humanities%22&apikey=myapikey

Es scheint bei diesem Bsp. keinen Unterschied zu machen, ob precision "exact" oder "contains" verwendet wird.

Records mit DDC (Dewey Decimal Classification) Notation für Digital Humanities oder Thema "Digital Humanities":

https://api-eu.hosted.exlibrisgroup.com/primo/v1/search?vid=41SLSP_UZB:UZB&tab=default_tab&scope=default_scope&q=sub,exact,%22digital%20humanities%22,OR;any,contains,001.30285&apikey=myapikey

DDC ist keines der Felder, das man spezifisch durchsuchen kann. Im PNX-Record scheint der Code im Feld "lsr_56" zu stehen.