EXAMPLE DATA

Example weekly neighborhood report for a café

This is what an AlleyPulse weekly neighborhood email looks like: the changes within 1 km of a fictional café's address this week, sorted by priority, each with why it matters and what to do this week.

Last updated: 26 October 2026 · fictional shop, anonymized neighbors, invented numbers, no real reviews

View this issue as

API and MCP documentation

This week in 30 secondsA café nearby started a morning promo aimed at your commuters, a Saturday street market will bring extra people past your door, and a bakery's rating dipped after complaints about waiting. Three things to act on, four worth knowing, three to skim.

AAct this week

3 items

AAct this weekCompetitor promo200 m

A café 200 m away is offering two for one flat whites before 9am

What changed: New post on its Google Maps listing, valid weekdays until Friday 6 November.
Where: 200 m east, two streets from the station entrance you share
Why it matters: It targets the same commuters as your busiest window, 7 to 9am.
What to do this week: Don't match the price. Put your loyalty card or a coffee and pastry pairing in the window, and compare your 7 to 9am sales with last week.
Source and timing: Google Maps listing post · first seen Sat 24 Oct · source type explained

AAct this weekLocal event350 m

Street market on Sample Square this Saturday, 31 October, 10:00 to 16:00

What changed: Listed on the city events calendar this week. Market Lane is closed to traffic from 07:00 to 17:00 that day.
Where: 350 m north, on Sample Square
Why it matters: More weekend visitors pass your street, and the closure may delay a Saturday morning delivery.
What to do this week: Move Saturday's delivery to Friday, put a sign pointing from the square to your door, and consider opening an hour longer.
Source and timing: City events calendar · published Wed 21 Oct · source type explained

AAct this weekRating change0.8 km

A bakery 0.8 km away dropped from 4.6 to 4.4 stars after 9 new reviews in 7 days

What changed: 9 new reviews this week; its usual is about 2. By our summary, 5 of them mention long waits and 2 praise the bread.
Where: 0.8 km west, near the high street
Why it matters: Quick service is a gap you can fill, and some of its regulars may be open to trying somewhere else.
What to do this week: Make order ahead and quick pickup visible on your listing and at the counter. Check your own waiting times during the Saturday rush.
Source and timing: Google Maps rating and review count · weekly snapshot Sun 25 Oct vs Sun 18 Oct · source type explained

BWorth knowing

4 items

BWorth knowingNew on Google Maps400 m

A coffee kiosk is new on Google Maps near you, on Station Road

What changed: The listing appeared since last week's snapshot. No hours, photos or reviews yet.
Where: 400 m south, on Station Road
Why it matters: A new listing is not a confirmed opening. If it starts trading, it would compete for takeaway coffee.
What to do this week: Nothing yet. We will tell you if hours, photos or reviews appear.
Source and timing: Google Maps listing · first seen in snapshot Sun 25 Oct · source type explained

BWorth knowingMarked closed600 m

A sandwich shop 600 m away is marked permanently closed on Google

What changed: Its status changed between our last two snapshots. Closed means marked closed on Google at scan time; the owner may not have confirmed it.
Where: 600 m northeast, by the office park
Why it matters: Its lunch customers may be looking for a new place nearby.
What to do this week: If you serve lunch, check that your lunch menu and hours are current on your listing.
Source and timing: Google Maps business status · snapshot Sun 25 Oct · source type explained

BWorth knowingSearch interestYour region

Searches for hot chocolate in your region are clearly up on four weeks ago

What changed: Relative search interest rose from 61 to 100 on a 0 to 100 index. Regional, not your street, and not a count of people.
Where: Your region
Why it matters: Seasonal demand is turning, and people searching may also be looking for somewhere to buy it.
What to do this week: If you sell it, add a photo of it to your listing and put it on the board outside.
Source and timing: Regional search interest index, relative · week to Sat 24 Oct · source type explained

BWorth knowingWeatherYour area

Rain Tuesday to Thursday, cooling to 9°C; dry and mild on Saturday

What changed: New forecast for the week ahead.
Where: Your area
Why it matters: Wet weekdays usually shift trade to takeaway; Saturday lines up with the street market.
What to do this week: Stock up on takeaway cups midweek and plan full staff for Saturday.
Source and timing: Weather forecast · issued Mon 26 Oct 05:00 · source type explained

CSkim

3 items

CSkimCompetitor postsWithin 1 km

Two restaurants within 1 km added autumn menus and new photos to their listings

What changed: New menu photos and one post each.
Where: 0.5 km and 0.9 km away
What to do this week: No action needed. Useful context if you are planning a seasonal menu.
Source and timing: Google Maps listing photos and posts · seen Thu 22 to Sat 24 Oct · source type explained

CSkimLocal newsYour street

Public consultation on bike parking along Sample Street; comments open until 15 November

