{ "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 } } } } } } } } } }