Google Maps Lawyers Scraper

🔎 What is Google Maps Lawyers Scraper?

Google Maps Lawyers Scraper extracts law firms and lawyers from Google Maps: name, phone, website, address, rating, reviews, opening hours and coordinates, for any practice area in any city. It works as a Google Maps API alternative for lawyers: run it on a schedule, call it from your code, or plug it into Make, Zapier or n8n.

Pick one or more practice areas (divorce, personal injury, DUI, immigration…) and type a city, a ZIP code or a country, then click Start and download the firms in JSON, CSV or Excel. No login, nothing to set up. In the big US cities it goes past the 120 firms Google Maps shows for one search.

📋 What data can you extract from Google Maps?

One item per law firm, 65 fields:

Category	What you get
🏷️ Firm	name, main category, every Google category, areas of law — Thompson Law Austin Divorce Attorneys, Divorce, Family law
📍 Address	full address, street, city, state, ZIP code, country, neighborhood, latitude, longitude, plus code
📞 Contact	phone (national and international format), website and its domain, appointment link
⭐ Reputation	rating, number of reviews, a review quote, the Google Maps link of the firm
🕒 Hours and features	opening hours, hours of online services, "Online appointments", accessibility, the account that manages the listing
🔎 The search	which search found the firm and at which position
📝 Google Maps page (option)	the description the firm wrote, the number of reviews per star, the latest reviews with their text, stars, date and the firm's answer
🏛️ State bar (option)	for firms in New York, Florida and California: the attorneys confirmed as the firm's in the official register, with their bar number, license status (active, inactive…) and admission year
📧 Firm's website (options)	e-mails found on its website, its Facebook, LinkedIn, Instagram, X, YouTube and TikTok links, the areas of law it lists, a free consultation, how it is paid (contingency, flat fee, payment plans…), the languages it speaks, the legal software its pages use (Clio, MyCase, LawPay, Calendly…)

Every field, with an example, is listed in the Output section below. The columns of the options you switch on are null while an option is off.

✅ Why use Google Maps Lawyers Scraper?

• 🎯 Made for lawyers: practice areas are a list to tick, each one is searched as <area> in <city>; places that are not law firms (notaries, process servers, courts) are dropped by default.
• 🚀 Past Google's cap: Google Maps stops at about 120 firms per search. With Go past Google's 120-results cap, a US city is also searched ZIP code by ZIP code, around the centre of the firms found (613 firms instead of 87 for divorce lawyers in Austin, in our test of 11/10, with the 30 ZIP codes the Actor picks).
• 🧩 Nothing missed, nothing twice: every firm has its Google place ID, a firm found by several searches is saved — and charged — once.
• 🗂️ Several searches in one run: areas × cities, with a cap per search so that one big city cannot eat the whole budget.
• 🔔 Monitoring built in: tick Only new firms, schedule the Actor, and each run returns only the firms it never delivered before.
• 📧 E-mails and a profile from the firm's own website: Google Maps shows no e-mail. Tick the website options and each firm's website is visited once, whatever you tick, for its e-mails, its social profiles and what it says about itself (areas of law, free consultation, fees, languages, software). You pay only for the firms where something was found.
• 🏛️ Checked at the state bar: for the firms of New York, Florida and California, the Actor looks the firm up in the official register of its state and returns the attorneys confirmed as the firm's — bar number, license status, admission year. You pay only for the firms where an attorney was confirmed, and With a matched bar license only keeps no other firm.
• 🧹 Free filters: minimum rating, minimum number of reviews, phone or website required, searched city only, excluded names, firms you already have. A firm a filter drops is never charged.
• 🔌 API, scheduling, monitoring, integrations (Make, Zapier, n8n, Google Sheets…), proxy rotation and JSON/CSV/Excel export via the Apify platform.

🚀 How to scrape Google Maps for lawyers

1. Create a free Apify account.
2. Open Google Maps Lawyers Scraper, tick one or more Practice areas and type a Location (e.g. Austin, TX).
3. Or paste your own Google Maps URLs into Google Maps search URLs: searches, or the URL of an opened firm.
4. Set Max law firms (100 by default, 0 = no limit) — and Max firms per search when you run several searches — then click Start.
5. Download the dataset in JSON, CSV, Excel or via API.

