viernes, agosto 29, 2008

ISBNdb y su API pública para consulta de metadatos de libros

.
ISBNbd es una base de datos pública que almacena információn de más de 3.7 millones de libros. Es un recurso bastante útil para bibliotecarios, bibliotecas públicas, negocios de venta de libros, etc. Dado que posee un interfase de consulta manual y, alternativamente, una API (que devuelve las respuestas en formato XML) por la cual se pueden automatizar los procesos de recuperación de información.

Las estadísticas actuales del servicio son:

* Statistics (08/28/2008):
- Books: 3,712,956
- Subjects: 1,527,684
- Authors: 1,113,575
- Publishers: 269,164
- Sources: 8,374,740


Hay que registrarse para usar la API, luego de obtener su ID puede buscar información por palabras clave, por número ISBN, autores o editores, entre otros. La información se almacena sobre una base de datos relacional, lo cual permite naegar de forma fácil sobre los datos, a partir de obtener las claves o referencias a distintas tablas de entidades. La base de datos contiene las siguientes colecciones: Books (metadatos de libros), Subjects (tematica relaciona con los libros), Categories (categorías de libros), Authors (autores) y Publishers (editores).


Ejemplos de uso de la API - "SECCION BOOKS"

- Recuperar los metadatos del libro cuyo ISBN sea 0201563320

http://isbndb.com/api/books.xml?access_key=Z&index1=isbn&value1=0201563320

Respuesta:

<ISBNdb server_time="2008-08-28T22:59:19Z">
<BookList total_results="1" page_size="10" page_number="1" shown_results="1">
<BookData book_id="interconnections_a02" isbn="0201563320">
<Title>Interconnections</Title>
<TitleLong>Interconnections: bridges and routers</TitleLong>
<AuthorsText>Radia Perlman</AuthorsText>
<PublisherText publisher_id="addison_wesley_pub_co">Reading, Mass. :
Addison-Wesley Pub. Co., c1992.</PublisherText>
</BookData>
</BookList>
</ISBNdb>

- Búsqueda en atributo título

Buscar aquellas obras en cuyo título contenga la cadena "la rosa"

http://isbndb.com/api/books.xml?access_key=Z&index1=title&value1=la+rosa

Respuesta:

<ISBNdb server_time="2008-08-28T23:02:46Z">
<BookList total_results="52" page_size="10" page_number="1" shown_results="10">
<BookData book_id="apostillas_a_el_nombre_de_la_rosa" isbn="9505150202">
<Title>Apostillas a El Nombre de La Rosa</Title>
<TitleLong/>
<AuthorsText>Umberto Eco, </AuthorsText>
<PublisherText publisher_id="de_la_flor">de la Flor</PublisherText>
</BookData>
<BookData book_id="asterix_la_rosa_y_la_espada" isbn="0785910387">
<Title>Asterix: La rosa y la Espada</Title>
....


- Búsqueda en registro completo

Buscar aquellas obras en cuyos atributos (título, autor, resumen, editor, etc) aparezca el término "farm".

http://isbndb.com/api/books.xml?access_key=Z&index1=full&value1=farm

Respuesta:

ISBNdb server_time="2008-08-28T23:17:46Z">
<BookList total_results="9909" page_size="10" page_number="1" shown_results="10">
<BookData book_id="1001_things_to_spot_on_the_farm" isbn="0746029551">
<Title>1001 Things to Spot on the Farm</Title>
<TitleLong>1001 Things to Spot on the Farm (Usborne 1001 Things to Spot)</TitleLong>
<AuthorsText>Gillian Doherty, Teri Gower, </AuthorsText>
<PublisherText publisher_id="educational_development_corpor">Educational Development Corporation</PublisherText>
</BookData>
<BookData book_id="100_banned_books" isbn="0816040591">
<Title>100 banned books</Title>
..


- Buscar aquellas obras en cuyo campo autor o editor título contenga la cadena "umberto_eco ".

El ID del individuo se obtiene previamente utilzando la coleccion "persons".

http://isbndb.com/api/books.xml?access_key=Z&index1=person_id&value1=borges_jorge_luis

