Google Places worker

A professional data operator's workbench for discovering businesses via the Google Places Text Search API, then curating the results into the platform's permanent store (which feeds the live discovery site). Every executed query is metered for billing.

Run model — explore → promote

• Single query stages and inspects one record at a time (test before committing).
• Batch run sweeps the whole source in batches, optionally on auto-pilot.
• With explore mode on, a search returns results to *this browser only* (Saved

local) and persists nothing. You prune freely, then Transfer the keepers to the Saved permanent store (D1 + R2). Only promoted records reach the live site.

Cost & identity

Each executed query is metered to the operator's AccountRevenue plan as places_lookups — kept or not. With auth enabled, the operator signs in via AccountRevenue Core; the plan/quota drives the cost figures shown in the workbench.

Inputs & outputs

• In: an Excel/CSV of search terms (or the built-in seed list, or a typed query) + a

selected Google Places field mask.

• Out: a browser results table, downloadable CSV / Excel / photo ZIP, and — on

promote — canonical records in D1 agent_places + raw JSON in R2.

Key endpoints

POST /api/places/search · POST /api/promote · GET /api/records · GET /api/status · GET/POST /api/settings · GET /api/auth/me. Full contract in the worker's CODEX.md.

Pages

Single query · Batch run · Source · Fields & Cost · Storage · Settings · Tests · Docs.