💰 How much does it cost to scrape Google Maps?

This Actor uses pay per event pricing: $3.49 per 1,000 law firms ($1.19 on the Gold plan), plus $0.01 per run start. Each option is its own line, charged only for a firm where it found something:

What you pay for	Free plan	Bronze	Silver	Gold
Law firm saved (result)	$3.49 per 1,000	$2.49	$1.69	$1.19
Google Maps page of the firm: description, reviews per star (place-details-scraped, option)	$1.79 per 1,000	$1.78	$1.29	$0.79
Review delivered (review-scraped, option, 8 per firm at most)	$0.45 per 1,000	$0.44	$0.29	$0.19
E-mail found on the firm's website (email-enriched, option)	$1.69 per 1,000	$1.29	$1.19	$0.79
Social profiles found on the firm's website (social-enriched, option)	$1.79 per 1,000	$1.78	$1.29	$0.89
Website profile: areas of law, fees, languages, software (website-insights, option)	$1.49 per 1,000	$1.48	$1.47	$1.46
Attorney confirmed at the state bar, NY / FL / CA (bar-verified, option)	$2.99 per 1,000	$2.98	$2.97	$2.96
Run start (apify-actor-start, one at the default memory)	$0.01	$0.01	$0.01	$0.01

Examples on the Gold plan:

• 1,000 divorce lawyers in Texas cities: $1.19 + $0.01 = $1.20 ($3.50 without a subscription).
• 1,000 firms with E-mails ticked, 600 of them getting an e-mail: $1.19 + 600 × $0.00079 + $0.01 = $1.67 ($4.51 without a subscription).

In detail: you pay for each firm saved (event result), plus a small fee when a run starts. The options that open the Google Maps page of each firm add their own events: place-details-scraped once for a firm whose description or star breakdown was found, and review-scraped for each review delivered. The options that read the firm's website add theirs: email-enriched once for a firm where at least one e-mail was found, social-enriched once for a firm where at least one social profile was found, and website-insights once for a firm whose website gave something of its profile. A firm whose website gave nothing, or could not be read, is charged for none of them. The state bar option adds bar-verified once for a firm where at least one attorney was confirmed in the register; a firm in another state, a firm with no attorney confirmed and a firm whose register could not answer are not charged. The price of each event is shown on the Actor page. Filters are free: a firm a filter drops is not charged, including with With e-mail only. Platform usage (compute, proxy) is included in the price.

⚙️ Input

{
    "practiceAreas": ["divorce lawyer", "personal injury lawyer"],
    "location": "Austin, TX",
    "maxItems": 200
}

Several cities, a cap per search, only the firms you have never received, only well-rated ones:

{
    "practiceAreas": ["dui lawyer"],
    "locations": ["Houston, TX", "Dallas, TX", "Miami, FL"],
    "maxItemsPerQuery": 100,
    "minRating": 4.5,
    "minReviewCount": 20,
    "onlyNew": true,
    "stateKey": "dui-texas-florida"
}

Or with your own Google Maps URLs, and the Google Maps page of each firm (description, stars, reviews):

{
    "startUrls": [
        { "url": "https://www.google.com/maps/search/divorce+lawyer+in+Austin,+TX" },
        { "url": "https://www.google.com/maps/place/?q=place_id:ChIJFVwD3960RIYRDCDhc0-rbd4" }
    ],
    "includePlaceDetails": true,
    "includeReviews": true,
    "maxItems": 50
}

Or the e-mails and social profiles of the firms, keeping only the firms where an e-mail was found:

{
    "practiceAreas": ["personal injury lawyer"],
    "location": "Houston, TX",
    "maxItems": 200,
    "enrichEmails": true,
    "enrichSocials": true,
    "requireEmail": true
}

Or the attorneys of the firms at their state bar, keeping only the firms where one was confirmed (New York, Florida and California):

{
    "practiceAreas": ["personal injury lawyer"],
    "locations": ["Brooklyn, NY", "Miami, FL", "Los Angeles, CA"],
    "maxItems": 200,
    "verifyBarLicense": true,
    "requireBarMatch": true
}

