# Search or browse books on Google Play Returns the Google Play books that match a search, in the store's sections. Without a query, it returns the store's front page of books. Tool `google-play.search.books` on Google Play. Contract version 1, released 2026-10-27. ## Example call Over REST, send the input in the body. Over MCP, pass the same input to `call_tool`. cURL: ```bash curl https://api.voxoria.ai/v1/tools/google-play.search.books/calls \ -H "Authorization: Bearer $VOXORIA_API_KEY" \ -H "Content-Type: application/json" \ -d '{"input":{"query":"dune"}}' ``` Python: ```python import os import httpx response = httpx.post( "https://api.voxoria.ai/v1/tools/google-play.search.books/calls", headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"}, json={"input": {"query": "dune"}}, timeout=60, ) print(response.json()) ``` TypeScript: ```ts const response = await fetch("https://api.voxoria.ai/v1/tools/google-play.search.books/calls", { method: "POST", headers: { Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({"input": {"query": "dune"}}), }); console.log(await response.json()); ``` MCP (`tools/call` params): ```json { "name": "call_tool", "arguments": { "tool": "google-play.search.books", "input": { "query": "dune" } } } ``` Both return [the full response](/docs/call-response.md): the call's ID, status and cost, with this tool's result in `output`. ## Input | Input | Type | Required | Default | Description | | --- | --- | --- | --- | --- | | `query` | string | No | | What to search for. Left out, the store's front page of books is returned, in sections. 1 to 2048 characters. | | `country` | string | No | `us` | Two-letter ISO 3166-1 country code of the storefront. Case-insensitive. One of the 249 values of the `countries` list: ISO 3166-1 alpha-2 country codes, lowercase. | | `language` | string | No | `en` | Two-letter ISO 639-1 language code of the storefront. Case-insensitive. One of the 184 values of the `languages` list: ISO 639-1 two-letter language codes, lowercase. | | `next_page_token` | string | No | | Fetches the next page. Take it from pagination.next_page_token of the previous page, and send the same query, country and language. Not with section_page_token. | | `section_page_token` | string | No | | Loads more of one section. Take it from that section's next_page_token, and send the same query, country and language. Not with next_page_token. | ## Output A successful call returns these blocks in its `output`. A field not marked required can be `null`. ### sections A list of rows. Always present, possibly empty. The results, in the sections the store groups them in, in order. | Field | Type | Required | Description | | --- | --- | --- | --- | | `title` | string | No | The section's heading, such as "Ebooks". Null for the main section, which has none. | | `next_page_token` | string | No | Send as section_page_token to load more of this section, with the same query, country and language. Null when the section has no more. | | `results` | array of object | Yes | | | `results.product_id` | string | Yes | Google Play's ID of the book. Send as product_id to google-play.product or google-play.reviews. | | `results.title` | string | Yes | | | `results.url` | string | No | Address of the book's page on Google Play. | | `results.description` | string | No | | | `results.image_url` | string | No | Address of the book's cover. | | `results.author_name` | string | No | Name of the book's author. | | `results.rating` | number | No | Average rating, out of 5. | | `results.category` | string | No | The book's category, as the store names it, such as "Science fiction". | | `results.format` | string | No | Kind of book as the store shows it, such as "Ebook series". | | `results.content_rating` | string | No | Age rating as the store shows it, such as "Mature". | | `results.price` | string | No | The price as the store shows it, with its currency symbol, such as "$4.99". Not parsed. | | `results.price_amount` | number | No | The price as a number, in currency. 0 for a free book. | | `results.currency` | string | No | Three-letter ISO 4217 currency code of price_amount. | ### pagination One object. Can be `null`. How to fetch the next page. Null on the last page. | Field | Type | Required | Description | | --- | --- | --- | --- | | `next_page_token` | string | Yes | Send as next_page_token to fetch the next page. | ## Example output The `output` of a real call, each list cut to 3 items. ```json { "sections": [ { "title": "Series", "next_page_token": null, "results": [ { "product_id": "av3XFwAAABC86M", "title": "Dune", "url": "https://play.google.com/store/books/series?id=av3XFwAAABC86M", "description": null, "image_url": "https://play-lh.googleusercontent.com/DO9D9mcmQJ8OXHXGOFyfQWRKgzoTlKbw1Epd4kHRZmPP1G8v7vzCHT8XZGL6j4JfP3o4kmvXeK-ohgdt4-E", "author_name": null, "rating": null, "category": null, "format": "Ebook series", "content_rating": null, "price": null, "price_amount": null, "currency": null }, { "product_id": "mPnXFwAAABBO7M", "title": "Dune", "url": "https://play.google.com/store/books/series?id=mPnXFwAAABBO7M", "description": null, "image_url": "https://play-lh.googleusercontent.com/ofs4XPMudPYM7c9pYmYLmk5vJMUtxwEV-NOaNwylrTdnf8W3mwfSavwzYDoE3iucMR65dQsOB6fAvyeJIYA", "author_name": null, "rating": null, "category": null, "format": "Ebook series", "content_rating": null, "price": null, "price_amount": null, "currency": null }, { "product_id": "itdSGQAAABDZzM", "title": "Prelude to Dune", "url": "https://play.google.com/store/books/series?id=itdSGQAAABDZzM", "description": null, "image_url": "https://play-lh.googleusercontent.com/MFUDpAp2WsDf3rk3bl35SEMx2qOEuZte3t0Uq4WalsSVR6M_qmbNDnAuPiqjmmFS7CPG7VrFWvgGEbzSPg", "author_name": null, "rating": null, "category": null, "format": "Ebook series", "content_rating": null, "price": null, "price_amount": null, "currency": null } ] }, { "title": "Ebooks", "next_page_token": "pt1.bGl0ZXNjcmFwZTpleUoySWpveExDSnZjR1Z5WVhScGIyNGlPaUppYjI5cmN5SXNJbU52Ym5SbGVIUWlPbnNpYUd3aU9pSmxiaUlzSW1kc0lqb2lkWE1pTENKeElqb2laSFZ1WlNKOUxDSnJhVzVrSWpvaWMyVmpkR2x2YmlJc0luUnZhMlZ1SWpvaVNVRkdhWEpuUmt0UWQyODVRMEpSVVhWMU5rVnFRVzlSYVhWUWNUbDNNRkZmVFdsYWEyZHpVVFIwTjNGemQxVlJOMUJJU0RoUlRWRnVaR0V6Ym5kUlVUWmxZa280WjNOUmVrNDNZUzFuWjFGNlNXSklSWGhFZDIwNFIwSkRiRUZWWVdsM2VHRnRlSEJpYld4c1dWWkdRMU50WkdwWmVrNVhaVmhLYlZSSGVGRlBWMXBNVjFSR2FsTldhRFZXTTFaWVpGUmtVMUpIY0VSak1uaEtVR1J2VEU1M2IwVmFTRloxV2xKQlJrZEJSV2xJVTI5aVdXMDVkbUV6VG1aak1sWjVZVmRXZWxnelRteFpXRXBxWVVSMGJHTkhiSHBpTWxKc1MyZEJkMEZFWjBKUloxcEdXVzA1ZG1FelQzZEZaMEVpZlE", "results": [ { "product_id": "A2jEEQAAQBAJ", "title": "Dune Messiah Book 1", "url": "https://play.google.com/store/books/details/Frank_Herbert_Dune_Messiah_Book_1?id=A2jEEQAAQBAJ", "description": "A visually stunning graphic novel adaptation of Frank Herbert’s Dune Messiah , this volume brings one of science fiction’s most pivotal stories to life in a bold, immersive new format. Adapted by Brian Herbert and Kevin J. Anderson and illustrated by Michael Shelfer, Dune Messiah: Book 1 transforms the iconic sequel into a cinematic graphic experience. Rich, detailed artwork captures the scale of Arrakis and the complexity of its characters, while the visual format sharpens the story’s core tensions—power, religion, and destiny—with new immediacy. Paul Atreides is now Emperor of the known universe—but absolute power has made him both a ruler and a target. Revered as a messianic figure by the Fremen and feared by rival houses, Paul must confront a growing conspiracy that threatens to unravel his reign. As political enemies close in and his prophetic visions begin to shift, the future of his empire—and the people he loves—hangs in the balance. Perfect for fans of the Dune films, longtime readers of the novels, and newcomers alike, this adaptation offers a unique view of the saga’s darker second act. Whether you’re returning to Paul Atreides’s story or encountering it for the first time, this edition delivers a compelling, visually driven way to experience a landmark work of science fiction. The first installment of a two-part adaptation, Dune Messiah: Book 1 is an essential addition to any graphic novel or science fiction collection—and a powerful new way to experience the world of Arrakis. Like the bestselling volumes in the first series of Dune graphic novel adaptations, Dune Messiah features a spectacular painted cover by artist Bill Sienkiewicz.", "image_url": "https://play.google.com/books/publisher/content/images/frontcover/A2jEEQAAQBAJ?fife", "author_name": "Frank Herbert", "rating": null, "category": "Fiction & literature", "format": null, "content_rating": null, "price": "$23.39", "price_amount": 23.39, "currency": "USD" }, { "product_id": "p1MULH7JsTQC", "title": "Dune: Volume 1", "url": "https://play.google.com/store/books/details/Frank_Herbert_Dune?id=p1MULH7JsTQC", "description": "Frank Herbert’s classic masterpiece—a triumph of the imagination and one of the bestselling science fiction novels of all time. Set on the desert planet Arrakis, Dune is the story of Paul Atreides—who would become known as Muad'Dib—and of a great family's ambition to bring to fruition mankind's most ancient and unattainable dream. A stunning blend of adventure and mysticism, environmentalism and politics, Dune won the first Nebula Award, shared the Hugo Award, and formed the basis of what is undoubtedly the grandest epic in science fiction.", "image_url": "https://play.google.com/books/content/images/frontcover/p1MULH7JsTQC?fife", "author_name": "Frank Herbert", "rating": null, "category": "Science fiction", "format": null, "content_rating": null, "price": "$9.99", "price_amount": 9.99, "currency": "USD" }, { "product_id": "AXVUqdzi3rsC", "title": "Dune Messiah", "url": "https://play.google.com/store/books/details/Frank_Herbert_Dune_Messiah?id=AXVUqdzi3rsC", "description": "COMING SOON • DUNE: PART THREE • THE MAJOR MOTION PICTURE Directed by Denis Villeneuve, screenplay by Denis Villeneuve and Brian K. Vaughan, based on the novels written by Frank Herbert • Starring Timothée Chalamet, Zendaya, Jason Momoa, Florence Pugh, Rebecca Ferguson, Isaach De Bankolé, with Charlotte Rampling, with Anya Taylor-Joy, and Robert Pattinson, and Javier Bardem Book Two in the Magnificent Dune Chronicles—the Bestselling Science Fiction Adventure of All Time Dune Messiah continues the story of Paul Atreides, better known—and feared—as the man christened Muad’Dib. As Emperor of the known universe, he possesses more power than a single man was ever meant to wield. Worshipped as a religious icon by the fanatical Fremen, Paul faces the enmity of the political houses he displaced when he assumed the throne—and a conspiracy conducted within his own sphere of influence. And even as House Atreides begins to crumble around him from the machinations of his enemies, the true threat to Paul comes to his lover, Chani, and the unborn heir to his family’s dynasty...", "image_url": "https://play.google.com/books/content/images/frontcover/AXVUqdzi3rsC?fife", "author_name": "Frank Herbert", "rating": null, "category": "Science fiction", "format": null, "content_rating": null, "price": "$9.99", "price_amount": 9.99, "currency": "USD" } ] }, { "title": "Audiobooks", "next_page_token": "pt1.bGl0ZXNjcmFwZTpleUoySWpveExDSnZjR1Z5WVhScGIyNGlPaUppYjI5cmN5SXNJbU52Ym5SbGVIUWlPbnNpYUd3aU9pSmxiaUlzSW1kc0lqb2lkWE1pTENKeElqb2laSFZ1WlNKOUxDSnJhVzVrSWpvaWMyVmpkR2x2YmlJc0luUnZhMlZ1SWpvaVNVRkthV3hCUmt0UVoyODRRMEpSVVRRdE0wSnJaMnRSYWpsbU9XMUJNRkUwYjFCMU9WRm5VV2MxUkdnelFUQlJjWE41YXpCUmMxRnhORWQxZUhkWlVYRk5lbEZPUWtOSmVUUjVaMEY0UXpkNVgwWXdSVkJEYjJ0S1dVWlZRbEp4VEVka1ZFOVZUWHBUUjNoRVZWaENNMVZ1YkdGaFdFSlRUREJaTTFWdVpIVmliVlo0Vkdwc2VWRlZVVEpTUlZaSFZEQjBiMVpIYUhoamJVMDVNbWR6WlVOblVtdGtWelZzUlVWQldVRlRTVUZMWjBGM1FVUm5RbEZuY0VKa1YxSndZakpLZG1JeWRIcHpRa2xCSW4w", "results": [ { "product_id": "AQAAAADXxRDF1M", "title": "Dune: Book One in the Dune Chronicles", "url": "https://play.google.com/store/audiobooks/details/Frank_Herbert_Dune?id=AQAAAADXxRDF1M", "description": "NOW A MAJOR MOTION PICTURE directed by Denis Villeneuve, starring Timothée Chalamet, Zendaya, Rebecca Ferguson, Javier Bardem, Josh Brolin, Austin Butler, Florence Pugh, Dave Bautista, Christopher Walken, Léa Seydoux, Stellan Skarsgård, and Charlotte Rampling Set on the desert planet Arrakis, Dune is the story of the boy Paul Atreides, who would become the mysterious man known as Muad'dib. He would avenge the traitorous plot against his noble family—and would bring to fruition humankind's most ancient and unattainable dream. A stunning blend of adventure and mysticism, environmentalism and politics, Dune won the first Nebula Award, shared the Hugo Award, and formed the basis of what is undoubtedly the grandest epic in science fiction. Frank Herbert's death in 1986 was a tragic loss, yet the astounding legacy of his visionary fiction will live forever. Long-listed, Audible.com Best of the Year, 2007 Long-listed, Audible.com 100 Audible Essentials, 2007 Audie Award winner, 2008", "image_url": "https://play-lh.googleusercontent.com/kWg4VY6eYgnIZZixpJx6GvQB40rmlHGy0BGzZu_GVlMO9ibl9CFtjgLJj9OoKb-bh1EHeUhuP2dhFg", "author_name": "Frank Herbert", "rating": null, "category": "Science fiction & fantasy", "format": null, "content_rating": null, "price": "$34.61", "price_amount": 34.61, "currency": "USD" }, { "product_id": "AQAAAIC4WE3Y5M", "title": "Dune Messiah: Book Two in the Dune Chronicles", "url": "https://play.google.com/store/audiobooks/details/Frank_Herbert_Dune_Messiah?id=AQAAAIC4WE3Y5M", "description": "The bestselling science fiction series of all time continues! Frank Herbert's second installment explores new developments on the desert planet Arrakis, with its intricate social order and its strange threatening environment. Dune Messiah picks up the story of the man known as Maud'dib, heir to a power unimaginable, bringing to fruition an ambition of unparalleled scale: the centuries-old scheme to create a superbeing who reigns not in the heavens but among men. But the question is: Do all paths of glory lead to the grave?", "image_url": "https://play-lh.googleusercontent.com/kbywxxDnxtY9M1QyDQmd8NHJfKCf0Jn0diPKkSMvQtzDuKLa9oiyJHI724Yp0OH6xcygR_sxCZSUgQ", "author_name": "Frank Herbert", "rating": null, "category": "Science fiction & fantasy", "format": null, "content_rating": null, "price": "$16.95", "price_amount": 16.95, "currency": "USD" }, { "product_id": "AQAAAICAERGRgM", "title": "Children of Dune: Book Three in the Dune Chronicles", "url": "https://play.google.com/store/audiobooks/details/Frank_Herbert_Children_of_Dune?id=AQAAAICAERGRgM", "description": "Frank Herbert's bestselling science fiction series of all time continues! In this third installment, the sand-blasted world of Arrakis has become green, watered and fertile. Old Paul Atreides, who led the desert Fremen to political and religious domination of the galaxy, is gone. But for the children of Dune, the very blossoming of their land contains the seeds of its own destruction. The altered climate is destroying the giant sandworms, and this in turn is disastrous for the planet's economy. Leto and Ghanima, Paul Atreides's twin children and his heirs, can see possible solutions—but fanatics begin to challenge the rule of the all-powerful Atreides empire, and more than economic disaster threatens...", "image_url": "https://play-lh.googleusercontent.com/zxxORgek5rhIKYNw2IalhQh4hdHVLGzLcnBTqJAPckpkYh93dP6ooxmRZCcL8uMOWBos3UjHAKsLFw", "author_name": "Frank Herbert", "rating": null, "category": "Science fiction & fantasy", "format": null, "content_rating": null, "price": "$27.95", "price_amount": 27.95, "currency": "USD" } ] } ], "pagination": null } ```