ISBN Book Metadata Lookup

ISBN Book Metadata Lookup
Search book metadata by ISBN or title keywords. Retrieve title, author, publisher, cover image, and basic publishing details in one request.

Method: GET
Path: /v1/text/isbn
Demo: https://api.gugudata.io/v1/text/isbn/demo
OpenAPI: https://gugudata.io/assets/openapi/gugudata.openapi.3.1.json

Request Parameters:

appkey (string, required): Application key used for request authentication. Supply the value as a query parameter, form field, or multipart field according to the request content type.

isbn (string, optional): ISBN number for an exact book lookup

keywords (string, optional): Keyword used for fuzzy matching against the searchable text fields supported by this endpoint.

pageIndex (integer, optional): One-based page index for pagination.

pageSize (integer, optional): Number of records returned per page.

Response Fields:

Title (string, optional): Book title

Author (string, optional): Author name

ISBN (string, optional): ISBN number of the book

Publisher (string, optional): Publisher name

PublisherDateTime (string, optional): Publication date or year

PageNumber (integer, optional): Number of pages

Binding (string, optional): Binding type

BriefIntroduction (string, optional): Short introduction or summary

CoverImage (string, optional): Book cover image URL

HTTP Status Codes:

200: Request processed successfully. Some endpoints expose a separate application-level status field in the response body, such as dataStatus.statusCode.

400: Invalid request parameters or request format. Check required fields, data types, and request body format.

401: Missing or unknown application key. Provide a valid appkey with the request.

403: The application key is recognized but access is not allowed. The key may be expired, inactive, or not permitted for the requested API.

429: Request rate or trial usage limit exceeded. Reduce concurrency or retry after the limit window resets.

500: Internal service error. Retry later or contact support if the error persists.

503: Upstream service unavailable. Retry later; the requested upstream dependency is temporarily unavailable.

Business Status Codes:

200 Normal return: Book metadata successfully returned

400 Parameter error: Please provide either isbn or keywords

429 Request frequency limited: Cannot exceed 100 requests per second

403 Account in arrears: Payment required to continue using the service

402 APPKEY error: Please check whether the APPKEY passed is obtained from the developer center

500 API response error: Internal server error during ISBN lookup

Key Features:

Search books by ISBN for direct metadata lookup.

Support keyword-based title search when ISBN is unavailable.

Return book title, author, publisher, cover image, and page count.

Useful for bookstore apps, cataloging, publishing workflows, and content enrichment.

Support fast integration for business tools and public product experiences.

Details:
https://gugudata.io/details/isbn

Request

Request Code Samples

Responses