Google Maps Photos & Videos Scraper

Extract public photos, videos, and Street View images from Google Maps places. Each usable media object is returned as its own dataset row with stable place and media identifiers.

What it does

• Accepts Google Maps URLs, share links, Place IDs, and hexadecimal CIDs.
• Discovers places from keyword searches with a location, circle, or polygon.
• Combines direct inputs and searches in one run.
• Collects selected Maps categories such as Menu, Food & drink, Vibe, By owner, Latest, Videos, and Street View.
• Saves Street View images to the run's key-value store.
• Returns playable MP4 URLs for video rows.

How to use it

1. Add direct place URLs or IDs, search terms, or both.
2. Add a location or geographic filter when using search terms.
3. Select categories, image resolution, and the total media cap per place.
4. Run the Actor and export the default dataset.

Input limits

• Up to 100 combined Google Maps URLs and Place IDs.
• Up to 10 search terms.
• Up to 120 discovered places per search term.
• Up to 10,000 media rows per place.
• Search-circle radius up to 100 miles.

Equivalent places found through multiple input forms are processed once. Search discovery is charged once per unique place.

Output

Every row contains the fields needed to interpret it:

Field	Description
rowType	media for usable results or status for an explanatory row
status	Success or a customer-readable outcome
error	Stable error code, or null for successful media
photoId	Stable Google media identifier, or null on place-level status rows
type	photo, video, street_view, or null
category, categoryLabel	Selected Maps category
imageUrl	Requested image URL or stored Street View image
videoUrl	Playable MP4 URL for videos; otherwise null

Optional output controls cover thumbnails, dimensions, GPS coordinates, upload dates, owner flags, source, place metadata, source search term, internal category code, and scrape timestamp. When an enabled value is unavailable it is returned as null; disabling an optional field removes it from every row type.

Standard photo URLs use the selected CDN size. Width and height describe the original standard-photo or video frame; Street View rows report the dimensions of the stored image.

Status rows

Status rows are not charged as media results. Common error codes include:

Error	Meaning
input_validation_failed	Input needs to be corrected
place_resolve_failed	A direct place input could not be resolved
search_unavailable	A search could not be completed
no_photos_returned	No public media was available in the selected categories
media_category_unavailable	One selected category could not be retrieved completely
street_view_media_unavailable	A Street View record was found but its image could not be stored
place_processing_failed	The place could not be completed and should be retried

Pricing

The live Pay-Per-Event configuration is:

Event	Price	Trigger
Photo or video extracted	$0.00025	One usable photo, video, or Street View row
Place found via search	$0.005	One unique place discovered by search

Direct URL and ID inputs do not trigger the search-discovery event. Explanatory status rows are uncharged. The automatic default-dataset-item event is not enabled.

Limits and retention

Google may temporarily return incomplete or unavailable public media. The Actor retries bounded transient failures and emits explanatory rows when a requested place or category cannot be completed.

Dataset and stored-image retention depend on the user's Apify plan. Standard Google-hosted media URLs are controlled by Google and can change independently.

FAQ

Why is GPS sometimes null?

Many uploads do not expose GPS metadata. The Actor returns null instead of inventing coordinates.

Why did one place return a status row?

Review its error code. Invalid inputs should be corrected; unavailable places or categories can be retried later.

Why are there fewer rows than the selected categories contain?

The media cap is a total per-place cap across categories. Categories are processed in the selected order until that total is reached.

Related Actors

• Google Maps Reviews Scraper
• Google Maps Business Leads Scraper

Disclaimer

Use this Actor only for lawful purposes and public information you are permitted to process. Platform availability and media URLs can change. Users are responsible for compliance with applicable laws and platform terms.