{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Local Services Ads Provider Finder",
    "description": "Find Google Local Services Ads providers by trade and city or ZIP. Returns ratings, review counts and histograms, years in business, hours, highlights, response times, phone numbers, stable Google IDs and profile links, with optional services, verification and review topics.",
    "version": "1.0",
    "x-build-id": "RYxaGklxoRk317cBC"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/xyrelith-data~google-local-services-ads/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-xyrelith-data-google-local-services-ads",
        "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/xyrelith-data~google-local-services-ads/runs": {
      "post": {
        "operationId": "runs-sync-xyrelith-data-google-local-services-ads",
        "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/xyrelith-data~google-local-services-ads/run-sync": {
      "post": {
        "operationId": "run-sync-xyrelith-data-google-local-services-ads",
        "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": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "byQuery",
              "byUrls"
            ],
            "type": "string",
            "description": "Search by trade and location, run full queries, or fetch exact Google Local Services URLs.",
            "default": "search"
          },
          "categories": {
            "title": "Service categories (mode=search)",
            "uniqueItems": true,
            "type": "array",
            "description": "Google's LSA categories. Each selected category is searched in every location.",
            "items": {
              "type": "string",
              "enum": [
                "acupuncturist",
                "allergist",
                "animal_shelter",
                "appliance_repair",
                "architect",
                "audiologist",
                "auto_body_shop",
                "auto_repair_shop",
                "bankruptcy_lawyer",
                "barber_shop",
                "bathroom_remodeling",
                "beauty_school",
                "business_lawyer",
                "car_wash_and_detailing",
                "carpenter",
                "carpet_cleaning",
                "cellphone_and_laptop_repair",
                "child_care",
                "chiropractor",
                "cleaning_service",
                "contract_lawyer",
                "countertop_pro",
                "criminal_lawyer",
                "dance_instructor",
                "dentist",
                "dermatologist",
                "dietitian",
                "disability_lawyer",
                "drain_expert",
                "driving_instructor",
                "dui_lawyer",
                "electrician",
                "estate_lawyer",
                "family_lawyer",
                "fencing_pro",
                "financial_planner",
                "first_aid_trainer",
                "flooring_pro",
                "foundation_pro",
                "funeral_home",
                "garage_door_pro",
                "general_contractor",
                "hair_removal",
                "hair_salon",
                "handyman",
                "home_inspector",
                "home_insulation",
                "home_security",
                "home_theater",
                "hvac",
                "immigration_lawyer",
                "insurance_agency",
                "interior_designer",
                "ip_lawyer",
                "junk_removal",
                "kitchen_remodeling",
                "labor_lawyer",
                "landscaper",
                "language_instructor",
                "lawn_care",
                "litigation_lawyer",
                "locksmith",
                "malpractice_lawyer",
                "massage_school",
                "massage_therapist",
                "mover",
                "nail_salon",
                "occupational_therapist",
                "ophthalmologist",
                "optometrist",
                "orthodontist",
                "orthopedic_surgeon",
                "painter",
                "personal_injury_lawyer",
                "personal_trainer",
                "pest_control",
                "pet_adoption",
                "pet_boarding",
                "pet_grooming",
                "pet_trainer",
                "physiotherapist",
                "piercing_studio",
                "plastic_surgeon",
                "plumber",
                "podiatrist",
                "pool_cleaner",
                "pool_contractor",
                "preschool",
                "primary_care",
                "real_estate_agent",
                "real_estate_lawyer",
                "roofer",
                "sewage_pro",
                "siding_pro",
                "snow_removal",
                "solar_energy_contractor",
                "storage",
                "tattoo_studio",
                "tax_lawyer",
                "tax_specialist",
                "tire_shop",
                "towing",
                "traffic_lawyer",
                "tree_service",
                "tutor",
                "veterinarian",
                "water_damage",
                "weight_loss_service",
                "window_cleaner",
                "window_repair",
                "yoga_instructor"
              ],
              "enumTitles": [
                "Acupuncturist",
                "Allergist",
                "Animal rescue",
                "Appliance repair",
                "Architect",
                "Audiologist",
                "Auto body shop",
                "Auto repair shop",
                "Bankruptcy lawyer",
                "Barber shop",
                "Bathroom remodeling",
                "Beauty school",
                "Business lawyer",
                "Car wash and detailing",
                "Carpenter",
                "Carpet and upholstery cleaning",
                "Cellphone and laptop repair",
                "Child care",
                "Chiropractor",
                "House cleaning",
                "Contract lawyer",
                "Countertop services",
                "Criminal lawyer",
                "Dance instructor",
                "Dentist",
                "Dermatologist",
                "Dietitian",
                "Disability lawyer",
                "Drain expert",
                "Driving instructor",
                "DUI lawyer",
                "Electrician",
                "Estate lawyer",
                "Family lawyer",
                "Fencing services",
                "Financial planner",
                "First aid trainer",
                "Flooring services",
                "Foundations services",
                "Funeral home",
                "Garage door",
                "General contractor",
                "Hair removal",
                "Hair salon",
                "Handyman",
                "Home inspector",
                "Home insulation",
                "Home security",
                "Home theater",
                "HVAC",
                "Immigration lawyer",
                "Insurance agency",
                "Interior designer",
                "IP lawyer",
                "Junk removal",
                "Kitchen remodeling",
                "Labor lawyer",
                "Landscaper",
                "Language instructor",
                "Lawn care",
                "Litigation lawyer",
                "Locksmith",
                "Malpractice lawyer",
                "Massage school",
                "Massage therapist",
                "Moving services",
                "Nail salon",
                "Occupational therapist",
                "Ophthalmologist",
                "Optometrist",
                "Orthodontist",
                "Orthopedic surgeon",
                "Painter",
                "Personal injury lawyer",
                "Personal trainer",
                "Pest control",
                "Pet adoption",
                "Pet boarding",
                "Pet grooming",
                "Pet trainer",
                "Physical therapist",
                "Piercing studio",
                "Plastic surgeon",
                "Plumber",
                "Podiatrist",
                "Pool cleaner",
                "Pool contractor",
                "Preschool",
                "Primary care physician",
                "Real estate agent",
                "Real estate lawyer",
                "Roofer",
                "Sewage system services",
                "Siding services",
                "Snow removal",
                "Solar energy contractor",
                "Storage",
                "Tattoo studio",
                "Tax lawyer",
                "Tax specialist",
                "Tire shop",
                "Towing",
                "Traffic lawyer",
                "Tree service",
                "Tutor",
                "Veterinarian",
                "Water damage services",
                "Weight loss service",
                "Window cleaning",
                "Window repair",
                "Yoga instructor"
              ]
            },
            "default": [
              "plumber"
            ]
          },
          "services": {
            "title": "Extra service terms (mode=search)",
            "type": "array",
            "description": "Free-text trades added to the selected categories, e.g. 'water heater repair' or 'roof repair'. Each is searched in every location.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "locations": {
            "title": "Locations (mode=search)",
            "type": "array",
            "description": "Cities, districts or ZIP codes, e.g. 'Austin, TX', 'Toronto, ON', 'London, UK' or '78701'. Include the state, province or country.",
            "items": {
              "type": "string"
            },
            "default": [
              "Austin, TX"
            ]
          },
          "searchQueries": {
            "title": "Full queries (mode=byQuery)",
            "type": "array",
            "description": "Complete searches such as 'plumber in Austin, TX' or 'personal injury lawyer in Chicago, IL'. The country is detected from each query.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "startUrls": {
            "title": "Local Services URLs (mode=byUrls)",
            "type": "array",
            "description": "google.com/localservices/prolist or /profile URLs. Profile URLs return that single provider.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "countryCode": {
            "title": "Country",
            "enum": [
              "auto",
              "US",
              "CA",
              "GB",
              "IE",
              "DE",
              "FR",
              "IT",
              "ES",
              "AT",
              "BE",
              "CH"
            ],
            "type": "string",
            "description": "Country used for Google's market and the proxy exit. Auto detects from the location (US when unclear).",
            "default": "auto"
          },
          "language": {
            "title": "Language",
            "enum": [
              "en",
              "fr",
              "de",
              "it",
              "es",
              "nl"
            ],
            "type": "string",
            "description": "Interface language for result text. English works in every market.",
            "default": "en"
          },
          "minRating": {
            "title": "Minimum rating",
            "enum": [
              "any",
              "2.0",
              "2.5",
              "3.0",
              "3.5",
              "4.0",
              "4.5"
            ],
            "type": "string",
            "description": "Ask Google for providers at or above this rating. 'Any' keeps every provider.",
            "default": "any"
          },
          "hours": {
            "title": "Hours",
            "enum": [
              "any",
              "openNow",
              "open24Hours",
              "sunday",
              "monday",
              "tuesday",
              "wednesday",
              "thursday",
              "friday",
              "saturday"
            ],
            "type": "string",
            "description": "Only providers open now, open 24 hours, or open on a given weekday.",
            "default": "any"
          },
          "minReviews": {
            "title": "Minimum reviews",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Skip providers with fewer reviews. 0 keeps all.",
            "default": 0
          },
          "minYearsInBusiness": {
            "title": "Minimum years in business",
            "minimum": 0,
            "maximum": 200,
            "type": "integer",
            "description": "Skip providers with fewer years in business. 0 keeps all.",
            "default": 0
          },
          "requirePhone": {
            "title": "Require a phone number",
            "type": "boolean",
            "description": "Drop providers without a published call-tracking number.",
            "default": false
          },
          "verifiedOnly": {
            "title": "Verified by Google only",
            "type": "boolean",
            "description": "Keep only providers whose profile says they are verified by Google. Turns on profile details automatically.",
            "default": false
          },
          "includeProfileDetails": {
            "title": "Include profile details",
            "type": "boolean",
            "description": "Fetch each provider's LSA profile for services offered, Google verification, address, review topics and snippets.",
            "default": false
          },
          "maxProfileLookups": {
            "title": "Maximum profile lookups",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "Cap on profile requests per run when profile details are enabled.",
            "default": 40
          },
          "maxItems": {
            "title": "Maximum providers",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Stop after this many unique providers across all searches.",
            "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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}