{ "openapi": "3.0.1", "info": { "title": "Mamas & Papas Scraper", "description": "Scrape Mamas & Papas (mamasandpapas.com) - UK baby & nursery retailer. Search products, browse by collection (pushchairs, car seats, cots, nursery furniture, feeding, clothing), look up exact products by handle/URL, and list the full collection taxonomy.", "version": "1.0", "x-build-id": "6JNSE7SATm2ioRxj0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~mamas-papas-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-mamas-papas-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/crawlerbros~mamas-papas-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-mamas-papas-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/crawlerbros~mamas-papas-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-mamas-papas-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", "byCollection", "byProductHandles", "listCollections" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Search query (mode=search)", "type": "string", "description": "Free-text query matched against product title, brand and type.", "default": "pushchair" }, "collectionHandle": { "title": "Collection (mode=byCollection)", "enum": [ "", "pushchairs", "travel-systems", "travel-strollers", "car-seats", "group-0-car-seats", "carry-cots", "cots-cot-beds", "bedside-cribs", "moses-baby-baskets", "nursery-furniture", "highchairs", "highchairs-booster-seats", "feeding-weaning", "feeding-essentials", "bottle-feeding-essentials", "breastpumps-and-accessories", "baby-sterilisers-blenders", "bathing-changing", "bath-time-baby-care-essentials", "baby-changing-bags", "baby-monitors", "baby-safety", "baby-clothing", "baby-boy-clothing", "baby-girl-clothing", "baby-swimwear", "baby-toys", "toys-gifts", "baby-books", "nursery-baby-bedding", "cot-bedding", "newborn-baby-gifts", "baby-shower-gifts", "christening-gifts", "personalised-baby-gifts", "baby-hampers-gift-sets", "1st-birthday-gifts", "new-in", "baby-sale-offers-bundles", "baby-sale-clearance", "all-products" ], "type": "string", "description": "Pick a common category. Choose \"(custom — use field below)\" to browse any of the site's 1500+ collections by exact handle.", "default": "pushchairs" }, "customCollectionHandle": { "title": "Custom collection handle (mode=byCollection)", "type": "string", "description": "Exact collection handle (from a mamasandpapas.com/collections/ URL). Overrides the dropdown above when set." }, "productHandles": { "title": "Product handles or URLs (mode=byProductHandles)", "type": "array", "description": "Product handles (e.g. `graco-daisi-2in1-soother-72352q100`) or full product URLs.", "default": [], "items": { "type": "string" } }, "minPrice": { "title": "Min price (GBP)", "minimum": 0, "maximum": 100000, "type": "number", "description": "Drop products priced below this (searches/byCollection/byProductHandles)." }, "maxPrice": { "title": "Max price (GBP)", "minimum": 0, "maximum": 100000, "type": "number", "description": "Drop products priced above this." }, "inStockOnly": { "title": "In stock only", "type": "boolean", "description": "Only emit products with at least one available variant.", "default": false }, "brand": { "title": "Brand contains", "type": "string", "description": "Case-insensitive substring match against the product's brand/vendor (e.g. `Graco`, `Maxi-Cosi`, `Mamas & Papas`)." }, "keyword": { "title": "Keyword contains", "type": "string", "description": "Case-insensitive substring match against the product's title, brand and description (searches/byCollection/byProductHandles/customCollectionHandle). Use this to further narrow a category browse or product lookup — separate from `searchQuery`, which drives what mode=search fetches in the first place." }, "category": { "title": "Category", "enum": [ "", "Baby Gifts", "Baby Mattresses", "Baby Safety", "Baby Toys", "Bathing & Changing", "Car Seats", "Clothing", "Feeding Essentials", "Nursery Bedding", "Nursery Decor", "Nursery Furniture", "Pushchair Accessories", "Travel Accessories", "Travel Cots", "Travel Systems" ], "type": "string", "description": "Filter to products tagged with this top-level category (parsed from the store's own taxonomy). Only products with a known category are matched; others pass through." }, "subCategory": { "title": "Sub-category", "enum": [ "", "Accessories", "Activity Toys", "Adaptors", "All-in-Ones & Bodysuits", "Baby Car Seats", "Baby Care", "Baby Carriers", "Baby Floor Seating", "Baby Mirrors", "Baby Monitors", "Baby Nests", "Baby Seating", "Baby Weaning", "Baby-Toddler Car Seats", "Bases", "Bath Seats", "Bath Support", "Bath Toys", "Baths", "Bed Safety Rails", "Bedding Sets", "Bedside Sleeping", "Bibs & Muslins", "Blankets", "Books", "Booster Seats", "Bottle Feeding", "Bouncers", "Breastfeeding", "Buggies", "Buggyboards", "Bumper Bar", "Car Seats", "Carrycot Stand", "Carrycot Stands", "Carrycots", "Changing Bags", "Changing Mats", "Childrens Bags", "Comforters", "Cot Mattresses", "Cot Sheets", "Cotbed Bundles", "Cotbed Mattresses", "Cotbed Sheets", "Cotbeds", "Cots", "Crib Mattresses", "Crib Sheets", "Cup Holder", "Cutlery", "Dreampod Sleep Bags & Swaddling", "Dreampod Swaddles", "Dressers & Changers", "Dresses & Skirts", "Eco Friendly & Wooden Toys", "Every Stage Car Seats", "First Aid Kit", "Footmuffs", "Furniture Sets", "Gift Boxes", "Hats & Booties", "Hats & Mitts", "Health Care", "Highchair Toys", "Highchairs", "Hooded Towels", "Jackets & Coats", "Jigsaws & Puzzles", "Jumpers & Knitwear", "Junior & Child Car Seats", "Mattress & Protector Bundle", "Mattress Protectors", "Mobiles", "Moses Basket Bedding", "Moses Basket Bundles", "Moses Basket Sheets", "Moses Basket Stands", "Moses Baskets", "Nappy Bins", "Nappy Caddy", "Newborn Packs", "Night Lights", "Nursery Bundle", "Nursing Chair Sets", "Nursing Chairs", "Organisers", "Outdoor Play", "Outfits & Sets", "Parasols", "Petite Cot Bundles", "Photo Frame", "Playmats & Gyms", "Potties", "Pramsuits", "Pregnancy & Nursing Pillows", "Pushchair Liners", "Pushchairs", "Pyjamas & Nightwear", "Quilts & Coverlets", "Raincovers", "Ride on Toy", "Rockers", "Rocking Animals", "Rompers", "Safety Gates", "Safety Reins", "Seat Fabric", "Seat Protectors", "Seat Units", "Sheets", "Shoes & Booties", "Small Cotbed Bundles", "Small Cotbeds", "Socks & Tights", "Soft Toys", "Soothers", "Step Up Stools", "Sterilisers", "Storage", "Stroller Organiser", "Sunshades", "Swimwear", "Swings", "Teethers", "Thermometers", "Toddler Car Seats", "Toddler-Child Car Seats", "Tops & Shirts", "Towelling", "Toy Bars", "Travel Cot Sheets", "Travel Cots", "Travel Systems", "Travel Toys", "Trousers & Leggings", "Tummy Time", "Twin Buggies", "Twin Pushchairs", "Walker", "Walkers", "Wall Art & Wallpaper", "Wardrobes", "Wheeled Boards" ], "type": "string", "description": "Filter to products tagged with this fine-grained sub-category (parsed from the store's own taxonomy). Only products with a known sub-category are matched; others pass through." }, "colour": { "title": "Colour", "enum": [ "", "Beige", "Berry", "Black", "Blue", "Brown", "Cashmere", "Clear", "Cream", "Gold", "Green", "Greige", "Grey", "Ivory", "Monochrome", "Multi", "Natural", "Navy", "Neutral", "Oak", "Oatmeal", "Orange", "Pink", "Plum", "Purple", "Red", "Sage Green", "Sand", "Stone", "Tan", "Walnut", "White", "Yellow" ], "type": "string", "description": "Filter to products tagged with this colour (parsed from the store's own colour taxonomy). Only products with a known colour are matched; others pass through." }, "gender": { "title": "Gender", "enum": [ "", "Boys", "Girls", "Unisex" ], "type": "string", "description": "Filter to products tagged with this gender (mostly relevant for clothing). Only products with a known gender are matched; others pass through." }, "ageRange": { "title": "Age range", "enum": [ "", "Newborn", "Tiny Baby", "Up To 1 Month", "0-1 Months", "0+ Months", "0-3 Months", "0-6 Months", "0-8 Months", "0-12 Months", "0-15 Months", "0 Months - 18 Months", "0 Months - 2 Years", "0 Months - 4 Years", "3+ Months", "3-6 Months", "3 Months - 4 Years", "4+ Months", "6+ Months", "6-18 Months", "9+ Months", "10+ Months", "12+ Months", "15+ Months", "18+ Months", "2+ Years", "3+ Years", "3-12 Years", "3.5+ Years", "One Size" ], "type": "string", "description": "Filter to products tagged with this age/size range (parsed from the store's own taxonomy). Only products with a known age range are matched; others pass through." }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "priceAsc", "priceDesc", "titleAsc", "titleDesc", "newest" ], "type": "string", "description": "Result ordering, applied by the actor after fetching a candidate pool (the store's own products.json endpoint does not honor sort order).", "default": "relevance" }, "minProductsCount": { "title": "Min products count (mode=listCollections)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Only emit collections with at least this many products." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records.", "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 } } }, "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 } } } } } } } } } }