What changed: The council published a proposal and invited comments.
Where: On your street
What to do this week: Skim the proposal; comment if the location affects your terrace or deliveries.
Source and timing: Local council news page · published Tue 20 Oct · source type explained

CSkimIndustry trendIndustry wide

Trade press reports rising wholesale cocoa and coffee prices this autumn

What changed: Two trade articles this week report higher wholesale prices.
Where: Industry wide
What to do this week: Note it for your next menu price review, and ask your supplier about first quarter prices.
Source and timing: Trade publication article · published Mon 19 Oct · source type explained

How was this issue made?

We compared the Sunday 25 October snapshot with the Sunday 18 October snapshot of 137 Google Maps listings within 1 km (an example number), then added public events, news, weather and regional search interest. Information can be hours to days old. Businesses not listed on Google Maps can't appear. AlleyPulse is not affiliated with Google.

This is issue 6. Issue 1 for any shop is a baseline with no what changed items. Spotted an error, or want a listing removed? Email hello@alleypulse.com.

Want this for your own address?

Your free sample is a baseline issue: what is around you now. Weekly changes start from issue 2.

Get a free sample for your address Check coverage first

This issue as JSON

This is the same example issue as the API returns it from GET /shops/shp_EXAMPLE01/issues/latest. The MCP tool get_latest_digest returns the same content. All values are example data.

Example issue 6 as JSON

