{"uid":"cap_fwVAoxzd9myM51lgGuLQ4","slug":"agents-openwebninja-com-search-books-via-openweb-ninja-9e9a3241","name":"Search Books via OpenWeb Ninja","description":"Get real-time book search results from across the web with pagination and filtering support.","url":"https://agents.openwebninja.com/realtime-books-data/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["query"],"properties":{"page":{"type":"number","default":1,"description":"Results page to return (pagination / scrolling)."},"query":{"type":"string","example":"good thriller","description":"Search query / keyword"},"country":{"type":"string","default":"us","description":"The country for which to get trends, specified as a 2-letter country code - see ISO 3166."},"language":{"type":"string","default":"en","description":"The language to use for the results, specified as a 2-letter language code (https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)."},"view_type":{"enum":["any","preview_and_full_view","full_view"],"type":"string","default":"any","description":"Find books with a specific view type (preview / full)."},"document_type":{"enum":["any","books","newspapers","magazines"],"type":"string","default":"any","description":"Find books of a specific type."},"publication_year_to":{"type":"number","description":"Find books published before a specific year (e.g. 2013)."},"publication_year_from":{"type":"number","description":"Find books published after a specific year (e.g. 1980)."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["id","title","position","rank"],"properties":{"id":{"type":"string","description":"Google Books volume ID for the book."},"rank":{"type":"integer","description":"Absolute rank across all pages returned (1-based)."},"title":{"type":"string","description":"Title of the book."},"position":{"type":"integer","description":"Position of the result within the page (1-based)."},"subtitle":{"type":"string","nullable":true,"description":"Subtitle line shown by Google Books (typically authors and publication year)."},"view_url":{"type":"string","nullable":true,"description":"URL of the Google Books page for the book."},"image_url":{"type":"string","nullable":true,"description":"Cover image URL for the book."},"view_label":{"type":"string","nullable":true,"description":"Label of the view available for the book (e.g. Preview, Full view). Omitted when no preview is available."},"book_authors":{"type":"array","items":{"type":"object","required":["name"],"properties":{"url":{"type":"string","nullable":true,"description":"Google Books search URL filtering by this author."},"name":{"type":"string","description":"Author full name."}}},"nullable":true,"description":"Authors of the book."},"publication_year":{"type":"integer","nullable":true,"description":"Year of publication."},"book_more_editions_url":{"type":"string","nullable":true,"description":"URL to view other editions of the book on Google Books."}}},"description":"Array of book search results returned by the API."},"status":{"type":"string","description":"The status of the API response"},"parameters":{"type":"object","properties":{"query":{"type":"string","description":"The search query parameter"},"country":{"type":"string","description":"Country code for localization"},"language":{"type":"string","description":"Language code for localization"},"view_type":{"type":"string","description":"Type of view requested"},"document_type":{"type":"string","description":"Type of document requested"}}},"request_id":{"type":"string","description":"Unique identifier for the API request"}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm__uPWpigiq9hJaaX5Ooqnl","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Search for books in real-time across Google Books with filtering by type, view availability, publication year, language, and country.","exampleAgentPrompt":"Search Google Books for good thriller novels published between 2010 and 2020 that have a preview available, and show me the first page of results in English for the US.","exampleUseCases":[{"title":"Research books on a niche topic","prompt":"Find me books about machine learning published after 2018 — only ones with a full view available so I can read them online. Show results in English for the US."},{"title":"Discover classic literature for a reading list","prompt":"Search for Charles Dickens novels on Google Books, filter to books only (not magazines or newspapers), published before 1900, and give me the first page of results."},{"title":"Multilingual book discovery","prompt":"I'm looking for Spanish-language mystery books published between 2000 and 2015 — search Google Books with country set to Spain (es) and language set to Spanish (es), any view type is fine."}],"resultDescription":"Returns an array of book records, each including a Google Books volume ID, title, subtitle (often showing authors and year), rank and position, publication year, cover image URL, Google Books page URL, view label (Preview/Full view), author names with links, and a link to other editions. Also returns the echoed request parameters and status.","failureModes":["Missing required 'query' parameter returns a validation error","Invalid country or language code may return no results or default behavior","Requesting a page beyond available results returns an empty data array","Rate limiting or quota exhaustion returns a 402 or 429 error","Very broad queries may return irrelevant results due to Google Books index coverage"],"whenToPreferThis":"Use this endpoint when you need real-time book search results from Google Books with rich filtering options (document type, view type, publication year, language, country). Prefer this over static book databases when you need current availability of previews or full-view books, or when localizing results by country and language is important.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:35:06.844Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-search-books-via-openweb-ninja-9e9a3241"}