Google Maps Place ID & Business Contact API

Turn a Google Maps place ID into a complete business record. Give this Actor a place ID, a ChIJ feature ID, or a Google Maps URL, and it returns the business email, social profiles, accessibility and amenity attributes, closure status, structured address, and plus code as clean JSON.

This is a place ID lookup and a contact enrichment step in one call. It is built to run after a search, on the place IDs you already have.

What it returns

Google publishes some of this and hides the rest. The contact details are not in Google's place data at all, so this Actor reads the business website to resolve them.

Field	What you get	Where it comes from
email	Best contact address for the business	Business website
emails	Every valid address found	Business website
socialLinks	Facebook, Instagram, LinkedIn, YouTube, TikTok, X, Pinterest, Yelp, TripAdvisor profiles	Business website
socialProfiles	The same platforms as a plain comma-separated list, for spreadsheets and tables	Business website
about	Accessibility, service options, payments, planning attributes, each with a true or false flag	Google Maps
businessStatus	OPERATIONAL, CLOSED_TEMPORARILY, or CLOSED_PERMANENTLY	Google Maps
plusCode	Open Location Code, a global address that works without street addressing	Google Maps
addressComponents	Address split into parts	Google Maps
categories, primaryType	Every Google category for the business	Google Maps
phone, fax, website	Listed contact numbers and site	Google Maps
menu, hotelClass	Menu sections and lodging star rating where published	Google Maps

Social profiles and email are the two fields most often missing from business data sets, because neither appears in Google's place listing. Reading the website is the only way to get them, and this Actor does it in the same pass.

Fields with no value are left out of the record rather than returned empty, so the fill percentage shown on the Output tab is the real hit rate rather than a column of blanks.

How to get started

1. Open the Google Maps Place ID & Business Contact API on Apify Store.
2. Paste one or more place IDs, feature IDs, or Google Maps URLs into Place IDs.
3. Leave Resolve contact details on to get email and social profiles.
4. Run it. One record comes back per place.

Input accepts all three of these, so you rarely need to convert anything:

0x54ae55e377fa4a87:0x91e7fe3019801009
ChIJrTLr-GyuEmsRBfy61i59si0
https://www.google.com/maps/place/Northwest+Dental+Center/@43.62,-116.28,17z/data=!4m2!3m1!1s0x54ae55e377fa4a87:0x91e7fe3019801009

Example output

{
  "result_type": "place",
  "placeId": "0x54ae55e377fa4a87:0x91e7fe3019801009",
  "name": "Northwest Dental Center",
  "email": "office@nwdentalcenter.com",
  "emails": ["office@nwdentalcenter.com"],
  "socialLinks": [
    { "platform": "facebook", "url": "https://www.facebook.com/nwdentalcenter" },
    { "platform": "instagram", "url": "https://www.instagram.com/nwdentalcenter" }
  ],
  "businessStatus": "OPERATIONAL",
  "plusCode": "85M5JPG7+QX",
  "address": "8300 W Northview St, Boise, ID 83704",
  "addressComponents": ["8300 W Northview St", "Boise, ID 83704"],
  "categories": ["Dentist", "Cosmetic dentist", "Dental clinic"],
  "primaryType": "Dentist",
  "phone": "(208) 314-4416",
  "website": "https://www.nwdentalcenter.com/",
  "about": [
    {
      "group": "Accessibility",
      "attributes": [
        { "label": "Wheelchair accessible entrance", "present": true },
        { "label": "Wheelchair accessible parking lot", "present": true }
      ]
    }
  ],
  "socialProfiles": "facebook, instagram",
  "contactPagesCrawled": 1
}

How to find a Google place ID

A place ID is the stable identifier Google gives every location. It does not change when a business is renamed or moves its listing, which makes it the right key to store in your own database.

Three ways to get one:

• Open the place on Google Maps and copy the URL. The !1s segment holds the ID, and this Actor accepts the whole URL, so no editing is needed.
• Use Google's own Place ID Finder.
• Run the Google Maps Places API to search an area, then feed the resulting IDs into this Actor.

Applications

