apple-maps-api

Search Apple Maps and return places with ratings, addresses, phone numbers, and coordinates. Apify-backed n8n community node, pay-per-result, and usable as an AI agent tool.

Package Information

Released: 4 mo ago
Downloads: 6 weekly / 275 monthly
Latest Version: 0.1.1
Author: John Cole

Documentation

n8n-nodes-apple-maps-api

An n8n community node that searches Apple Maps and returns structured places: title, type, rating, address, phone, website, and coordinates. It is backed by the Apple Maps API on Apify and bills per result, so there are no subscriptions and no minimums.

Installation · Credentials · Operations · Output · Example workflows · Pricing · Resources

What it does

Give the node a query and an optional location, and it returns one item per place with the title, category, rating, review count, address, phone, website, and GPS coordinates. It also works as an AI Agent tool, so an agent can find places on demand.

  • Search Apple Maps for any business or point of interest
  • Localize with a location and locale
  • Control how many results to return
  • Choose how much data to return per place: Simplified, Raw, or Selected Fields

Installation

Follow the n8n community nodes installation guide:

  1. In n8n, open Settings > Community Nodes.
  2. Select Install.
  3. Enter n8n-nodes-apple-maps-api as the npm package name.
  4. Agree to the risks of using community nodes, then select Install.

After it installs, the Apple Maps node appears in the nodes panel.

n8n Cloud only allows verified community nodes. Until this node is verified, install it on a self-hosted n8n instance.

Credentials

You need a free Apify account and an API token.

  1. Sign in to the Apify Console.
  2. Open Settings > Integrations and copy your Personal API token.
  3. In n8n, create a new Apify API credential and paste the token.
  4. Use the credential's Test button to confirm it works.

The node also supports Apify OAuth2 if you prefer to connect that way.

Operations

Place > Search returns places that match a query.

Parameter Description
Search Query What to search Apple Maps for. Required.
Location Location to center the search on. Optional.
Locale Locale for the results, for example en-US. Optional.
Sort How to sort the results.
Maximum Results How many places to return.
Output How much data to return: Simplified, Raw, or Selected Fields.

Output

Each place is returned as its own n8n item. The API returns more than ten fields per place, so the Output parameter lets you choose how much to return:

  • Simplified (default): a compact object with position, title, type, rating, reviews, address, phone, website, latitude, longitude, and placeId. This mode is also used automatically when the node runs as an AI Agent tool, to keep responses small.
  • Raw: every field the API returns for each place, using the original field names below.
  • Selected Fields: pick exactly which fields to include.

Fields (Raw and Selected Fields)

Field Type Description
position integer Rank in the results
title string Place name
type string Place category
rating number Average rating
reviews integer Number of reviews
address string Full address
structured_address object Address broken into components
phone string Phone number
phone_formatted string Formatted phone number
website string Website URL
gps_coordinates object Latitude and longitude
place_id string Apple Maps place identifier
amenities array Listed amenities
open_state string Open or closed status
weekly_hours object Hours by day
images array Place image URLs

Example workflows

1. Build a local lead list

  1. Manual Trigger.
  2. Apple Maps: Search Query a category and city, Output Simplified.
  3. Google Sheets: append each place's title, address, phone, and website.

2. Enrich a list of businesses

  1. Read your list of business names.
  2. Apple Maps: search each name.
  3. Set: keep rating, reviews, and phone for each.

3. Let an AI Agent find places

  1. AI Agent node.
  2. Attach Apple Maps as a tool.
  3. Ask "Find well-rated dentists near downtown Austin." The agent calls the node (in Simplified mode) and answers with live places.

Pricing

This node calls the Apple Maps API on Apify, which is billed pay-per-result, with no subscription and no minimums. Apify also includes a free monthly usage tier that covers typical volumes. See the Actor page for current rates.

Resources

License

MIT

Discussion