Field	Notes
practiceAreas	Areas of law to search, ticked in a list: divorce lawyer, dui lawyer, immigration attorney… Each one is searched as <area> in <location>.
query, searchQueries	Your own Google Maps search, as you would type it: employment attorney. Write {location} where the place goes, or leave it out and the place is added after in. Every area and term is searched in every location.
location, locations	City, state, ZIP code or country: Austin, TX, 90210. locations adds more places (max 500 searches per run).
startUrls	Google Maps search URLs, or the URL of an opened firm: https://www.google.com/maps/search/divorce+lawyer+in+Austin, https://www.google.com/maps/place/?q=place_id:ChIJFVwD3960RIYRDCDhc0-rbd4. A search URL copied with the map position (https://www.google.com/maps/search/divorce+lawyer/@30.2672,-97.7431,12z) is searched around that point (the @lat,lng,zoom part). When set, the search fields are ignored.
deepSearch	Go past Google's cap: a US city is also searched ZIP code by ZIP code. On by default; it stops as soon as the cap of firms is reached.
maxItems	Stop after this many firms for the whole run (0 = unlimited).
maxItemsPerQuery	Cap for EACH search (area × location, or search URL). 0 = no per-search cap.
language	The language of Google's categories and labels: fr, es, de… Names and addresses stay as listed.
countryCode	The country that helps Google with an ambiguous place name: us, gb, ca.
includePlaceDetails, includeReviews	Open the Google Maps page of each firm for its description and star breakdown, and for up to 8 of its latest reviews. Off by default: each is an option with its own price.
enrichEmails	Visit each firm's own website (its home page, and the contact, about or legal pages it links to: 3 pages at most) and add the e-mails published there to emails (email = the best one, emailSource = the page). Only for firms with a website of their own (a Facebook page is not one). Off by default; charged once per firm where an e-mail was found.
enrichSocials	Add the firm's Facebook, Instagram, LinkedIn, X, YouTube and TikTok links found on those same pages (socialLinks, and one column per network). No page more than enrichEmails reads; charged once per firm where a profile was found.
websiteInsights	From those same pages, add the areas of law the firm lists (websitePracticeAreas), whether it offers a free consultation, how it is paid (feeTypes: contingency, flat_fee, hourly, payment_plans, no_win_no_fee), the languages it speaks and the legal software its pages use. Charged once per firm where something was found.
verifyBarLicense	For the firms in New York, Florida and California, look the firm up in the official register of its state bar and add the attorneys confirmed as the firm's: barStatus, barState, barMatchMethod, barAttorneys (up to 25: name, bar number, license status, admission year, law school, link) and barAttorneyCount. An attorney is the firm's only when his phone number or office address is the firm's: a name alone is never enough. Firms in other states are marked unsupported in barStatus. Off by default; charged once per firm where at least one attorney was confirmed.
minRating	Drop the firms rated below this (4.5). Firms without a rating are dropped. 0 = no minimum.
minReviewCount	Drop the firms with fewer Google reviews (20). A firm Google rates without giving its number of reviews is kept (see the limits below). 0 = no minimum.
requirePhone, requireWebsite	Drop the firms without a phone number, or without a website.
requireEmail	Keep only the firms where an e-mail was found on their website. It switches enrichEmails on, so the e-mails of the firms you keep are charged like that option; a firm it drops is not charged at all.
requireBarMatch	Keep only the firms where an attorney was confirmed at the state bar. It switches verifyBarLicense on, so the attorneys of the firms you keep are charged like that option; firms outside New York, Florida and California, and firms whose register could not answer, are dropped, and a firm it drops is not charged at all.
legalOnly, skipClosedPlaces, sameCityOnly	On by default for the first two: keep law firms and attorneys only, and drop the firms Google marks closed. sameCityOnly drops the firms outside the searched city (or ZIP code); it filters nothing for a state, province or country.
excludeKeywords, excludeMapsUrls	Drop the firms whose name or category contains a word (Morgan & Morgan), or that you already collected: Google Maps URLs, place IDs or CIDs of an earlier export (up to 10 000).
onlyNew, stateKey, resetState	Monitoring: only the firms never delivered under this memory key (miami-pi); resetState forgets the memory.
Advanced	proxyConfiguration (Apify proxy by default, included in the price; the residential proxy is not available), maxConcurrency, maxRequestsPerMinute, minRequestIntervalMs, maxRequestRetries, debugLog.

