# cporter202/google-maps-scraping-apis architecture

> Architecture diagram of the GitHub repository cporter202/google-maps-scraping-apis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cporter202/google-maps-scraping-apis
- Repository: https://github.com/cporter202/google-maps-scraping-apis

## Overview

This repository is a curated directory of Google Maps scraping actors and guidance, not a scraper implementation. The documented user journey is to choose an actor from the catalog, run it on Apify, and receive clean JSON for lead generation or analysis. The README also points users to separate lead-generation and review-monitoring playbooks. No source excerpts were provided, so the graph shows only relationships explicitly documented in the README; it does not infer playbook internals.

Main entry points: [`README.md`](https://github.com/cporter202/google-maps-scraping-apis/blob/main/README.md) (Directory overview), [`catalog/README.md`](https://github.com/cporter202/google-maps-scraping-apis/blob/main/catalog/README.md) (Actor catalog), [`playbooks/local-lead-pipeline.md`](https://github.com/cporter202/google-maps-scraping-apis/blob/main/playbooks/local-lead-pipeline.md) (Lead pipeline), [`playbooks/review-monitoring.md`](https://github.com/cporter202/google-maps-scraping-apis/blob/main/playbooks/review-monitoring.md) (Review monitoring)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Actor catalog"]
  node_catalog["Actor catalog<br/>[README.md]"]
  node_maps_actors["Maps actors<br/>[README.md]"]
end

subgraph group_guidance["Use-case guidance"]
  node_lead_playbook["Lead pipeline"]
  node_review_playbook["Review monitoring"]
  node_repo_overview["Directory overview<br/>[README.md]"]
end

node_user(("Data seeker"))
node_apify["Apify"]
node_json["Clean JSON"]
node_business_results["Leads and insights"]

node_user -->|"browses"| node_catalog
node_catalog -->|"lists"| node_maps_actors
node_user -->|"runs actor"| node_apify
node_apify -->|"returns"| node_json
node_json -->|"supports"| node_business_results
node_repo_overview -->|"links to"| node_lead_playbook
node_repo_overview -->|"links to"| node_review_playbook
node_lead_playbook -->|"guides lead work"| node_business_results
node_review_playbook -->|"guides monitoring"| node_business_results

click node_catalog "https://github.com/cporter202/google-maps-scraping-apis/blob/main/catalog/README.md"
click node_maps_actors "https://github.com/cporter202/google-maps-scraping-apis/blob/main/catalog/README.md"
click node_lead_playbook "https://github.com/cporter202/google-maps-scraping-apis/blob/main/playbooks/local-lead-pipeline.md"
click node_review_playbook "https://github.com/cporter202/google-maps-scraping-apis/blob/main/playbooks/review-monitoring.md"
click node_repo_overview "https://github.com/cporter202/google-maps-scraping-apis/blob/main/README.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_catalog,node_maps_actors toneBlue
class node_lead_playbook,node_review_playbook,node_repo_overview toneAmber
class node_user,node_json,node_business_results toneIndigo
class node_apify toneMint
```

## Components

### Actor catalog

- [Actor catalog](https://github.com/cporter202/google-maps-scraping-apis/blob/main/catalog/README.md): `catalog/README.md`
- [Maps actors](https://github.com/cporter202/google-maps-scraping-apis/blob/main/catalog/README.md): `catalog/README.md`

### Use-case guidance

- [Lead pipeline](https://github.com/cporter202/google-maps-scraping-apis/blob/main/playbooks/local-lead-pipeline.md): `playbooks/local-lead-pipeline.md`
- [Review monitoring](https://github.com/cporter202/google-maps-scraping-apis/blob/main/playbooks/review-monitoring.md): `playbooks/review-monitoring.md`
- [Directory overview](https://github.com/cporter202/google-maps-scraping-apis/blob/main/README.md): `README.md`

### Other components

- **Data seeker**
- **Apify**
- **Clean JSON**
- **Leads and insights**

## Connections

- Data seeker → Actor catalog: browses (evidence: `README.md`)
- Actor catalog → Maps actors: lists (evidence: `README.md`)
- Data seeker → Apify: runs actor (evidence: `README.md`)
- Apify → Clean JSON: returns (evidence: `README.md`)
- Clean JSON → Leads and insights: supports (evidence: `README.md`)
- Directory overview → Lead pipeline: links to (evidence: `README.md`)
- Directory overview → Review monitoring: links to (evidence: `README.md`)
- Lead pipeline → Leads and insights: guides lead work (evidence: `README.md`)
- Review monitoring → Leads and insights: guides monitoring (evidence: `README.md`)
