# Bark.com Category x Location Scraper (`moving_beacon-owner1/bark-com-category-x-location-scraper`) Actor An Actor collects service provider listings from Bark by selected categories and locations (states or cities) and returns structured business data like name, rating, description, profile URL, reviews, and location details, with limits on pages and items per run. - **URL**: https://apify.com/moving\_beacon-owner1/bark-com-category-x-location-scraper.md - **Developed by:** [Jamshaid Arif](https://apify.com/moving_beacon-owner1) (community) - **Categories:** Lead generation, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $10.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Bark.com Category x Location Scraper (Apify actor) Select **categories** and **states** (and optional `state/city` drill-downs) from the input form; the actor walks each category x location combination, parses Bark's server-rendered seller cards, and writes one record per provider. ### Input (all selectable) - **Categories** — multi-select dropdown (83 Bark service categories). - **States** — multi-select dropdown (50 states + DC). - **City drill-downs** — optional `state/city` strings, e.g. `texas/houston`. - **maxPagesPerCombo / maxItemsPerCombo / maxItems** — depth + hard caps. - **requestDelaySeconds**, **useApifyProxy** (RESIDENTIAL, US). ### Output One record per provider: `name, rating, description, profile_url, company_id, avatar, review_author, review_rating, review_text, category, state, city, page, source_url`. ### Scope and terms Built for the combinations you select, with per-combo and global hard caps — not a full category x all-states x all-cities sweep. For bulk/commercial volume use Bark's licensed/API access. Bark's robots.txt explicitly allows `/company/` profile pages; confirm the `/en/us///` listing path is not in the Disallow block before running at volume. # Actor input Schema ## `categories` (type: `array`): Pick the Bark service categories to scrape. ## `states` (type: `array`): Pick the US states to scrape (state-level listings). ## `cities` (type: `array`): Optional state/city pairs for finer targeting, e.g. "texas/houston", "new-york/manhattan". ## `maxPagesPerCombo` (type: `integer`): Pagination depth per category+location combination. ## `maxItemsPerCombo` (type: `integer`): Maximum provider records to keep per category+location. ## `maxItems` (type: `integer`): Global hard cap on total records for the whole run. ## `requestDelaySeconds` (type: `integer`): Politeness delay between page requests, in seconds. ## `useApifyProxy` (type: `boolean`): Route requests through Apify Proxy (RESIDENTIAL, US). ## Actor input object example ```json { "categories": [ "web-design" ], "states": [ "new-york" ], "cities": [], "maxPagesPerCombo": 1, "maxItemsPerCombo": 50, "maxItems": 500, "requestDelaySeconds": 3, "useApifyProxy": true } ```` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "categories": [ "web-design" ], "states": [ "new-york" ], "cities": [] }; // Run the Actor and wait for it to finish const run = await client.actor("moving_beacon-owner1/bark-com-category-x-location-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "categories": ["web-design"], "states": ["new-york"], "cities": [], } # Run the Actor and wait for it to finish run = client.actor("moving_beacon-owner1/bark-com-category-x-location-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "categories": [ "web-design" ], "states": [ "new-york" ], "cities": [] }' | apify call moving_beacon-owner1/bark-com-category-x-location-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=moving_beacon-owner1/bark-com-category-x-location-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Bark.com Category x Location Scraper", "description": "An Actor collects service provider listings from Bark by selected categories and locations (states or cities) and returns structured business data like name, rating, description, profile URL, reviews, and location details, with limits on pages and items per run.", "version": "0.0", "x-build-id": "wIeejmTaU1S8Y4aY2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/moving_beacon-owner1~bark-com-category-x-location-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-moving_beacon-owner1-bark-com-category-x-location-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/moving_beacon-owner1~bark-com-category-x-location-scraper/runs": { "post": { "operationId": "runs-sync-moving_beacon-owner1-bark-com-category-x-location-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/moving_beacon-owner1~bark-com-category-x-location-scraper/run-sync": { "post": { "operationId": "run-sync-moving_beacon-owner1-bark-com-category-x-location-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": [ "categories", "states" ], "properties": { "categories": { "title": "Categories", "type": "array", "description": "Pick the Bark service categories to scrape.", "items": { "type": "string", "enum": [ "academic-lessons", "accountants", "advertising-and-media-buying", "aerial-home-cinema-networking", "airport-transfers", "architects", "architects-surveyors-planners", "bookkeeping-services", "business-career-coaching", "business-consulting", "caterers", "cctv-installation", "cleaners", "commercial-cleaning", "counselling", "crafts", "design-web", "development-and-software", "dj-hire", "dog-training", "dog-walking", "electrical-lighting", "employment-law", "english-lessons", "entertainment", "event-videography", "fence-installers", "garden-clearance", "gardeners", "gardening-landscaping", "general-accounting", "general-copywriting", "graphic-design", "guitar-lessons", "gutter-cleaning-repairs", "headshot-photographers", "health-wellness", "heating-hot-water-air-conditioning", "hr-services", "hypnotherapy", "immigration-lawyer", "language-classes", "life-coaching", "limousine-hire", "locksmith-security-fire-safety", "magician", "marketing", "massage-therapy", "maths-tutors", "mobile-software-development", "motivational-speakers", "music-services", "nutritionist", "occupational-lessons", "party-event-planners", "performance-arts-lessons", "personal-chef-services", "personal-trainer", "pet-grooming", "photo-booth-hire", "photographer", "photography-services", "plumbing-drainage", "private-investigators", "production", "recreational-lessons", "repair-technical-support", "search-engine-optimization", "security-guards", "social-media-marketing", "specialist-tradesmen", "swimming-pools-hot-tubs", "tax-accountants", "therapy", "transport", "web-design", "wedding-cakes", "wedding-car-hire", "wedding-catering", "wedding-flowers", "wedding-photographers", "wills-and-estate-planning", "writing-translation-and-transcription" ], "enumTitles": [ "Academic Lessons", "Accountants", "Advertising And Media Buying", "Aerial Home Cinema Networking", "Airport Transfers", "Architects", "Architects Surveyors Planners", "Bookkeeping Services", "Business Career Coaching", "Business Consulting", "Caterers", "Cctv Installation", "Cleaners", "Commercial Cleaning", "Counselling", "Crafts", "Design Web", "Development And Software", "Dj Hire", "Dog Training", "Dog Walking", "Electrical Lighting", "Employment Law", "English Lessons", "Entertainment", "Event Videography", "Fence Installers", "Garden Clearance", "Gardeners", "Gardening Landscaping", "General Accounting", "General Copywriting", "Graphic Design", "Guitar Lessons", "Gutter Cleaning Repairs", "Headshot Photographers", "Health Wellness", "Heating Hot Water Air Conditioning", "Hr Services", "Hypnotherapy", "Immigration Lawyer", "Language Classes", "Life Coaching", "Limousine Hire", "Locksmith Security Fire Safety", "Magician", "Marketing", "Massage Therapy", "Maths Tutors", "Mobile Software Development", "Motivational Speakers", "Music Services", "Nutritionist", "Occupational Lessons", "Party Event Planners", "Performance Arts Lessons", "Personal Chef Services", "Personal Trainer", "Pet Grooming", "Photo Booth Hire", "Photographer", "Photography Services", "Plumbing Drainage", "Private Investigators", "Production", "Recreational Lessons", "Repair Technical Support", "Search Engine Optimization", "Security Guards", "Social Media Marketing", "Specialist Tradesmen", "Swimming Pools Hot Tubs", "Tax Accountants", "Therapy", "Transport", "Web Design", "Wedding Cakes", "Wedding Car Hire", "Wedding Catering", "Wedding Flowers", "Wedding Photographers", "Wills And Estate Planning", "Writing Translation And Transcription" ] } }, "states": { "title": "States", "type": "array", "description": "Pick the US states to scrape (state-level listings).", "items": { "type": "string", "enum": [ "alabama", "alaska", "arizona", "arkansas", "california", "colorado", "connecticut", "delaware", "district-of-columbia", "florida", "georgia", "hawaii", "idaho", "illinois", "indiana", "iowa", "kansas", "kentucky", "louisiana", "maine", "maryland", "massachusetts", "michigan", "minnesota", "mississippi", "missouri", "montana", "nebraska", "nevada", "new-hampshire", "new-jersey", "new-mexico", "new-york", "north-carolina", "north-dakota", "ohio", "oklahoma", "oregon", "pennsylvania", "rhode-island", "south-carolina", "south-dakota", "tennessee", "texas", "utah", "vermont", "virginia", "washington", "west-virginia", "wisconsin", "wyoming" ], "enumTitles": [ "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado", "Connecticut", "Delaware", "District Of Columbia", "Florida", "Georgia", "Hawaii", "Idaho", "Illinois", "Indiana", "Iowa", "Kansas", "Kentucky", "Louisiana", "Maine", "Maryland", "Massachusetts", "Michigan", "Minnesota", "Mississippi", "Missouri", "Montana", "Nebraska", "Nevada", "New Hampshire", "New Jersey", "New Mexico", "New York", "North Carolina", "North Dakota", "Ohio", "Oklahoma", "Oregon", "Pennsylvania", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont", "Virginia", "Washington", "West Virginia", "Wisconsin", "Wyoming" ] } }, "cities": { "title": "City drill-downs (optional)", "type": "array", "description": "Optional state/city pairs for finer targeting, e.g. \"texas/houston\", \"new-york/manhattan\".", "items": { "type": "string" } }, "maxPagesPerCombo": { "title": "Max pages per category+location", "minimum": 1, "maximum": 20, "type": "integer", "description": "Pagination depth per category+location combination.", "default": 1 }, "maxItemsPerCombo": { "title": "Max items per category+location", "minimum": 1, "type": "integer", "description": "Maximum provider records to keep per category+location.", "default": 50 }, "maxItems": { "title": "Max items (global hard cap)", "minimum": 1, "type": "integer", "description": "Global hard cap on total records for the whole run.", "default": 500 }, "requestDelaySeconds": { "title": "Delay between requests (seconds)", "minimum": 1, "maximum": 30, "type": "integer", "description": "Politeness delay between page requests, in seconds.", "default": 3 }, "useApifyProxy": { "title": "Use Apify US residential proxy", "type": "boolean", "description": "Route requests through Apify Proxy (RESIDENTIAL, US).", "default": 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 } } } } } } } } } } ```