{"uid":"cap_K4ZIDF8T00rC5sO15lttw","slug":"agents-openwebninja-com-local-business-details-with-emails-social-7528ce2b","name":"Local Business Details with Emails & Social Contacts","description":"Get full business details including emails and social contacts.  \n  Supports batching of up to 20 Business Ids.","url":"https://agents.openwebninja.com/local-business-data/business-details?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["business_id"],"properties":{"fields":{"type":"string","description":"A comma separated list of business fields to include in the response (field projection).  \n  By default all fields are returned."},"region":{"type":"string","default":"us","description":"Query Google Maps from a particular region or country. \n  For a list of supported region/country codes see *https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes (Alpha-2 code)*."},"language":{"type":"string","default":"eu","description":"Set the language of the results.   \n  For a list of supported language codes see *https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes*."},"business_id":{"type":"string","example":"0x880fd393d427a591:0x8cba02d713a995ed","description":"Unique Business Id. Accepts `google_id` / `business_id` or `place_id`.  \n\n  **Examples:**  \n  `0x880fd393d427a591:0x8cba02d713a995ed`  \n  `ChIJkaUn1JPTD4gR7ZWpE9cCuow`  \n  \n  In addition, batching of up to 20 Business Ids is supported in a single request using a comma separated list *(e.g. business_id=id1,id2)*."},"coordinates":{"type":"string","description":"Geographic coordinates of the location from which the query is applied - recommended to use so that results are biased towards this location.  \n  Defaults to some central location in the region (see the region parameter)."},"extract_share_link":{"type":"boolean","default":false,"description":"Whether to extract place's share link for the business.  \n  In case true, businesses will be enriched with a share_link field containing a shortened Google URL for sharing *(e.g. https://goo.gl/maps/oxndE8SVaNU5CV6p6)*."},"extract_emails_and_contacts":{"type":"boolean","default":true,"description":"Whether to extract emails, contacts and social profiles for the business.  \n  In case true, businesses will be enriched with a emails_and_contacts field, potentially containing emails, phones, Facebook, LinkedIn, Instagram and other social profiles."}}},"responseSchema":{"type":"object","required":["status","request_id","parameters","data"],"properties":{"data":{"type":"array","items":{"type":"object","required":["business_id","google_id","name","business_status"],"properties":{"cid":{"type":"string","nullable":true,"description":"Google CID (Customer ID) of the business."},"tld":{"type":"string","nullable":true,"description":"Top-level domain of the business website."},"city":{"type":"string","nullable":true,"description":"City of the business location."},"name":{"type":"string","description":"Display name of the business."},"type":{"type":"string","nullable":true,"description":"Primary business category as labelled by Google Maps."},"about":{"type":"object","nullable":true,"properties":{"details":{"type":"object","nullable":true,"description":"Map of attribute groups (e.g. Amenities, Crowd, Service options) to attribute name -> boolean.","additionalProperties":{"type":"object","additionalProperties":{"type":"boolean"}}},"summary":{"type":"string","nullable":true,"description":"Free-text description of the business."}},"description":"Free-form summary and a structured details map of business attributes."},"state":{"type":"string","nullable":true,"description":"State / region of the business location."},"rating":{"type":"number","nullable":true,"description":"Average review rating (1-5) on Google Maps."},"address":{"type":"string","nullable":true,"description":"Street address line of the business."},"country":{"type":"string","nullable":true,"description":"ISO 3166-1 alpha-2 country code of the business location."},"website":{"type":"string","nullable":true,"description":"Business website URL."},"zipcode":{"type":"string","nullable":true,"description":"ZIP / postal code of the business location."},"district":{"type":"string","nullable":true,"description":"District or neighbourhood of the business location."},"latitude":{"type":"number","description":"Latitude of the business location."},"owner_id":{"type":"string","nullable":true,"description":"ID of the Google Maps contributor account that owns this listing."},"place_id":{"type":"string","description":"Google Maps Place ID."},"subtypes":{"type":"array","items":{"type":"string"},"nullable":true,"description":"List of additional business categories."},"timezone":{"type":"string","nullable":true,"description":"IANA timezone of the business location."},"verified":{"type":"boolean","description":"Whether the business is verified by Google."},"directory":{"type":"array","items":{"type":"object","additionalProperties":true},"nullable":true,"description":"List of businesses located in the same building / directory (e.g. mall, plaza). Conditional."},"google_id":{"type":"string","description":"Google's internal hexadecimal ID of the business."},"longitude":{"type":"number","description":"Longitude of the business location."},"menu_link":{"type":"string","nullable":true,"description":"URL of the business menu (when published)."},"google_mid":{"type":"string","nullable":true,"description":"Google Knowledge Graph machine ID."},"located_in":{"type":"object","nullable":true,"properties":{"name":{"type":"string","description":"Name of the parent place."},"google_id":{"type":"string","description":"Google ID of the parent place."}},"description":"Parent place this business is located in (e.g. mall) when applicable."},"order_link":{"type":"string","nullable":true,"description":"URL to place an order (when published)."},"owner_link":{"type":"string","nullable":true,"description":"Link to the owner profile on Google Maps."},"owner_name":{"type":"string","nullable":true,"description":"Display name of the owner profile."},"place_link":{"type":"string","description":"Google Maps URL for the business."},"posts_link":{"type":"string","nullable":true,"description":"URL to the full list of owner posts on Google Maps."},"share_link":{"type":"string","nullable":true,"description":"Shortened Google Maps share URL for the business. Returned when extract_share_link=true."},"business_id":{"type":"string","description":"Unique Google identifier of the business. Same value as google_id."},"hotel_stars":{"type":"integer","nullable":true,"description":"Hotel-only: star rating (1-5). Present only for hotels."},"photo_count":{"type":"integer","nullable":true,"description":"Total number of photos available for the business."},"price_level":{"type":"string","nullable":true,"description":"Price level as shown on Google Maps (e.g. '$', '$$')."},"booking_link":{"type":"string","nullable":true,"description":"URL to book a service or appointment."},"full_address":{"type":"string","description":"Full formatted address including business name."},"opening_date":{"type":"string","nullable":true,"description":"Date the business opened (when published by Google)."},"phone_number":{"type":"string","nullable":true,"description":"Business phone number in E.164 format when available."},"posts_sample":{"type":"array","items":{"type":"object","properties":{"post_id":{"type":"string","description":"Unique Google identifier of the owner post."},"post_link":{"type":"string","nullable":true,"description":"Direct URL to the post on Google."},"post_text":{"type":"string","nullable":true,"description":"Text content of the post."},"post_links":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","description":"Target URL of the link."},"caption":{"type":"string","nullable":true,"description":"Caption of the link as shown on the post."}}},"nullable":true,"description":"Outbound links attached to the post."},"post_photos":{"type":"array","items":{"type":"string"},"nullable":true,"description":"URLs of photos attached to the post."},"post_timestamp":{"type":"integer","nullable":true,"description":"Unix epoch seconds matching post_datetime_utc."},"post_datetime_utc":{"type":"string","nullable":true,"description":"ISO 8601 UTC datetime when the post was published."}}},"nullable":true,"description":"Sample of the most recent owner posts. Present in /business-details and /business-details-plus."},"review_count":{"type":"integer","nullable":true,"description":"Total number of Google Maps reviews on the business."},"reviews_link":{"type":"string","nullable":true,"description":"URL to view reviews on Google Maps."},"photos_sample":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"Media type. Values: photo, video, street_view."},"latitude":{"type":"number","nullable":true,"description":"Latitude where the photo was taken (when known)."},"photo_id":{"type":"string","description":"Google Maps photo ID."},"longitude":{"type":"number","nullable":true,"description":"Longitude where the photo was taken (when known)."},"photo_url":{"type":"string","description":"URL of the photo (lower-resolution)."},"photo_timestamp":{"type":"integer","nullable":true,"description":"Unix epoch seconds matching photo_datetime_utc."},"photo_url_large":{"type":"string","nullable":true,"description":"URL of the photo at a larger resolution."},"photo_datetime_utc":{"type":"string","nullable":true,"description":"Original publication datetime of the photo in ISO 8601 UTC."},"video_thumbnail_url":{"type":"string","nullable":true,"description":"Thumbnail URL when the media is a video; null for still photos."}}},"nullable":true,"description":"Up to ~10 representative photos for the business."},"subtype_gcids":{"type":"array","items":{"type":"string"},"nullable":true,"description":"Internal Google category IDs corresponding to the primary type and subtypes."},"working_hours":{"type":"object","nullable":true,"description":"Working hours map keyed by day of the week. Each value is an array of time-range strings; empty object when not published.","additionalProperties":{"type":"array","items":{"type":"string"}}},"opening_status":{"type":"string","nullable":true,"description":"Current opening status string as shown on Google Maps (e.g. 'Open', 'Closed', 'Open 24 hours')."},"reviews_sample":{"type":"array","items":{"type":"object","properties":{"rating":{"type":"integer","description":"Star rating given in the review (1-5)."},"author_id":{"type":"string","nullable":true,"description":"Google Maps contributor ID of the review author."},"review_id":{"type":"string","description":"Unique Google identifier of the review."},"like_count":{"type":"integer","nullable":true,"description":"Number of likes the review received."},"author_link":{"type":"string","nullable":true,"description":"URL to the author's Google Maps profile."},"author_name":{"type":"string","nullable":true,"description":"Display name of the review author."},"review_form":{"type":"object","nullable":true,"description":"Structured questions the author answered (e.g. 'What kind of trip was it?').","additionalProperties":{"type":"string"}},"review_link":{"type":"string","nullable":true,"description":"Direct Google Maps URL to the review."},"review_text":{"type":"string","nullable":true,"description":"Full text content of the review."},"review_photos":{"type":"array","items":{"type":"string"},"nullable":true,"description":"URLs of photos attached to the review."},"review_source":{"type":"string","nullable":true,"description":"Platform the review originates from (e.g. 'Google', 'Tripadvisor')."},"review_language":{"type":"string","nullable":true,"description":"ISO 639 language code of the review text."},"service_quality":{"type":"string","nullable":true,"description":"Optional service-quality tag the author selected."},"author_photo_url":{"type":"string","nullable":true,"description":"URL of the author's profile photo."},"review_timestamp":{"type":"integer","nullable":true,"description":"Unix epoch seconds matching review_datetime_utc."},"author_review_count":{"type":"integer","nullable":true,"description":"Number of reviews this author has posted."},"author_reviews_link":{"type":"string","nullable":true,"description":"URL to all reviews by this author."},"owner_response_text":{"type":"string","nullable":true,"description":"Text of the business owner's response."},"review_datetime_utc":{"type":"string","nullable":true,"description":"ISO 8601 UTC datetime when the review was posted."},"hotel_rating_breakdown":{"type":"object","nullable":true,"description":"Hotel-only: per-aspect ratings (Rooms, Service, Location, etc.).","additionalProperties":{"type":"integer"}},"owner_response_language":{"type":"string","nullable":true,"description":"ISO 639 language code of the owner response."},"author_local_guide_level":{"type":"integer","nullable":true,"description":"Google Local Guide level (1-10) of the author."},"owner_response_timestamp":{"type":"integer","nullable":true,"description":"Unix epoch seconds matching owner_response_datetime_utc."},"owner_response_datetime_utc":{"type":"string","nullable":true,"description":"ISO 8601 UTC datetime when the business owner responded."}}},"nullable":true,"description":"Sample of recent reviews. Present in /business-details and /business-details-plus."},"street_address":{"type":"string","nullable":true,"description":"Street name and number portion of the address."},"business_status":{"type":"string","description":"Operational status. Values: OPEN, CLOSED_TEMPORARILY, CLOSED_PERMANENTLY."},"hotel_amenities":{"type":"object","nullable":true,"description":"Hotel-only: map of amenity name to availability (true/false). Present only for hotels.","additionalProperties":{"type":"boolean"}},"global_plus_code":{"type":"string","nullable":true,"description":"Global Open Location Code (Plus Code) for the business location."},"business_services":{"type":"object","nullable":true,"description":"Map of service category -> list of services offered (when published by the owner).","additionalProperties":{"type":"array","items":{"type":"string"}}},"reservations_link":{"type":"string","nullable":true,"description":"URL to make a reservation."},"compound_plus_code":{"type":"string","nullable":true,"description":"Compound (short) Plus Code with a nearby locality."},"reviews_per_rating":{"type":"object","nullable":true,"properties":{"1":{"type":"integer","description":"Number of 1-star reviews."},"2":{"type":"integer","description":"Number of 2-star reviews."},"3":{"type":"integer","description":"Number of 3-star reviews."},"4":{"type":"integer","description":"Number of 4-star reviews."},"5":{"type":"integer","description":"Number of 5-star reviews."}},"description":"Counts of reviews per integer rating from 1 to 5."},"emails_and_contacts":{"type":"object","nullable":true,"properties":{"yelp":{"type":"string","nullable":true,"description":"Yelp listing URL."},"emails":{"type":"array","items":{"type":"string"},"description":"Email addresses found on the business website."},"github":{"type":"string","nullable":true,"description":"GitHub profile URL."},"tiktok":{"type":"string","nullable":true,"description":"TikTok profile URL."},"twitter":{"type":"string","nullable":true,"description":"Twitter/X profile URL."},"youtube":{"type":"string","nullable":true,"description":"YouTube channel URL."},"facebook":{"type":"string","nullable":true,"description":"Facebook profile URL."},"linkedin":{"type":"string","nullable":true,"description":"LinkedIn profile URL."},"snapchat":{"type":"string","nullable":true,"description":"Snapchat profile URL."},"instagram":{"type":"string","nullable":true,"description":"Instagram profile URL."},"pinterest":{"type":"string","nullable":true,"description":"Pinterest profile URL."},"phone_numbers":{"type":"array","items":{"type":"string"},"description":"Phone numbers found on the business website."}},"description":"Emails and social-network profiles extracted from the business website. Populated when extract_emails_and_contacts=true (the default for /business-details)."},"hotel_review_summary":{"type":"object","nullable":true,"description":"Hotel-only: AI-generated review summary. Present only for hotels.","additionalProperties":true},"hotel_booking_options":{"type":"array","items":{"type":"object","additionalProperties":true},"nullable":true,"description":"Hotel-only: array of booking options (provider, price, link). Present only for hotels with live rates."},"hotel_location_rating":{"type":"object","nullable":true,"description":"Hotel-only: location rating breakdown when the business is a hotel.","additionalProperties":true},"hotel_price_for_dates":{"type":"string","nullable":true,"description":"Hotel-only: nightly price string when Google has live rates."},"requested_business_id":{"type":"string","description":"The exact business_id from the request, echoed back. Useful when batching multiple IDs."},"hotel_results_from_web":{"type":"array","items":{"type":"object","additionalProperties":true},"nullable":true,"description":"Hotel-only: additional web-sourced results / reviews shown alongside the Google listing."},"keywords_mentioned_in_reviews":{"type":"array","items":{"type":"object","required":["keyword","review_count"],"properties":{"keyword":{"type":"string","description":"The keyword extracted from reviews."},"review_count":{"type":"integer","description":"Number of reviews mentioning this keyword."}}},"nullable":true,"description":"Keywords most frequently mentioned in reviews, with counts. Returned by /business-details-plus only (AI-enriched, ?extended_details=true)."}}},"description":"List of businesses returned."},"status":{"type":"string","description":"The status of the API response."},"parameters":{"type":"object","properties":{"region":{"type":"string","description":"The region/country code used for the response."},"language":{"type":"string","description":"The language code used for the response."},"business_id":{"type":"string","description":"The business_id as received in the request."},"coordinates":{"type":"string","description":"Geographic bias coordinates used (lat,lng)."},"extract_share_link":{"type":"boolean","description":"Whether a Google Maps share link was extracted."},"extract_emails_and_contacts":{"type":"boolean","description":"Whether email/contact extraction was performed."}},"description":"The parameters the API received and used for this request, echoed back."},"request_id":{"type":"string","description":"A unique ID to trace the API request."}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_Szi2FNxitM95hYhGHY_-4","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Retrieves full Google Maps business profile including contact emails, phone numbers, and social media profiles for up to 20 businesses by ID.","exampleAgentPrompt":"Look up the full business details for the Google Maps place ID ChIJkaUn1JPTD4gR7ZWpE9cCuow — I need their email addresses, phone numbers, and any social media profiles like Facebook, LinkedIn, or Instagram.","exampleUseCases":[{"title":"Outreach list for local restaurants","prompt":"I have these 10 Google Maps business IDs for restaurants in Austin — can you fetch their email addresses and social media profiles so I can build an outreach list? IDs: id1,id2,id3,id4,id5,id6,id7,id8,id9,id10"},{"title":"CRM enrichment with social contacts","prompt":"I just found this local gym on Google Maps — its place ID is ChIJkaUn1JPTD4gR7ZWpE9cCuow. Can you pull all their contact details including emails, Instagram, and Facebook so I can add them to our CRM?"},{"title":"Competitor contact research","prompt":"Get me the full business profile for these 5 Google Maps business IDs of our competitors, including their websites, emails, and LinkedIn pages: 0x880fd393d427a591:0x8cba02d713a995ed, id2, id3, id4, id5"}],"resultDescription":"Returns an array of business objects, each containing name, address, city, state, country, ZIP code, latitude/longitude, rating, website, business category, and — when enabled — an emails_and_contacts field with emails, phone numbers, and social media profiles (Facebook, LinkedIn, Instagram, etc.). Optionally includes a shortened Google Maps share link.","failureModes":["Invalid or malformed business_id returns an error or empty data array","Batch exceeding 20 IDs may be rejected or truncated","Business has no website, so email extraction returns empty contacts","Region or language code not supported returns a validation error","Business has been removed from Google Maps, returning no results","Rate limit or payment failure returns 402 or 429 status"],"whenToPreferThis":"Choose this endpoint when you already have a Google Maps business_id, google_id, or place_id and need comprehensive contact enrichment — especially emails and social profiles — rather than just address or hours. It is the right choice for CRM enrichment, outreach list building, or competitive research when you need to contact businesses directly. Use batch mode (up to 20 IDs) to minimize round trips. Prefer this over a general search endpoint when you know the specific business IDs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:34:50.044Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-local-business-details-with-emails-social-7528ce2b"}