Respuesta:

<ISBNdb server_time="2008-08-28T23:25:22Z">
<BookList total_results="231" page_size="10" page_number="1" shown_results="10">
<BookData book_id="antologia_de_la_literatura_fantastica" isbn="950071602X">
<Title>Antología de la literatura fantástica</Title>
<TitleLong/>
<AuthorsText> Jorge Luis Borges, Adolfo Bioy Casares, Silvina Ocampo, </AuthorsText>
<PublisherText publisher_id="sudamericana">Sudamericana</PublisherText>
</BookData>
<BookData book_id="antologia_de_la_literatura_fantastica_a01" isbn="8435015459">
<Title>Antologia De LA Literatura Fantastica</Title>
...

Las consultas aceptan opcionalmente un parámetro de paginación, dado que por respuesta solo se ofrecen 10 resultados. El siguiente ejemplo traería la página siguiente de la consulta anterior

http://isbndb.com/api/books.xml?access_key=Z&page_number=2&index1=person_id&value1=borges_jorge_luis


- Buscar aquellas obras cuyo editor sea "O´Reilly"

El ID se obtiene utilzando previamente la coleccion "persons".

http://isbndb.com/api/books.xml?access_key=Z&index1=publisher_id&value1=oreilly

Respuesta:

<ISBNdb server_time="2008-08-29T14:31:35Z">
<BookList total_results="1099" page_size="10" page_number="1" shown_results="10">
<BookData book_id="the_x_window_system_in_a_nutshell" isbn="1565920171">
<Title>The X Window System in a nutshell</Title>
<TitleLong/>
<AuthorsText> edited by Ellie Cutler, Daniel Gilly, and Tim O'Reilly </AuthorsText>
<PublisherText publisher_id="oreilly">Sebastopol, CA : O'Reilly, <c1992 ></PublisherText>
</BookData>
<BookData book_id="virtual_private_networks" isbn="1565923197">
<Title>Virtual private networks</Title>
...


- Buscar aquellas obras que tengan asociado el tema (subject) "local_area_network".

El ID se obtiene utilzando previamente la coleccion "subjects".

http://isbndb.com/api/books.xml?access_key=Z&index1=subject_id&value1=local_area_network

Respuesta:

<ISBNdb server_time="2008-08-29T14:34:47Z">
<BookList total_results="10" page_size="10" page_number="1" shown_results="10">
<BookData book_id="ethernet" isbn="0201624052">
<Title>Ethernet</Title>
<TitleLong>Ethernet: building a communications infrastructure</TitleLong>
<AuthorsText>Heinz-Gerd Hegering, Alfred Läpple; translated by Stephen S. Wilson</AuthorsText>
<PublisherText publisher_id="addison_wesley">Wokingham, England ; Addison-Wesley, c1993.</PublisherText>
</BookData>
<BookData book_id="internetworking" isbn="0201565366">
<Title>Internetworking</Title>
<TitleLong>Internetworking: designing the right architecures</TitleLong>
...


-Buscar aquellas obras que tengan asociado el número de Clasificación Dewey (DDC - Dewey Decimal Classification) "698.3".

http://isbndb.com/api/books.xml?access_key=Z&index1=dewey_decimal&value1=302.2/3

Respuesta:

<ISBNdb server_time="2008-08-29T14:39:10Z">
<BookList total_results="8" page_size="10" page_number="1" shown_results="8">
<BookData book_id="complete_book_of_wood_finishing_a01" isbn="0571046509">
<Title>Complete book of wood finishing</Title>
<TitleLong/>
<AuthorsText>edited by F. J. Christopher</AuthorsText>
<PublisherText publisher_id="faber">London, Faber, 1968.</PublisherText>
</BookData>
<BookData book_id="the_building_regulations_1991_a01" isbn="0117524476">
<Title>The Building Regulations 1991</Title>
<TitleLong/>
...

1 comentario:

Alfonso Abascal dijo...

Más que útil, gracias por estos ejemplos, con el manual oficial de isbndb.com a lo mejor me hubiese dado la nochebuena del 2055 por la tarde.

Un saludo y que no decaiga el ánimo.