• Lead lists with reachable contacts. Search a category and location, then resolve the results here to attach an email and social profiles to every business.
• Keeping a directory honest. Re-run monthly and watch businessStatus to catch places that closed permanently, so you stop showing listings that no longer exist.
• Accessibility and amenity filtering. The about groups carry wheelchair access, payment methods, and service options as explicit true or false flags, which is what you need to filter a directory by accessibility.
• Global addressing. plusCode gives a precise location where street addressing is unreliable or missing.
• Enriching a CRM. Store the place ID once, then re-resolve on a schedule to keep contact details current.

Integrations: chain it with the rest of the toolkit

Search, then resolve

Run the Google Maps Places API to find businesses by keyword and location, then pass each placeId into this Actor. The search step is cheap per place and gives you the listing. This step adds the contact details and attributes the listing does not carry. You only pay for enrichment on the places you actually want.

Related Actors

• Google Maps Places API to find places by keyword and location.
• Google Maps Photos API for the full image gallery of a place.
• Google Maps Contributor Reviews API for a reviewer's history.
• Google Local API for the local pack inside Google Search.

Tasks and schedules

Save a run configuration as a Task, then attach a schedule to re-resolve a list of place IDs weekly or monthly. Contact details and closure status both drift, so a recurring run is how a directory stays accurate.

🔌 Use this API from Claude (MCP)

This Actor is compatible with the Model Context Protocol (MCP), so AI agents can call it as a tool. Add it through the hosted Apify MCP server using this Actor-specific URL:

https://mcp.apify.com/?tools=actors,docs,johnvc/google-maps-place-id-contact-api

If you run agents from Claude Code (free trial) or Claude Cowork (free trial), add the Apify MCP server and ask it to "resolve this Google Maps link and tell me the contact email and whether the place is still open."

Apify MCP integration docs: https://docs.apify.com/platform/integrations/mcp

💸 Pay per run with crypto (x402)

The Google Maps Place ID & Business Contact API supports agentic payments via the x402 protocol. AI agents and MCP clients can pay for runs in USDC (on Base) with no Apify account or API token needed: point your agent at the Apify MCP server and it can discover, pay for, and run this Actor autonomously. Read the Apify x402 announcement for details.

Pricing

You pay per record, not per run and not per month. Two events:

• Place resolved, charged once for each business record returned.
• Contacts resolved, charged once per record when the business website is successfully read. It is not charged when contact resolution is turned off, when the place has no website, or when the website could not be reached, so a site that is down costs you nothing.

Turning off Resolve contact details means you are only charged the first event, which is the cheaper way to pull attributes and closure status in bulk.

FAQ

How do I find a Google place ID? Open the place on Google Maps and copy the URL. This Actor accepts the full URL, so you do not need to extract the ID yourself. You can also get IDs in bulk from the Google Maps Places API.

How do I get a place ID for my own business? Search for your business on Google Maps, open its listing, and copy the URL from the address bar. Paste that URL straight into this Actor.

Does a place ID change? It is stable in normal use, which is why it is a good key to store. Google can retire an ID when listings are merged, so re-resolving on a schedule is worthwhile for a long-lived database.

Why is the email not always found? The address is read from the business website, so it can only be found if the business publishes one. Some businesses use a contact form instead of an address, and some have no website. When the homepage has no address, this Actor follows likely contact pages before giving up, which finds a large share of the addresses a homepage-only read would miss.

Where do the social profiles come from? The business website. Google's place data does not contain social profile links at all, so there is no way to read them from the listing itself. Share buttons and platform homepages are filtered out, so what comes back are the business's own profiles.

Can I get place attributes without reading the website? Yes. Turn off Resolve contact details. You still get amenity attributes, closure status, address, plus code, and categories, and you are not charged the contact event.

How do I find permanently closed businesses? Check businessStatus on each record. Google flags only closed places, so anything unflagged is reported as OPERATIONAL.

Does this return reviews or photos? No. Reviews and photos are handled by separate Actors so you are not charged for data you did not ask for. See Google Maps Photos API for imagery.

Can AI agents call this directly? Yes. It is MCP compatible, and it can be paid for in USDC via x402 with no Apify account. See the MCP and x402 sections above.

🌐 About Alpha OSINT

This Actor is part of Alpha OSINT, toolset of financial and operations data sources and APIs. For support or requests for this actor, please start a ticket directly on our support page.

Last Updated: 2026.08.23