{ "openapi": "3.0.1", "info": { "title": "Barnes & Noble Books Scraper", "description": "Scrape Barnes & Noble books: covers, authors, ISBN-13 and ISBN-10, formats, publishers, list and current prices, ratings and subjects. Export to CSV, Excel, JSON or XML.", "version": "0.1", "x-build-id": "HX5wIo6K1yjWLq2Yp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~barnes-noble-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-barnes-noble-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/parseforge~barnes-noble-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-barnes-noble-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/parseforge~barnes-noble-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-barnes-noble-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to search the Barnes & Noble Books department for, such as an author, a title or a topic. Leave empty to browse a collection URL instead.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Barnes & Noble collection URLs (for example https://www.barnesandnoble.com/collections/books/bestselling-books) or single book URLs (https://www.barnesandnoble.com/w/the-alchemist-paulo-coelho/1100248293). A ?q= term inside a collection URL is honoured.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "bookFormat": { "title": "Format", "enum": [ "", "Paperback", "Hardcover", "eBook", "Audiobook", "Board Book", "Large Print", "BN Exclusive", "Signed Book", "Special", "Interactive Book", "Sticker Book", "Coloring Book", "Audio CD", "Signed Exclusive", "Pop Up Book", "Bath Book", "Book and Toy", "NOOK Exclusive", "Other Format" ], "type": "string", "description": "Keep only one book format. Leave on Any format to mix them.", "default": "" }, "department": { "title": "Department", "enum": [ "", "Books", "Kids' Books", "eBooks & NOOK", "NOOK", "Teens & YA", "Book Annex", "Audiobooks", "Toys & Games" ], "type": "string", "description": "Keep only books Barnes & Noble files under one department.", "default": "" }, "subject": { "title": "Subject", "enum": [ "", "Kids", "Fiction", "Fiction & Literature - Kids", "Fiction Subjects", "Awards", "Mystery & Thrillers", "Romance", "Graphic Novels & Comics - Manga", "Manga", "Literature", "Science Fiction & Fantasy", "Thrillers", "Best Books of the Year", "Biography", "Religion", "Social Sciences", "Contemporary Romance", "History", "Bibles & Christianity", "Teens & YA", "Self-Help & Relationships", "Christianity", "Fantasy Fiction", "Literary Fiction", "Teen Fiction", "Animals - Kids Fiction", "Emotions & Behaviors - Kids Fiction", "Historical Fiction", "Graphic Novels & Comics", "Literary Styles & Movements - Fiction", "Women's Fiction", "Romantic Fiction Themes", "Family & Friendship - Fiction", "Peoples & Cultures - Fiction", "Personal Growth", "Contemporary Romance - General", "Current Affairs & Politics", "World Fiction", "Business", "Women Detectives - Fiction", "Family Life - Kids Fiction", "Cookbooks, Food & Wine", "Science & Technology", "Paranormal Romance", "Humor - Kids Fiction", "United States History", "Favorite Characters - Kids Fiction", "Art, Architecture & Photography", "Fantasy & Magic - Kids Fiction", "Fantasy Manga", "Adventure, Adventurers & Heroes - Kids Fiction", "Music, Film & Performing Arts", "Other Romance Categories", "General & Miscellaneous - Kids Fiction", "Cozy Mysteries & Amateur Sleuths", "Diet, Health & Fitness", "Kids' Book Awards", "Christian Life", "Bibles & Bible Studies", "Success, Motivation & Self-Esteem", "American Fiction", "Police Stories", "Travel", "Reference", "New Age & Alternative Beliefs", "Crime Fiction", "Women Sleuths", "Activity & Game Books", "Crime Thrillers", "Horror", "Detective Fiction", "Other Mystery Categories", "People, Places & Cultures - Kids Fiction", "General & Miscellaneous Biography", "Sports", "Social Sciences - General & Miscellaneous", "Settings & Atmosphere - Fiction", "Fantasy - Teen Fiction", "Fantasy Romance", "Women - General & Miscellaneous - Fiction", "World History", "Comic Books & Graphic Novels - Kids Fiction", "General & Miscellaneous Animals - Kids Fiction", "Games & Activities - Kids", "Reference & Study Aids - Kids", "Movie & TV Tie-Ins", "Comics & Graphic Novels - General & Miscellaneous", "Nature", "Romance - Teen Fiction", "Epic Fantasy", "Psychological Suspense", "Other Science Fiction Categories", "LGBT Fiction", "Parenting & Family", "Crafts & Hobbies", "Science Fiction, Fantasy & Horror Comics & Graphic Novels", "Bibles - Bible Versions", "Phases of Life - Fiction", "Historical Romance", "21st Century American Fiction", "Action & Adventure Manga", "Movie/Media/TV Tie-In - Kids Fiction", "Suspense Fiction", "Politics & Social Issues - Fiction", "General & Miscellaneous Christian Life", "Love & Relationships - Fiction", "Military History", "Basic Concepts - Kids Fiction", "Biography - General & Miscellaneous", "Discover Fiction & Literature", "Art - History & Criticism", "Action Thrillers", "Social Issues - Kids Fiction", "Other Fantasy Fiction Categories", "General & Miscellaneous Cooking", "Holidays, Festivals & Celebrations - Kids Fiction", "African Americans", "Peoples & Cultures - Biography", "Fiction Awards", "Crimes - Fiction", "U. S. People, Places & Cultures - Kids Fiction", "Light Novels (Ranobe)", "Self-Improvement", "Animals - Kids", "Psychology", "Women's Biography", "Science & Technology - Kids", "Humorous stories->Miscellanea->Children's fiction", "Occupations - Fiction", "Short Stories", "United States Politics & Government", "Discover Kids", "Music", "Family - Assorted Topics", "Mammals - Kids Fiction", "Other Awards", "School Life - Kids Fiction", "Philosophy", "Activity Books - Kids", "Poetry", "English, Scottish, & Welsh Fiction", "Family Life - Fiction", "Humorous Fiction", "Biography - Kids", "Classics for Children - Kids Fiction", "Superhero Comics & Graphic Novels", "General & Miscellaneous Religion", "Book Club Selections", "Home & Garden", "Adventure fantasy->Other", "Fiction Classics - Other", "Amateur Detectives", "20th Century Historical Fiction - General & Miscellaneous", "Humor", "European History", "Business Life & Careers", "20th Century American Fiction", "Contemporary Romantic Suspense", "Social Studies - Kids", "Poetry - Kids", "Education", "Health", "Romantic Comedy", "General & Miscellaneous Crafts & Hobbies", "Medicine & Nursing", "Best Books of the Year 2025", "Activity Books - Kids Fiction", "European Peoples & Cultures - Fiction & Literature", "Games & Activities - Kids Fiction", "Arts & Entertainment - Fiction", "Nature - Kids Fiction", "Fiction & Literature Classics", "Psychological Self-Help", "Alternative & Underground Comics", "Character Types - Fiction", "Mystery & Thriller Book Awards", "Teen Book Awards", "Occupations - Kids Fiction", "Alternate Realities - Fiction", "Political Biography", "Short Story Collections", "Business Life & Skills", "African Americans - Fiction & Literature", "Fairy Tales, Myths & Fables - Kids", "Romance Manga - General & Miscellaneous", "Manga - General & Miscellaneous", "British Literary Awards", "True Crime", "Books at the Movies", "Learning Basic Concepts - Kids", "Yaoi Manga", "Space Exploration - Fiction", "Management & Leadership", "General Romance", "Cooking - General & Miscellaneous", "Other Favorite Characters - Kids Fiction", "Historical Mysteries", "Coming of Age - Fiction", "Adventure & Survival - Teen Fiction", "Hi-Lo Fiction", "Barnes & Noble Monthly Picks", "Psychology - Theory, History & Research", "Medicine", "American Cozies", "Contemporary Fantasy", "African American Biography", "Dogs - Kids Fiction", "African American Biography & Memoir", "Choices & Transitions - Teen Fiction", "Historical Biography", "20th Century United States History - General & Miscellaneous", "Military Romance", "General Christianity", "Biology & Life Sciences", "Computers", "Friendship - Fiction", "Comedy Manga", "Crafts & Hobbies - General & Miscellaneous", "Historical Fiction - Other", "Other Sports", "Dark Fantasy", "Film", "Mysteries & Thrillers - Kids Fiction", "Best Books of the Year 2024", "Early Readers - Kids Fiction/Nonfiction", "Fiction - Other", "Astrology & Divination", "20th Century American Fiction - 1945-2000", "Media Tie-In Fiction", "Espionage Thrillers", "Small Town Contemporary Romance", "Nature - Kids", "Political Theory & Ideology", "Contemporary Romantic Comedy", "United States of America - Travel", "World War II", "Shonen - General & Miscellaneous", "Entertainment Biography", "Horror, Monsters & Ghosts - Kids Fiction", "Barnes & Noble's Best Books of 2025", "Dogs->Children's fiction", "Miscellaneous People, Places & Cultures - Kids Fiction", "African American History", "School Life Manga", "Fantasy Comic Books & Graphic Novels", "Adventure & Espionage Comics", "Horror - Other", "Historical Fantasy", "Science Fiction Manga", "African Americans - General & Miscellaneous", "Art by Subjects", "American Poetry", "Romantic Comedy Manga", "United States History - General & Miscellaneous", "New Age & Alternative Beliefs - General & Miscellaneous", "19th Century United States History - General & Miscellaneous", "Rhymes, Nursery Rhymes & Fingerplays - Kids Poetry", "History - Kids", "Women's Biography - General & Miscellaneous", "Travel - General & Miscellaneous", "Transportation & Travel - Kids Fiction", "Family & Relationships - Teen Fiction", "Sports & Recreation - Kids Fiction", "African Americans - Kids Fiction", "Coloring Books", "General & Miscellaneous World History", "Action & Adventure Science Fiction", "Christian Fiction & Literature", "Alternative Medicine & Natural Healing", "20th Century United States History - 1945 to 2000", "Detective Fiction - Private Investigators", "Alternative Spirituality", "English Language Arts - Kids", "Art - Fashion, Decorative Arts & Design", "Barnes & Noble's Best Books of 2024", "Literary Criticism", "Romance - New Adult", "Diet & Nutrition", "Politics & Government - General & Miscellaneous", "Cooking Fundamentals & Reference", "Bedtime, Dreams & Sleep - Kids Fiction", "Spiritual Life - Christian Life", "Best Books of the Year 2020", "Engineering", "Entertainment & The Arts - Kids Fiction", "Discover Mystery & Crime", "Girls & Young Women - Teen Fiction", "Science Fiction, Fantasy, & Horror Book Awards", "General Reference", "Mystery & Thriller Comics & Graphic Novels", "Social Science Fiction", "World History - General & Miscellaneous", "Fiction Classics", "Comics (Graphic novels)->Humorous->Children's fiction", "Small Towns - Fiction", "International Cooking", "Healing", "Emotional Healing", "Cats - Kids Fiction", "Big City Cops - Fiction" ], "type": "string", "description": "Keep only books filed under one Barnes & Noble subject. The list is the subject facet the site publishes on its Books grid.", "default": "" }, "ageRange": { "title": "Reading age", "enum": [ "", "0 - 2 Years", "3 - 5 Years", "6 - 8 Years", "9 - 12 Years", "Teens" ], "type": "string", "description": "Keep only books inside one of Barnes & Noble's reading-age bands. Applies to kids and teen titles.", "default": "" }, "availability": { "title": "Availability", "enum": [ "", "IN_STOCK", "SHIPS_IN_1_2_DAYS", "PREORDER" ], "type": "string", "description": "Keep only books in a given stock state.", "default": "" }, "language": { "title": "Language", "enum": [ "", "English", "Spanish", "French", "German", "Italian", "Portuguese", "Chinese", "Japanese", "Hebrew", "Arabic", "Latin", "Multiple Languages" ], "type": "string", "description": "Keep only books published in one language.", "default": "" }, "priceRange": { "title": "Price band", "enum": [ "", "Under $5", "$5 - $10", "$10 - $15", "$15 - $25", "$25 - $50", "Over $50" ], "type": "string", "description": "Keep only books inside one of the price bands Barnes & Noble offers on its browse grid.", "default": "" }, "minRating": { "title": "Minimum rating", "enum": [ "", "1", "2", "3", "4", "5" ], "type": "string", "description": "Keep only books whose Barnes & Noble customer rating is at least this many stars.", "default": "" }, "sortBy": { "title": "Sort by", "enum": [ "", "attributes.mfield_bnb__salesRank", "attributes.mfield_bnb__publicationDate desc", "attributes.mfield_bnb__publicationDate", "price", "price desc", "title" ], "type": "string", "description": "Order the browse grid before the Actor takes the first Max Items rows.", "default": "" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Route requests through the Apify proxy. Off by default because the source answers datacenter egress directly.", "default": { "useApifyProxy": 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 } } }, "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 } } } } } } } } } }