Listings API Overview
Walkthroughs for the Listings API, shown three ways every time: the REST API with cURL, the Python SDK, and the Node SDK. The task guides take one job each, from adding a location to answering a review. The endpoint walkthroughs cover every documented endpoint of a resource, in the order you would call them. New here? Start with your first API call.
Start here
Make your first API call
Authenticate, list your locations, read the response envelope, page through results, and learn how IDs work. About five minutes.
Read the guideChoose how to integrate
Compare REST, the Python and Node SDKs, the MCP server, and webhooks, then pick the surface that fits your stack and your workload.
Read the guideLocations
Look up countries, states and categories
Fetch the supported countries and state codes, resolve a business category to its numeric id, and see which publishers your plan covers before you create a location.
Read the guideAdd a location
Create a location with the fields publishers need, handle validation errors, and confirm it has been queued for submission.
Read the guideUpdate a location's details and hours
Change contact details, publish a full weekly schedule with one-off overrides, mark a temporary closure, set Google categories, and read the changes back.
Read the guideUpload a logo, cover and photos
Attach a logo, a cover image, and gallery photos to a location by URL, list what is attached, star the hero image, and remove what is stale.
Read the guideFind locations and archive the ones you no longer manage
Search by keyword, resolve store codes and ids in bulk, schedule closed branches for archival at the end of the billing cycle, and reverse a scheduled archive.
Read the guideConnect publishers
Connect Google Business Profile and import your locations
Mint a Google connect link, match the owner's Google listings to your locations, confirm the matches, and import listings that have no location yet.
Read the guideConnect Facebook Pages
Mint a Facebook connect link, match the owner's Pages to your locations, confirm or hand-pick the links, and disconnect the account when a client leaves.
Read the guideCreate a Google Business Profile for a location that has none
Submit a brand-new Google Business Profile for a location under a connected Google account, then follow verification through the location, its listings, and webhooks.
Read the guideListings
Check listing status and get live links
Read every publisher's sync status for a location, collect the live listing URLs, summarize coverage, check voice assistants, and get notified by webhook instead of polling.
Read the guideFind and fix listing errors
Filter a location's listings to the rows that need attention, read the publisher's reason, apply the matching fix, re-poll safely, and sweep the whole account.
Read the guideFind and suppress duplicate listings
List the duplicate listings detected for a location and across the account, confirm the real ones for suppression, clear false positives, and track each through to fixed.
Read the guideReviews
Fetch reviews for one location or your whole account
List the latest reviews for a location, filter to unanswered low ratings, page with cursors, sweep the account, and get notified by webhook.
Read the guideRespond to reviews, then edit or archive a reply
Find reviews that accept an owner reply, post one, confirm it reached the publisher, then fix its wording or archive it.
Read the guideMeasure review performance
Read a location's review KPIs, chart the daily timeline, compare sources, mine common phrases, and receive daily and weekly snapshots by webhook.
Read the guidePosts
Analytics
Automation
AI agents
Endpoint walkthroughs
Locations
Every Locations endpoint with a cURL, Python and Node sample, in usage order, covering list, search, lookups by id and store code, create, update, archive, and photos.
Read the guideListings
Every Listings endpoint with a cURL, Python and Node sample: premium sync status, voice assistants, duplicate detection per location and per account, and duplicate suppression.
Read the guideConnected accounts
Every Connected accounts endpoint with a cURL, Python and Node sample: connect Google and Facebook, list accounts, match and link listings, folders, GMB creation, disconnects.
Read the guideReviews
Every Reviews endpoint with a cURL, Python and Node sample: sources and settings, list, rollup, details, respond, edit, archive, phrases, and analytics.
Read the guidePosts
Every Posts endpoint with a cURL, Python and Node sample: announcements, events and offers, scheduling, per-location and bulk campaigns, status polling and deletion.
Read the guideAnalytics
Every profile analytics endpoint with a cURL, Python and Node sample: daily Google and Facebook metrics and weekly Bing views for a location.
Read the guideSupporting APIs
Every Supporting API endpoint with a cURL, Python and Node sample: supported countries and states, the subcategory catalog, and the publisher sites your plan covers.
Read the guide