📦 Output

A firm (shortened: the columns of the options that are off are null and left out here):

{
    "id": "ChIJFVwD3960RIYRDCDhc0-rbd4",
    "url": "https://www.google.com/maps/place/?q=place_id:ChIJFVwD3960RIYRDCDhc0-rbd4",
    "cid": "10539639380085273922",
    "featureId": "0x8644b4dedf035c15:0xde6dab4f73e1200c",
    "name": "Thompson Law Austin Divorce Attorneys",
    "category": "Divorce lawyer",
    "categories": ["Divorce lawyer", "Divorce service", "Family law attorney"],
    "practiceAreas": ["Divorce", "Family law"],
    "address": "3601 S Congress Ave Ste B200, Austin, TX 78704",
    "street": "3601 S Congress Ave Ste B200",
    "city": "Austin",
    "state": "TX",
    "postalCode": "78704",
    "countryCode": "US",
    "neighborhood": "Greater South River City",
    "latitude": 30.2272618,
    "longitude": -97.7593903,
    "plusCode": "66GR+W6",
    "timezone": "America/Chicago",
    "phone": "(737) 299-7508",
    "phoneInternational": "+17372997508",
    "website": "https://austintexaslaw.com/",
    "websiteDomain": "austintexaslaw.com",
    "rating": 4.9,
    "reviewCount": 84,
    "reviewsUrl": "https://search.google.com/local/reviews?placeid=ChIJFVwD3960RIYRDCDhc0-rbd4",
    "open24Hours": true,
    "attributes": ["Online appointments", "Onsite services"],
    "onlineAppointments": true,
    "bookingUrl": "https://austintexaslaw.com/contact",
    "claimed": null,
    "ownerName": "Thompson Law Austin Divorce Attorneys",
    "closed": null,
    "searchQuery": "divorce lawyer in Austin, TX",
    "searchLocation": "Austin, TX",
    "rank": 1,
    "scrapedAt": "2026-10-11T12:00:00.000Z"
}

You can download the dataset in various formats such as JSON, HTML, CSV or Excel.

All 65 fields

Fields	What you get
id, url, featureId, cid, kgmid	the Google place ID (the key of the firm), its Google Maps link, Google's other ids for the same place
name, category, categories, practiceAreas	Thompson Law Austin Divorce Attorneys, Divorce lawyer, every Google category, the areas of law read from them
address, street, city, state, postalCode, countryCode, neighborhood	the address as Google Maps shows it, and its parts
latitude, longitude, plusCode, timezone	30.2272618, -97.7593903, 66GR+W6, America/Chicago
phone, phoneInternational	(737) 299-7508, +17372997508
website, websiteDomain, bookingUrl	the firm's website without tracking, its domain, the appointment or contact link Google gives
rating, reviewCount, reviewsUrl, reviewSnippet	4.9, 84, the page with all the reviews, a quote from a review
description, reviewDistribution, reviews	option (Google Maps page): the firm's own description, the number of reviews per star, up to 8 reviews (reviewId, reviewerName, reviewerUrl, reviewerReviewCount, isLocalGuide, rating, text, publishedAt, publishedAtText, likesCount, imageUrls, ownerResponse, ownerResponseAt)
openingHours, open24Hours, additionalOpeningHours	one line per day, true when open 24 hours every day, a second set of hours (online service)
attributes, onlineAppointments, claimed, ownerName, imageUrl, closed	Google's features of the place, the account that manages it, the main photo, permanently for a place Google marks closed
searchQuery, searchLocation, rank	the search that found the firm, its place (or ZIP code), the position in that search
emails, email, emailSource	option (enrichEmails): the e-mails found on the firm's website, the best one first (an address on the firm's own domain before any other), the page where the first was found — ["info@austintexaslaw.com"], info@austintexaslaw.com, https://austintexaslaw.com/contact
socialLinks, facebook, instagram, linkedin, twitter, youtube, tiktok	option (enrichSocials): the profile links found on the website, and the first link of each network (null when the firm has none there)
websitePracticeAreas, freeConsultation, feeTypes, languages, legalSoftware	option (websiteInsights): the areas of law the website lists, true when it offers a free consultation, contingency / flat_fee / hourly / payment_plans / no_win_no_fee when it says so, the languages it says are spoken, the tools its pages use — ["Divorce", "Child custody"], true, ["flat_fee"], ["Spanish"], ["LawPay", "Calendly"]
barStatus, barState, barMatchMethod, barAttorneys, barAttorneyCount	option (verifyBarLicense): active / inactive / not_found / unsupported_state / unavailable, the register looked up (NY, FL, CA), how the attorneys were found (phone, firm_name, attorney_name), the attorneys confirmed as the firm's and their number — "active", "NY", "phone", [{ "name": "Yehoshua Gelbstein", "barNumber": "4553004", "status": "Currently registered", "admittedYear": 2008, "lawSchool": "Brooklyn Law School", "profileUrl": "https://data.ny.gov/resource/eqw2-r5nb.json?registration_number=4553004" }], 1
scrapedAt	ISO timestamp of the run