{
  "id": "iss_EXAMPLE06",
  "shop_id": "shp_EXAMPLE01",
  "number": 6,
  "published_at": "2026-10-26T07:00:00Z",
  "is_baseline": false,
  "scan": {
    "radius_m": 1000,
    "listings_scanned": 137,
    "scanned_on": "2026-10-25",
    "compared_with": "2026-10-18"
  },
  "tier_counts": {
    "A": 3,
    "B": 4,
    "C": 3
  },
  "summary": "A café nearby started a morning promo aimed at your commuters, a Saturday street market will bring extra people past your door, and a bakery's rating dipped after complaints about waiting. Three things to act on, four worth knowing, three to skim.",
  "items": [
    {
      "id": "itm_EXAMPLE01",
      "issue_id": "iss_EXAMPLE06",
      "issue_number": 6,
      "tier": "A",
      "category": "competitor_promo",
      "headline": "A café 200 m away is offering two for one flat whites before 9am",
      "what_changed": "New post on its Google Maps listing, valid weekdays until Friday 6 November.",
      "distance_m": 200,
      "why_it_matters": "It targets the same commuters as your busiest window, 7 to 9am.",
      "what_to_do": "Don't match the price. Put your loyalty card or a coffee and pastry pairing in the window, and compare your 7 to 9am sales with last week.",
      "source_url": "https://source.alleypulse.example/itm_EXAMPLE01",
      "source_type": "google_maps_post",
      "first_seen": "2026-10-24"
    },
    {
      "id": "itm_EXAMPLE02",
      "issue_id": "iss_EXAMPLE06",
      "issue_number": 6,
      "tier": "A",
      "category": "local_event",
      "headline": "Street market on Sample Square this Saturday, 31 October, 10:00 to 16:00",
      "what_changed": "Listed on the city events calendar this week. Market Lane is closed to traffic from 07:00 to 17:00 that day.",
      "distance_m": 350,
      "why_it_matters": "More weekend visitors pass your street, and the closure may delay a Saturday morning delivery.",
      "what_to_do": "Move Saturday's delivery to Friday, put a sign pointing from the square to your door, and consider opening an hour longer.",
      "source_url": "https://source.alleypulse.example/itm_EXAMPLE02",
      "source_type": "events_calendar",
      "first_seen": "2026-10-21"
    },
    {
      "id": "itm_EXAMPLE03",
      "issue_id": "iss_EXAMPLE06",
      "issue_number": 6,
      "tier": "A",
      "category": "competitor_rating",
      "headline": "A bakery 0.8 km away dropped from 4.6 to 4.4 stars after 9 new reviews in 7 days",
      "what_changed": "9 new reviews this week; its usual is about 2. By our summary, 5 of them mention long waits and 2 praise the bread.",
      "distance_m": 800,
      "why_it_matters": "Quick service is a gap you can fill, and some of its regulars may be open to trying somewhere else.",
      "what_to_do": "Make order ahead and quick pickup visible on your listing and at the counter. Check your own waiting times during the Saturday rush.",
      "source_url": "https://source.alleypulse.example/itm_EXAMPLE03",
      "source_type": "google_maps_listing",
      "first_seen": "2026-10-25"
    },
    {
      "id": "itm_EXAMPLE04",
      "issue_id": "iss_EXAMPLE06",
      "issue_number": 6,
      "tier": "B",
      "category": "new_listing",
      "headline": "A coffee kiosk is new on Google Maps near you, on Station Road",
      "what_changed": "The listing appeared since last week's snapshot. No hours, photos or reviews yet.",
      "distance_m": 400,
      "why_it_matters": "A new listing is not a confirmed opening. If it starts trading, it would compete for takeaway coffee.",
      "what_to_do": "Nothing yet. We will tell you if hours, photos or reviews appear.",
      "source_url": "https://source.alleypulse.example/itm_EXAMPLE04",
      "source_type": "google_maps_listing",
      "first_seen": "2026-10-25"
    },
    {
      "id": "itm_EXAMPLE05",
      "issue_id": "iss_EXAMPLE06",
      "issue_number": 6,
      "tier": "B",
      "category": "marked_closed",
      "headline": "A sandwich shop 600 m away is marked permanently closed on Google",
      "what_changed": "Its status changed between our last two snapshots. Closed means marked closed on Google at scan time; the owner may not have confirmed it.",
      "distance_m": 600,
      "why_it_matters": "Its lunch customers may be looking for a new place nearby.",
      "what_to_do": "If you serve lunch, check that your lunch menu and hours are current on your listing.",
      "source_url": "https://source.alleypulse.example/itm_EXAMPLE05",
      "source_type": "google_maps_listing",
      "first_seen": "2026-10-25"
    },
    {
      "id": "itm_EXAMPLE06",
      "issue_id": "iss_EXAMPLE06",
      "issue_number": 6,
      "tier": "B",
      "category": "search_interest",
      "headline": "Searches for hot chocolate in your region are clearly up on four weeks ago",
      "what_changed": "Relative search interest rose from 61 to 100 on a 0 to 100 index. Regional, not your street, and not a count of people.",
      "distance_m": null,
      "why_it_matters": "Seasonal demand is turning, and people searching may also be looking for somewhere to buy it.",
      "what_to_do": "If you sell it, add a photo of it to your listing and put it on the board outside.",
      "source_url": "https://source.alleypulse.example/itm_EXAMPLE06",
      "source_type": "search_interest",
      "first_seen": "2026-10-24"
    },
    {
      "id": "itm_EXAMPLE07",
      "issue_id": "iss_EXAMPLE06",
      "issue_number": 6,
      "tier": "B",
      "category": "weather",
      "headline": "Rain Tuesday to Thursday, cooling to 9°C; dry and mild on Saturday",
      "what_changed": "New forecast for the week ahead.",
      "distance_m": null,
      "why_it_matters": "Wet weekdays usually shift trade to takeaway; Saturday lines up with the street market.",
      "what_to_do": "Stock up on takeaway cups midweek and plan full staff for Saturday.",
      "source_url": "https://source.alleypulse.example/itm_EXAMPLE07",
      "source_type": "weather_forecast",
      "first_seen": "2026-10-26"
    },
    {
      "id": "itm_EXAMPLE08",
      "issue_id": "iss_EXAMPLE06",
      "issue_number": 6,
      "tier": "C",
      "category": "competitor_posts",
      "headline": "Two restaurants within 1 km added autumn menus and new photos to their listings",
      "what_changed": "New menu photos and one post each.",
      "distance_m": null,
      "why_it_matters": null,
      "what_to_do": "No action needed. Useful context if you are planning a seasonal menu.",
      "source_url": "https://source.alleypulse.example/itm_EXAMPLE08",
      "source_type": "google_maps_post",
      "first_seen": "2026-10-22"
    },
    {
      "id": "itm_EXAMPLE09",
      "issue_id": "iss_EXAMPLE06",
      "issue_number": 6,
      "tier": "C",
      "category": "local_news",
      "headline": "Public consultation on bike parking along Sample Street; comments open until 15 November",
      "what_changed": "The council published a proposal and invited comments.",
      "distance_m": null,
      "why_it_matters": null,
      "what_to_do": "Skim the proposal; comment if the location affects your terrace or deliveries.",
      "source_url": "https://source.alleypulse.example/itm_EXAMPLE09",
      "source_type": "news_page",
      "first_seen": "2026-10-20"
    },
    {
      "id": "itm_EXAMPLE10",
      "issue_id": "iss_EXAMPLE06",
      "issue_number": 6,
      "tier": "C",
      "category": "industry_trend",
      "headline": "Trade press reports rising wholesale cocoa and coffee prices this autumn",
      "what_changed": "Two trade articles this week report higher wholesale prices.",
      "distance_m": null,
      "why_it_matters": null,
      "what_to_do": "Note it for your next menu price review, and ask your supplier about first quarter prices.",
      "source_url": "https://source.alleypulse.example/itm_EXAMPLE10",
      "source_type": "trade_press",
      "first_seen": "2026-10-19"
    }
  ]
}

Read the API and MCP documentation