{
  "openapi": "3.0.1",
  "info": {
    "title": "Barnes and Noble Scraper | Book Prices and Availability",
    "description": "Barnes & Noble scraper for book prices by ISBN: 10 ISBNs in, 10 rows in 2 seconds, 47 fields each. Get price, list price, discount, stock, shipping time, every other format with its price, author, publisher, series, pages, BISAC categories, rating and reviews. Search by title or paste links too.",
    "version": "1.0",
    "x-build-id": "MzPIC6C4eTSMxse9Q"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~barnesandnoble-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-barnesandnoble-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/silentflow~barnesandnoble-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-barnesandnoble-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/silentflow~barnesandnoble-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-barnesandnoble-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",
        "properties": {
          "isbnIds": {
            "title": "📚 ISBNs",
            "type": "array",
            "description": "Editions to read, one per line: ISBN-13 (<code>9780735211292</code>), ISBN-10 (<code>0735211299</code>), with or without hyphens, or the EAN of an ebook, audiobook, toy or game. Each ISBN returns its row whatever the limit below, so a list of 500 ISBNs returns 500 rows. ISBNs Barnes & Noble does not sell are listed at the end of the log.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "🔗 Barnes & Noble links",
            "type": "array",
            "description": "Paste links copied from barnesandnoble.com:<ul><li>a product page with its format, <code>https://www.barnesandnoble.com/w/project-hail-mary-andy-weir/1137456421?ean=9780593135204</code>, for that edition</li><li>a product page without <code>?ean=</code>, for every edition of the title (hardcover, paperback, ebook, audiobook...)</li><li>a search page, <code>https://www.barnesandnoble.com/search?q=brandon%20sanderson</code>, read like a search below</li></ul>",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "searchQueries": {
            "title": "🔎 Search by title, author or series",
            "type": "array",
            "description": "Words to search the Barnes & Noble catalog with, like on the site: <code>colleen hoover</code>, <code>stormlight archive</code>, <code>cozy mystery</code>. Each search returns its best matches first, up to the limit below.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "🔢 Max editions per search or link",
            "minimum": 1,
            "type": "integer",
            "description": "The most editions returned for each search, each title link and each ISBN with <b>other formats as rows</b> on. Never cuts your ISBN list: every ISBN always returns its own row.",
            "default": 50
          },
          "formats": {
            "title": "📖 Formats",
            "type": "array",
            "description": "Keep only these formats in searches, title links and other formats. Leave empty to keep every format. The ISBNs you list are always returned.",
            "items": {
              "type": "string",
              "enum": [
                "hardcover",
                "paperback",
                "ebook",
                "audiobook",
                "largePrint",
                "boardBook",
                "special"
              ],
              "enumTitles": [
                "Hardcover",
                "Paperback",
                "eBook (NOOK)",
                "Audiobook (digital and CD)",
                "Large Print",
                "Board Book",
                "Special, signed and B&N exclusive editions"
              ]
            }
          },
          "onlyInStock": {
            "title": "✅ In stock only",
            "type": "boolean",
            "description": "Keep only editions you can order today (in stock or open for pre-order) in searches, title links and other formats. The ISBNs you list are always returned, with their stock status.",
            "default": false
          },
          "includeAllFormats": {
            "title": "📚 Other formats as rows",
            "type": "boolean",
            "description": "Also return every other edition of each ISBN's title as its own row (the hardcover, paperback, ebook and audiobook of the same book), up to the limit above per ISBN. Off: each row still lists the other formats with their prices in <code>otherFormats</code>.",
            "default": false
          },
          "includeDescription": {
            "title": "📝 Include description",
            "type": "boolean",
            "description": "Add the publisher's description of the book to each row. Turn off for lighter rows when you only track prices and stock.",
            "default": true
          },
          "debugMode": {
            "title": "🐞 Debug mode",
            "type": "boolean",
            "description": "Write detailed progress to the log.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}