{ "openapi": "3.0.1", "info": { "title": "Petco Product Scraper", "description": "Scrape Petco products by keyword, category or URL — price, autoship price, ratings, reviews, brand, images, ingredients, specs and stock as clean JSON or CSV. Built for price monitoring, catalog tracking and brand research. Pay only for the results you get.", "version": "1.0", "x-build-id": "zSWKQbCBbedqrWWzm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axlymxp~petco-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axlymxp-petco-product-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/axlymxp~petco-product-scraper/runs": { "post": { "operationId": "runs-sync-axlymxp-petco-product-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/axlymxp~petco-product-scraper/run-sync": { "post": { "operationId": "run-sync-axlymxp-petco-product-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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Keywords to search on Petco (e.g. 'dog food', 'cat litter'). Each query is paginated up to 'Max items per query'.", "items": { "type": "string" } }, "categories": { "title": "Category slugs", "type": "array", "description": "Petco category / collection slugs to browse (e.g. 'dog', 'cat', 'fish', 'autoship-eligible-products'). Use the last path segment of a Petco category URL.", "items": { "type": "string" } }, "productUrls": { "title": "Product URLs", "type": "array", "description": "Direct Petco product page URLs (or product slugs). These are always returned with full detail (and reviews if enabled).", "items": { "type": "string" } }, "maxItems": { "title": "Max items (total)", "minimum": 1, "type": "integer", "description": "Stop the whole run after this many product rows.", "default": 100 }, "maxItemsPerQuery": { "title": "Max items per query", "minimum": 1, "type": "integer", "description": "Cap on rows collected per search query / category before moving to the next. Petco's search window tops out around 10,000 results per query.", "default": 1000 }, "includeDetails": { "title": "Include full product detail", "type": "boolean", "description": "Fetch each product's page for variants, ingredients, specifications, guaranteed analysis, inventory status and breadcrumbs. Adds a per-product enrichment charge. Direct product URLs are always detailed.", "default": false }, "includeReviews": { "title": "Include customer reviews", "type": "boolean", "description": "Include the first page of Bazaarvoice customer reviews (up to ~10) embedded in each product page, plus the total review count. Requires a product-page fetch, so it adds the per-product enrichment charge.", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "TopSold", "AverageRating", "offerprice", "startDate", "item_name" ], "type": "string", "description": "Sort order for search & category results.", "default": "relevance" }, "sortOrder": { "title": "Sort direction", "enum": [ "", "ascending", "descending" ], "type": "string", "description": "Ascending or descending. Leave on 'Auto' to use the sensible default for the chosen sort (e.g. price low→high, rating high→low).", "default": "" }, "brands": { "title": "Brand filter", "type": "array", "description": "Restrict results to these brands (Petco 'Primary Brand' facet, e.g. 'Purina Pro Plan', 'Blue Buffalo').", "items": { "type": "string" } }, "minPrice": { "title": "Minimum price (USD)", "minimum": 0, "type": "integer", "description": "Only keep products at or above this price." }, "maxPrice": { "title": "Maximum price (USD)", "minimum": 0, "type": "integer", "description": "Only keep products at or below this price." }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Only keep products with an average rating at or above this value (0–5)." }, "zyteApiKey": { "title": "Zyte API key (optional)", "type": "string", "description": "Optional: use your own Zyte API key for the product-page (detail / reviews) fetches. Leave blank to use the built-in residential fetch." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Egress proxy for the product API. Petco's search API is ungated and works from most IPs; the default Apify Proxy provides a stable egress.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }