canonical: https://jentic.com/apis/outscraper.com/outscraper

# Outscraper API

Outscraper is a data extraction service that scrapes Google Maps, Google Search, and Google services for business intelligence and lead generation. The API provides endpoints to search Google Maps places, extract business reviews, scrape business photos, extract email addresses and contacts from websites, and check asynchronous request status. Use it to build lead lists, analyze competitor reviews, enrich CRM data with business details, monitor brand reputation across Google Maps, or automate local SEO research.

## For AI agents

Scrape Google Maps places, reviews, photos, and website contacts for lead generation and business intelligence workflows.

## Scope

Does not manage Google My Business listings, post content to Google, or handle Google Ads - use for data extraction and scraping only.

## Capabilities

- Search Google Maps for places by query with location, language, and region filters
- Extract detailed business information including name, address, phone, website, ratings, hours, and categories
- Scrape Google Maps reviews for businesses with rating, text, author, and timestamp
- Retrieve business photos from Google Maps listings
- Extract email addresses and contact information from business websites
- Enrich business data with additional data services (social profiles, industry classification)
- Run large scraping jobs asynchronously and poll for completion
- Limit result count and paginate through large datasets
- Filter results by language and geographic region

## Use cases

### Automated Lead Generation from Google Maps

Build targeted lead lists by scraping Google Maps for businesses matching a query. GET `/maps/search-v3` with a query like 'plumbers in Chicago, IL' returns business names, addresses, phones, websites, and ratings. Use extract_contacts=true to scrape email addresses from business websites. This powers sales prospecting tools, local marketing campaigns, and CRM enrichment workflows, replacing manual Google Maps searches with automated, scalable data extraction.

Example prompt: GET `/maps/search-v3` with query='target business type in city', limit=100, and extract_contacts=true to retrieve business details and emails. Export results to CRM or sales tool.

### Review Monitoring and Sentiment Analysis

Track customer sentiment by scraping Google Maps reviews for your business or competitors. GET `/maps/reviews-v3` retrieves reviews with rating, text, author, and timestamp. Aggregate ratings over time to detect reputation trends, identify common complaints or praise themes, or trigger alerts when negative reviews appear. Integrate with sentiment analysis tools or customer support systems to respond quickly to feedback.

Example prompt: GET `/maps/reviews-v3` with business place_id, then parse review text for sentiment scoring. Set up a scheduled job to poll for new reviews and trigger alerts on low ratings.

### Local SEO Research and Competitor Analysis

Analyze local search rankings, competitor presence, and market saturation by scraping Google Maps for specific queries and regions. GET `/maps/search-v3` with region and language filters returns businesses ranked for a query. Compare your business's position, rating, and review count against competitors, identify underserved geographies, or track changes in local pack rankings over time. This supports SEO strategy, market entry planning, and competitive intelligence.

Example prompt: GET `/maps/search-v3` with query='target keyword + city' across multiple cities, compare your business's ranking and rating, and identify gaps in competitor coverage or high-performing competitors.

### CRM Enrichment with Business Data

Enrich CRM contact and account records with up-to-date business information from Google Maps. Given a business name and location, GET `/maps/search-v3` returns phone, website, address, hours, and rating. Use GET /emails-and-contacts to extract additional contact emails from the business website. This automates data entry for sales teams, improves contact data quality, and ensures CRM records reflect current business details.

Example prompt: GET `/maps/search-v3` with business name and city to retrieve updated details, then GET /emails-and-contacts with the website URL to extract emails. Update CRM records via CRM API.

### AI Agent for Lead and Review Scraping

Let an AI agent handle Google Maps scraping tasks - building lead lists, monitoring reviews, or extracting contacts. Through Jentic, the agent searches by intent ('scrape Google Maps for dentists in Seattle') and loads only the required endpoints. API keys are injected at execution time, keeping credentials out of agent context.

Example prompt: Use the Jentic search query 'scrape Google Maps for businesses' to find GET `/maps/search-v3`, load its schema, and execute with query, limit, and extract_contacts parameters provided by the user.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/maps/search-v3` | Search Google Maps for places by query |
| GET | `/maps/reviews-v3` | Scrape reviews for a Google Maps business |
| GET | `/emails-and-contacts` | Extract email addresses from websites |
| GET | `/maps/photos` | Retrieve photos from a Google Maps listing |
| GET | `/requests/{id}` | Check status of an async scraping request |

## Key resources

- **Google Maps Places** — Business listings from Google Maps with name, address, phone, website, ratings, and hours
- **Google Maps Reviews** — Customer reviews for businesses including rating, text, author, and timestamp
- **Google Maps Photos** — Photos associated with business listings on Google Maps
- **Email and Contacts** — Email addresses and contact information extracted from business websites
- **Async Requests** — Long-running scraping jobs that poll for completion

## Why Jentic

- **Setup:** Wiring Outscraper by hand means setting its X-API-KEY header and handling its asynchronous request model, where searches return a request id you poll for results. Through Jentic you install once, import the Outscraper API from the API Directory, store the API key once, and your agent calls it.
- **Permission scoping:** Outscraper takes the search target in query parameters rather than the URL path, so scope the agent to the operations it needs, such as searching Google Maps, pulling reviews, or fetching a request result by id. Because you choose the allowed operations, the agent only runs the extractions you list.
- **Credential handling:** Your Outscraper API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'scrape Google Maps for businesses' or 'extract reviews from Google Maps', and Jentic returns the matching Outscraper operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Google Places API** — Google's official Places API provides business data but with rate limits and restricted fields.
- **Apify API** — Apify provides web scraping and automation tools including Google Maps scrapers.

## FAQ

### What authentication does the Outscraper API use?

The API uses API key authentication passed as a query parameter or header. Through Jentic, API keys are stored encrypted and injected at execution time, keeping them out of agent prompts and transcripts.

### Can I scrape email addresses from business websites?

Yes. Set extract_contacts=true in GET `/maps/search-v3` or use GET /emails-and-contacts with a website URL to extract email addresses and contact information from business sites.

### How do I scrape reviews for a Google Maps business?

Use GET `/maps/reviews-v3` with the business's place_id (obtained from `/maps/search-v3`). The endpoint returns reviews with rating, text, author, and timestamp.

### Is the Outscraper API free?

Outscraper offers a free tier with limited monthly credits. Paid plans provide higher quotas and additional features. API usage is metered by credits consumed per request, based on result count and enrichments.

### Can I run large scraping jobs asynchronously?

Yes. Set async=true in scraping requests to run the job in the background. Use GET `/requests/{id}` to poll for job status and retrieve results when complete.

### Does Outscraper violate Google's Terms of Service?

Outscraper operates as a data service that accesses publicly available data. Users are responsible for complying with applicable terms of service and data protection laws when using scraped data.

### Can I limit what my agent is allowed to do with the Outscraper API?

Yes. Because Jentic One is self-hosted by you, your own rules decide which Outscraper operations and credentials the agent may use, so you can allow only the ones it needs. For example, you can let the agent search Google Maps places and pull reviews while blocking email and contact extraction, or restrict it to fetching a request result by id. Since the search target is passed in query parameters rather than the URL path, the agent runs only the extractions you list.