{ "openapi": "3.0.1", "info": { "title": "Bark.com Seller Scraper: Profiles, Star Ratings & Full Reviews", "description": "Extract Bark.com seller profiles by category and city, or direct profile links: business name, category, star rating, contact email, and every individual customer review with author, rating, date, and full text, not just an aggregate score. Export to Sheets, Zapier, or Make. Pay per seller.", "version": "0.1", "x-build-id": "hZfe0l3IaGV1FulEC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~bark-seller-details-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-bark-seller-details-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/getascraper~bark-seller-details-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-bark-seller-details-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/getascraper~bark-seller-details-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-bark-seller-details-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": { "categories": { "title": "Category + location pages", "type": "array", "description": "One or more Bark.com category/location slugs to crawl, in the form \"category/location\" (matching the site's own URL pattern, e.g. \"accountants/london\" for https://www.bark.com/en/gb/accountants/london/). Every seller linked from these listing pages is visited for full profile details. Find category and location slugs from Bark's own homepage navigation or by browsing bark.com directly.", "default": [ "accountants/london" ], "items": { "type": "string" } }, "startUrls": { "title": "Direct seller profile URLs (optional)", "type": "array", "description": "Optional: skip category/location discovery entirely and scrape these exact Bark seller profile URLs instead (must be the current \"/en/{country}/b/{slug}/{id}/\" profile path, e.g. https://www.bark.com/en/gb/b/5-rivers-accountancy/PAvAe/). If provided, these are scraped in addition to any category/location pages above.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "country": { "title": "Country", "enum": [ "gb", "us", "ca", "ie", "za", "au", "nz", "sg", "in" ], "type": "string", "description": "Bark.com country/locale to scrape category pages from (only applies to the Category + location field above; direct seller URLs already contain their own country segment).", "default": "gb" }, "maxSellers": { "title": "Max sellers", "minimum": 0, "type": "integer", "description": "Maximum number of seller profiles to scrape and push to the dataset across all category/location pages combined. Use 0 for no limit (every seller linked from the listing pages given).", "default": 30 }, "includeReviews": { "title": "Include individual reviews", "type": "boolean", "description": "When enabled (default), extracts every individual customer review on each seller's profile (author name, star rating, date, and full review text) as a structured array on the seller record. Disable for a lighter, faster run when you only need the seller's aggregate rating and contact details, not the full review corpus.", "default": true }, "maxReviewsPerSeller": { "title": "Max reviews per seller", "minimum": 0, "type": "integer", "description": "When \"Include individual reviews\" is enabled, caps how many of each seller's reviews are kept (most recent first, matching page order). Use 0 for no limit (every review on the profile page). Ignored if reviews are disabled.", "default": 20 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxy is the default. A live production comparison (2026-07-11) found Apify's shared datacenter pool hit repeated 403 blocks against Bark.com even at this Actor's conservative pace, while an otherwise-identical run on residential completed with zero blocks. Datacenter is still selectable for a cost-saving pilot, but expect a higher block/retry rate.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }