BiblioID Copy Cataloging XML API

API XML untuk copy cataloging dan pertukaran data bibliografi

Overview

This API provides access to bibliographic data in MODS 3.3 XML format. It supports searching by various criteria and retrieving detailed bibliographic records.

Base URL: https://get.biblio.id

Output Format: XML (MODS 3.3)

Character Encoding: UTF-8

Disclaimer

Please read carefully before using this API:

  • Data Sources & Accuracy: Content is aggregated from various open sources on the internet. We do not claim ownership and cannot guarantee accuracy, completeness, or reliability of the data.
  • No Warranty & Liability: This API is provided "as is" without any warranty. We are not liable for any damages arising from its use or inability to use.
  • Service Availability: We do not guarantee continuous availability. Service may be interrupted or modified without notice.
  • Rate Limiting: Usage is limited to 1000 requests per 1 hour. Exceeding this may result in temporary access restrictions.
  • Fair Use: Intended for legitimate research and integration. Abuse or excessive usage may result in access revocation.

By using this API, you acknowledge and agree to these terms.

Endpoints

The API provides 5 endpoints for searching and retrieving bibliographic data:

1. Search by Title

Parameter Type Required Description
resultXML string Yes Must be "true"
title string Yes Title keywords to search
search string Yes Must be "Search"
page integer No Page number (default: 1)

2. Search by ISBN/ISSN

Parameter Type Required Description
resultXML string Yes Must be "true"
isbn string Yes ISBN/ISSN to search
search string Yes Must be "Search"
page integer No Page number (default: 1)

3. Search by Author

Parameter Type Required Description
resultXML string Yes Must be "true"
author string Yes Author name to search
search string Yes Must be "Search"
page integer No Page number (default: 1)

4. Search by Keywords

Parameter Type Required Description
resultXML string Yes Must be "true"
keywords string Yes Keywords to search (title, notes, sor, isbn_issn)
search string Yes Must be "Search"
page integer No Page number (default: 1)

5. Get Detail by ID

Parameter Type Required Description
p string Yes Must be "show_detail"
id integer Yes Bibliographic record ID
inXML integer Yes Must be "1"

Examples

Search by Title:

https://get.biblio.id?resultXML=true&title=database&search=Search&page=1

Search by ISBN:

https://get.biblio.id?resultXML=true&isbn=978-0-123456-78-9&search=Search

Search by Author:

https://get.biblio.id?resultXML=true&author=Smith&search=Search

Search by Keywords:

https://get.biblio.id?resultXML=true&keywords=information+technology&search=Search

Get Detail by ID:

https://get.biblio.id?p=show_detail&id=12345&inXML=1

Response Format

All responses are in XML format using the MODS 3.3 schema (Metadata Object Description Schema).

MODS Schema: http://www.loc.gov/standards/mods/v3/mods-3-3.xsd

Success Response (Search):

<?xml version="1.0" encoding="UTF-8"?>
<modsCollection xmlns:xlink="http://www.w3.org/1999/xlink" 
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
                xmlns="http://www.loc.gov/mods/v3" 
                xmlns:slims="http://slims.web.id" 
                xsi:schemaLocation="http://www.loc.gov/mods/v3 http://www.loc.gov/standards/mods/v3/mods-3-3.xsd">
  <slims:resultInfo>
    <slims:modsResultNum>150</slims:modsResultNum>
    <slims:modsResultPage>1</slims:modsResultPage>
    <slims:modsResultShowed>20</slims:modsResultShowed>
  </slims:resultInfo>
  <mods version="3.3" id="12345">
    <!-- Bibliographic data in MODS 3.3 format -->
  </mods>
</modsCollection>

Error Response:

<?xml version="1.0" encoding="UTF-8"?>
<error>
  <code>400</code>
  <message>Invalid API endpoint</message>
  <http_status>400</http_status>
</error>

Response Headers:

  • Content-Type: application/xml; charset=UTF-8
  • X-Rate-Limit-Remaining: 55 (remaining requests)
  • X-Rate-Limit-Reset: 1738023456 (Unix timestamp when limit resets)

Rate Limiting

The API implements rate limiting to ensure fair usage:

  • Limit: 1000 requests per 1 hour per IP address
  • Window: 1 hour (3600 seconds)
  • Tracking: Based on client IP address (hashed for privacy)

When the rate limit is exceeded, the API returns a 429 (Too Many Requests) error response with information about when the limit will be reset.

Check the response headers X-Rate-Limit-Remaining and X-Rate-Limit-Reset to monitor your usage.

Error Codes

Code Description Cause
200 OK Request successful
400 Bad Request Invalid parameters, missing required fields, or malformed request
404 Not Found Bibliographic record with specified ID does not exist
429 Too Many Requests Rate limit exceeded (more than 1000 requests per 1 hour)
500 Internal Server Error Server error occurred during request processing

Ikhtisar

API ini menyediakan akses ke data bibliografi dalam format XML MODS 3.3. API mendukung pencarian berdasarkan berbagai kriteria dan pengambilan catatan bibliografi detail.

URL Dasar: https://get.biblio.id

Format Output: XML (MODS 3.3)

Encoding Karakter: UTF-8

Disclaimer

Harap dibaca dengan saksama sebelum menggunakan API ini:

  • Sumber Data & Akurasi: Konten diambil dari berbagai sumber terbuka di internet. Kami tidak mengklaim kepemilikan dan tidak dapat menjamin keakuratan, kelengkapan, atau keandalan data.
  • Tanpa Jaminan & Tanggung Jawab: API ini disediakan "sebagaimana adanya" tanpa jaminan apapun. Kami tidak bertanggung jawab atas kerusakan yang timbul dari penggunaan atau ketidakmampuan menggunakan API ini.
  • Ketersediaan Layanan: Kami tidak menjamin ketersediaan terus-menerus. Layanan dapat terputus atau dimodifikasi tanpa pemberitahuan.
  • Pembatasan Akses: Penggunaan dibatasi 1000 permintaan per 1 jam. Melebihi batas dapat mengakibatkan pembatasan akses sementara.
  • Penggunaan Wajar: Ditujukan untuk penelitian dan integrasi yang sah. Penyalahgunaan atau penggunaan berlebihan dapat mengakibatkan pencabutan akses.

Dengan menggunakan API ini, Anda mengakui dan menyetujui ketentuan ini.

Titik Akses

API menyediakan 5 endpoint untuk pencarian dan pengambilan data bibliografi:

1. Pencarian berdasarkan Judul

Parameter Tipe Wajib Deskripsi
resultXML string Ya Harus bernilai "true"
title string Ya Kata kunci judul yang dicari
search string Ya Harus bernilai "Search"
page integer Tidak Nomor halaman (default: 1)

2. Pencarian berdasarkan ISBN/ISSN

Parameter Tipe Wajib Deskripsi
resultXML string Ya Harus bernilai "true"
isbn string Ya ISBN/ISSN yang dicari
search string Ya Harus bernilai "Search"
page integer Tidak Nomor halaman (default: 1)

3. Pencarian berdasarkan Pengarang

Parameter Tipe Wajib Deskripsi
resultXML string Ya Harus bernilai "true"
author string Ya Nama pengarang yang dicari
search string Ya Harus bernilai "Search"
page integer Tidak Nomor halaman (default: 1)

4. Pencarian berdasarkan Kata Kunci

Parameter Tipe Wajib Deskripsi
resultXML string Ya Harus bernilai "true"
keywords string Ya Kata kunci yang dicari (judul, catatan, sor, isbn_issn)
search string Ya Harus bernilai "Search"
page integer Tidak Nomor halaman (default: 1)

5. Ambil Detail berdasarkan ID

Parameter Tipe Wajib Deskripsi
p string Ya Harus bernilai "show_detail"
id integer Ya ID catatan bibliografi
inXML integer Ya Harus bernilai "1"

Contoh Penggunaan

Pencarian berdasarkan Judul:

https://get.biblio.id?resultXML=true&title=database&search=Search&page=1

Pencarian berdasarkan ISBN:

https://get.biblio.id?resultXML=true&isbn=978-0-123456-78-9&search=Search

Pencarian berdasarkan Pengarang:

https://get.biblio.id?resultXML=true&author=Smith&search=Search

Pencarian berdasarkan Kata Kunci:

https://get.biblio.id?resultXML=true&keywords=information+technology&search=Search

Ambil Detail berdasarkan ID:

https://get.biblio.id?p=show_detail&id=12345&inXML=1

Format Respons

Semua respons dalam format XML menggunakan skema MODS 3.3 (Metadata Object Description Schema).

Skema MODS: http://www.loc.gov/standards/mods/v3/mods-3-3.xsd

Respons Sukses (Pencarian):

<?xml version="1.0" encoding="UTF-8"?>
<modsCollection xmlns:xlink="http://www.w3.org/1999/xlink" 
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
                xmlns="http://www.loc.gov/mods/v3" 
                xmlns:slims="http://slims.web.id" 
                xsi:schemaLocation="http://www.loc.gov/mods/v3 http://www.loc.gov/standards/mods/v3/mods-3-3.xsd">
  <slims:resultInfo>
    <slims:modsResultNum>150</slims:modsResultNum>
    <slims:modsResultPage>1</slims:modsResultPage>
    <slims:modsResultShowed>20</slims:modsResultShowed>
  </slims:resultInfo>
  <mods version="3.3" id="12345">
    <!-- Data bibliografi dalam format MODS 3.3 -->
  </mods>
</modsCollection>

Respons Error:

<?xml version="1.0" encoding="UTF-8"?>
<error>
  <code>400</code>
  <message>Invalid API endpoint</message>
  <http_status>400</http_status>
</error>

Header Respons:

  • Content-Type: application/xml; charset=UTF-8
  • X-Rate-Limit-Remaining: 55 (permintaan tersisa)
  • X-Rate-Limit-Reset: 1738023456 (Unix timestamp kapan limit direset)

Pembatasan Akses

API menerapkan pembatasan akses untuk memastikan penggunaan yang adil:

  • Batas: 1000 permintaan per 1 jam per alamat IP
  • Jendela: 1 jam (3600 detik)
  • Pelacakan: Berdasarkan alamat IP klien (di-hash untuk privasi)

Ketika batas akses terlampaui, API mengembalikan respons error 429 (Too Many Requests) dengan informasi kapan batas akan direset.

Periksa header respons X-Rate-Limit-Remaining dan X-Rate-Limit-Reset untuk memantau penggunaan Anda.

Kode Error

Kode Deskripsi Penyebab
200 OK Permintaan berhasil
400 Bad Request Parameter tidak valid, field wajib tidak ada, atau permintaan tidak sesuai format
404 Not Found Catatan bibliografi dengan ID yang diminta tidak ditemukan
429 Too Many Requests Batas akses terlampaui (lebih dari 1000 permintaan per 1 jam)
500 Internal Server Error Terjadi kesalahan server saat memproses permintaan