💡 Tips

How to get more results

Leave Go past Google's 120-results cap on and set Max law firms to 0 for a big city: the city is searched ZIP code by ZIP code, nearest the centre first. For another country, list several towns in More locations.

How to reduce costs

The price is per firm, so the levers are maxItems, maxItemsPerQuery, the filters (they are free, a dropped firm costs nothing), onlyNew for recurring runs (you never pay twice for the same firm) and excludeMapsUrls for firms you already hold. Leave the Google Maps page options and the website options off when you only need what Google Maps gives; tick only the website options you use (each is charged on its own, and a firm's website is visited once however many you tick). The state bar check is worth ticking only for the firms of New York, Florida and California.

Several searches in one run

Tick several practice areas and fill More locations: the Actor runs one search per area × location (3 areas × 4 cities = 12 searches, up to 500 per run). A firm found by several searches is saved — and charged — once, with the first search that found it in searchQuery. Set maxItemsPerQuery to give every search its own cap: without it the first searches can use up the whole maxItems budget.

Monitoring: only the new firms

Tick Only new firms (onlyNew) and schedule the Actor. The first run returns everything; each later run skips the firms already delivered: they are not saved and not charged. The memory lives in a named key-value store of your account (google-maps-lawyers-scraper-seen, up to 150,000 firms per key) and is only updated with firms that really reached the dataset, so a failed run never hides anything. Give each schedule its own stateKey (two schedules sharing a key would hide each other's firms), and tick resetState once to start over.

Places that are not in the searched city

Google often widens a search to the towns around. Tick sameCityOnly to keep only the firms of the searched city or ZIP code; the column searchLocation tells which search found each firm. A place that is not a city (a state such as TX or Texas, a province, a country) names nothing to keep a firm in: nothing is dropped for it, and the log says so once. With deepSearch, a firm found through a ZIP code is judged against the place you typed, not against that ZIP code.

🔌 Integrations and API

Call the Actor via the Apify API, the JavaScript or Python clients, or connect it with integrations and webhooks (Make, Zapier, n8n, Google Sheets, Slack, Airtable…). The dataset can be fetched as JSON or CSV from any tool.

🤖 Use with AI agents (MCP)

AI agents (Claude, ChatGPT, Cursor…) can find and run this Actor through the Apify MCP server, billed to their Apify account like any run. It returns one item per law firm of Google Maps. Actor id: nice_dev/google-maps-lawyers-scraper; MCP server with this Actor only: https://mcp.apify.com/?tools=fetch-actor-details,nice_dev/google-maps-lawyers-scraper.

Smallest input, for a cheap first call:

{
    "practiceAreas": ["divorce lawyer"],
    "location": "Austin, TX",
    "maxItems": 10
}

Key output fields: name, phone, website, address, rating, reviewCount, practiceAreas and url. The cost per firm and per run start is on the Actor page. Cap each call with maxItems and, through the API, with the run option maxTotalChargeUsd.

❓ FAQ

Is it legal to scrape Google Maps?

The Actor only reads what Google Maps shows publicly to any anonymous visitor. It logs in to nothing. Results can contain personal data (the name of a sole practitioner, a phone number), which is protected by GDPR: do not store it without a legitimate reason. You are responsible for using the data in compliance with Google's Terms of Service and applicable law. This Actor is not affiliated with Google.

Where do the e-mail addresses come from, and can I use them?

With the website options on, the Actor reads the pages each firm publishes on its own website (home page, contact page, legal notice) and returns the business contact addresses, social profiles and statements shown there — what any visitor sees. It does not log in, guess addresses, fill in contact forms or bypass any protection. An address of a web agency or of a font credited in the footer is not returned as the firm's. Some addresses are personal data (firstname.lastname@firm.com): you are responsible for having a lawful basis before using them, for informing the people concerned and for honouring opt-outs. The rules for marketing e-mail differ by country (in the US, the CAN-SPAM Act asks for a clear sender, a postal address and a way to opt out; the GDPR needs a lawful basis in the EU and the UK), and the rules for how a law firm may advertise or contact prospective clients differ by state bar and country: check them before you write to anyone.

Where does the bar license information come from?

With Check the bar license on, the Actor looks each firm of New York, Florida and California up in the register its state publishes: the New York State Unified Court System open data, The Florida Bar and The State Bar of California. These are public registers of licensed attorneys. An attorney is returned as the firm's only when his phone number or his office address is the firm's; a name alone is never enough, so an attorney of the same name elsewhere is not returned. A firm for which no attorney is confirmed has barStatus: "not_found" — it can still be a licensed firm registered under another address or phone number, so read it as "not confirmed", not as "not licensed". A license status is the register's own wording at the time of the run: check it again before you rely on it. The result is not legal advice and not a certification.

Does it need a login or a proxy?

No login. The proxy is included in the price: leave the default setting (the residential proxy is not available). With the state bar option, the Florida register is asked through Apify Proxy with addresses in the United States (it turns away every other address): if you switch Apify Proxy off, or use proxy URLs of your own, Florida firms are asked from the machine the run is on and come back unavailable unless that machine is in the United States. A request the site turns away is retried at once on a new proxy session, up to 10 times on top of the retries (without a proxy, after a pause of 5 seconds, doubled at each retry up to 150 seconds).

Why 65 fields and so many null?

Google Maps gives what each firm filled in: a firm without a website has website: null. The columns of the options (the Google Maps page of the firm, the firm's website, the state bar) are null while the option is off, and an empty list or object when it is on and found nothing — null again when it is on but the page could not be read whole (see the known limitations). freeConsultation is true when the website offers one, false when its pages say nothing of it, and null when the option is off or no page of the website could be read.

Is the data safe to open in Excel or to show on a web page?

Names, categories and reviews are the firms' and the reviewers' own words, copied as they are. A text can begin with -, +, = or @: Excel and Google Sheets may read such a cell of a CSV file as a formula or as a number. The Actor leaves the text as it is, so that the JSON and the API give the real value: when you open a CSV, import these columns as text. On a web page, escape every field like any text written by a stranger. Every URL field holds an http(s) URL or null.

Known limitations

• Google Maps shows about 120 firms for one search; deepSearch goes past it for US places typed as a city. A search pasted as a URL, a ZIP code typed as location and places outside the US are not split.
• A firm Google marks as temporarily closed is not told apart: only a place Google marks permanently closed has closed: "permanently".
• claimed is false for a listing nobody claimed and null otherwise; the column does not say a listing is claimed.
• A place URL must carry the Google place ID (?q=place_id:ChIJ...) or be the address bar of an opened place; a name alone or a ?cid= link is refused.
• Sponsored results are kept, with fewer fields: no rank, no website (Google gives the advertiser's domain only), the address written in full words (South Capital of Texas Highway).
• Google's search answer is thinner for some firms (about 1 firm in 7 on a search of Austin, other ones on the next read): beside a rating it gives no number of reviews, and only today's line of the opening hours. reviewCount is then null and openingHours empty. With the Google Maps page options (includePlaceDetails, includeReviews) the page of the firm completes them when it holds them. The page of a firm can be thin too: it is then read once more, and when it is thin again reviewDistribution and reviews are null (not known), never an empty object or list. For a few firms (4 of 20 on a search of Phoenix) the search answer names no main category: category is then the category you searched for, as Google lists it in the results; with the Google Maps page options it is the one the page of the firm shows.
• A firm read from its own page (a place pasted in startUrls) has no reviewSnippet, seldom an imageUrl and sometimes no openingHours (Google answers today's line alone on some reads, and a part of the week is not given): search results carry all three. The reviews option gives the firm's reviews either way.
• The website options give nothing for a firm with no website of its own (a Facebook page is not one), a website that cannot be reached, is built only in JavaScript, hides its addresses in images or answers a firewall's check instead of its pages: the columns are then empty and nothing is charged for that firm. Only the home page and the contact, about and legal pages it links to are read (3 pages at most), so an area of law, a fee or a language that appears elsewhere on the site is not seen. A link to the account of someone else in the text of the site (a testimonial, a partner) can be taken for the firm's profile.
• The state bar check covers New York, Florida and California, by the state of the firm's Google Maps address. New York lists the attorneys of the firm's phone number or address (200 rows read per search at most), Florida the attorneys of the first page of 50 that confirms one (up to 25 are returned, the count says how many were confirmed in what was read, a large firm may have more); for California the Actor reads the profiles of at most 10 candidates per firm. The Florida register does not list the admission year nor the law school (null). A firm that registered its attorneys under another phone number and another address than the one on Google Maps is not_found. In Florida a common last name can list hundreds of attorneys: the first 3 pages of 50 are read, and a firm not confirmed in them is unavailable, never not_found. The same in California: a search that lists more than 500 attorneys shows a sample of the register only, so a firm not confirmed by the other searches is unavailable. A register that is down or turns the Actor away, or no longer shows the status of the attorneys it lists, leaves its firms unavailable (and uncharged) — run it again later.
• onlyNew remembers firm ids, not their content: a firm whose rating changed is not returned again.
• Two runs sharing the same stateKey at the same time may both return the same new firm.

A run that reaches its timeout stops itself about 45 seconds before it: no new page is asked, what it read is saved and, with onlyNew, remembered, and the run ends Succeeded with "Stopped before the run's timeout". Resurrect it to go on from there, or give the next run a longer timeout (Run options).

A run the platform stops without warning (out of memory)

• Resurrect it: it goes on from where it stood at most a minute before the stop. What it had read since is read again, and the firms already saved are skipped: none is delivered or charged twice, and maxItems still counts them.
• With onlyNew, the memory is saved after each write, at most once every 2 seconds: resurrect the stopped run and the firms it had saved meanwhile join the memory; leave it stopped for good, and the next run may return the firms saved in the last 2 seconds once more.

Something doesn't work?

The last line of the log counts the firms saved, filtered out and no longer on Google Maps, and the requests that failed after every retry. Those requests are listed, with the reason, in the FAILED_REQUESTS record of the run's key-value store. A run that saved nothing and had failed requests fails, and its last message gives the cause.

If Google Maps changes its pages, you are told instead of paying for blank rows. If the first 20 firms read all lack their name, categories, coordinates, address or phone number — or the rating, the star breakdown or the reviews (with the options) of firms that have reviews — the run saves nothing more, stops and fails, and its last message names the missing field: at most those first firms are charged. A results page whose firms are there but can no longer be read (their name or identifier moved) is a failed request, never "no firm found". A run of fewer firms (a scheduled onlyNew run that finds a few new ones, a small Max law firms) is checked at its end, from 5 firms: its firms are already saved, and the run fails with the missing field instead of ending green.

🛟 Support

Open an issue in the Issues tab with a link to your run: the run log and the FAILED_REQUESTS record of the key-value store show exactly which URLs failed and why.