{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Books & Play Books Catalog Explorer",
    "description": "Search Google Books and Play Books by keyword, author, subject, ISBN or volume ID, and pull Ngram time series. Returns bibliographic metadata, ISBNs, BISAC categories, covers, previews, ratings, Play Books prices and word-frequency trends.",
    "version": "1.0",
    "x-build-id": "RHIMj9apggQcHMtDi"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/xyrelith-data~google-books-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-xyrelith-data-google-books-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/xyrelith-data~google-books-scraper/runs": {
      "post": {
        "operationId": "runs-sync-xyrelith-data-google-books-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/xyrelith-data~google-books-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-xyrelith-data-google-books-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "byVolumeIds",
              "byIsbn",
              "byAuthor",
              "bySubject",
              "playStoreSearch",
              "ngrams"
            ],
            "type": "string",
            "description": "What to fetch. Each mode reads its own input block below.",
            "default": "search"
          },
          "searchQuery": {
            "title": "Search query",
            "type": "string",
            "description": "Keywords for mode=search or mode=playStoreSearch. Google Books operators work: `intitle:`, `inauthor:`, `inpublisher:`, `subject:`, `isbn:`, combinable with spaces/OR. Example: `intitle:dune inauthor:herbert`.",
            "default": "the lord of the rings"
          },
          "volumeIds": {
            "title": "Volume IDs or URLs (mode=byVolumeIds)",
            "type": "array",
            "description": "Google Books volume IDs (e.g. `zyTCAlFPjgYC`) or Books/Play URLs containing `id=`.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "isbns": {
            "title": "ISBNs (mode=byIsbn)",
            "type": "array",
            "description": "ISBN-10 or ISBN-13 values, with or without hyphens.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "authorNames": {
            "title": "Author names (mode=byAuthor)",
            "type": "array",
            "description": "Author names to search with Google Books' `inauthor:` operator, e.g. `Frank Herbert`.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "subjects": {
            "title": "Subjects / categories (mode=bySubject)",
            "type": "array",
            "description": "BISAC-style subject names to search with `subject:`, e.g. `Science Fiction`, `Business & Economics`, `Juvenile Fiction`.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "ngramPhrases": {
            "title": "Phrases (mode=ngrams)",
            "type": "array",
            "description": "Words or phrases to compare, e.g. `dune`, `artificial intelligence`, `climate change`.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "language": {
            "title": "Language (book modes)",
            "enum": [
              "any",
              "en",
              "es",
              "fr",
              "de",
              "it",
              "pt",
              "nl",
              "ru",
              "ja",
              "zh",
              "ko",
              "ar",
              "he",
              "hi",
              "tr",
              "pl",
              "sv",
              "da",
              "fi",
              "no",
              "el",
              "cs",
              "hu",
              "ro",
              "uk",
              "vi",
              "th",
              "id",
              "ms",
              "fa",
              "sw",
              "la",
              "ca",
              "hr",
              "sk",
              "sl",
              "sr",
              "bg",
              "lt",
              "lv",
              "et",
              "is",
              "ga",
              "cy",
              "af",
              "sq",
              "mk",
              "bs",
              "ka",
              "hy",
              "az",
              "kk",
              "uz",
              "bn",
              "ta",
              "te",
              "ml",
              "kn",
              "mr",
              "gu",
              "pa",
              "ur",
              "ne",
              "si",
              "km",
              "lo",
              "my",
              "mn",
              "bo",
              "eu",
              "gl",
              "mt",
              "lb",
              "eo"
            ],
            "type": "string",
            "description": "Keep books in one language. Applied to the fetched result window. Use `languageCode` for a code not listed.",
            "default": "any"
          },
          "languageCode": {
            "title": "Language code override (book modes)",
            "type": "string",
            "description": "Optional exact ISO 639-1/639-2 code (e.g. `eo`, `tl`). Takes precedence over the Language dropdown."
          },
          "viewability": {
            "title": "Viewability (book modes)",
            "enum": [
              "all",
              "full",
              "preview",
              "none"
            ],
            "type": "string",
            "description": "Filter by how much of the book Google shows: full view, preview or no preview.",
            "default": "all"
          },
          "printType": {
            "title": "Print type (book modes)",
            "enum": [
              "all",
              "books",
              "magazines"
            ],
            "type": "string",
            "description": "Restrict results to books or magazines.",
            "default": "all"
          },
          "freeEbooksOnly": {
            "title": "Free ebooks only (book modes)",
            "type": "boolean",
            "description": "Keep only open-access volumes (public-domain or free full-view books).",
            "default": false
          },
          "sortBy": {
            "title": "Sort order (book modes)",
            "enum": [
              "relevance",
              "newest"
            ],
            "type": "string",
            "description": "Relevance keeps Google's order. Newest sorts the fetched result window by publication date, newest first.",
            "default": "relevance"
          },
          "ngramYearStart": {
            "title": "Start year (mode=ngrams)",
            "minimum": 1800,
            "maximum": 2022,
            "type": "integer",
            "description": "First year of the Ngram time series (1800–2022).",
            "default": 1800
          },
          "ngramYearEnd": {
            "title": "End year (mode=ngrams)",
            "minimum": 1800,
            "maximum": 2022,
            "type": "integer",
            "description": "Last year of the Ngram time series (1800–2022). Must be at least the start year.",
            "default": 2019
          },
          "ngramCorpus": {
            "title": "Corpus (mode=ngrams)",
            "enum": [
              "en",
              "en-US",
              "en-GB",
              "en-fiction",
              "fr",
              "de",
              "es",
              "it",
              "ru",
              "he",
              "zh"
            ],
            "type": "string",
            "description": "Google Books Ngram corpus to query.",
            "default": "en"
          },
          "ngramSmoothing": {
            "title": "Smoothing (mode=ngrams)",
            "minimum": 0,
            "maximum": 50,
            "type": "integer",
            "description": "Smoothing window, 0 (none) to 50. Google's default is 3.",
            "default": 3
          },
          "ngramCaseInsensitive": {
            "title": "Group case variants (mode=ngrams)",
            "type": "boolean",
            "description": "When on, emit a case-insensitive aggregate plus one row per case variant.",
            "default": true
          },
          "includeFullDetails": {
            "title": "Fetch full volume details",
            "type": "boolean",
            "description": "Book modes only. Fetch each volume's detail feed for the full description and finer BISAC categories. One extra small request per record; off in the daily prefill.",
            "default": true
          },
          "includePlayStoreDetails": {
            "title": "Fetch Play Books price & rating",
            "type": "boolean",
            "description": "Book modes only. Check each volume's Play Books page and add price, currency, rating and the verified Play URL when an ebook edition exists. No fields are added for print-only volumes.",
            "default": true
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Hard cap on emitted records. Book searches stop at Google's 600-result window; Play Books search returns at most 20.",
            "default": 50
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}