1. Listings
  • Getting Started
  • Locations
    • Location Attributes
      MARKDOWN
    • Photo specifications for your business location
      MARKDOWN
    • Star and Unstar Photos
      MARKDOWN
    • Create a new business location
      POST
    • Update business location
      POST
    • List all locations
      GET
    • List particular locations
      GET
    • Search locations
      GET
    • Get locations by store codes
      GET
    • Upload Photos to a Location
      POST
    • Check Bulk Photo Upload Status
      GET
    • Star/Unstar Location Photos
      POST
    • Delete Location Photos
      POST
    • Archive multiple locations
      POST
    • Cancel scheduled location archival
      POST
    • Activate archived locations
      POST
    • List Active Subscriptions
      GET
    • Get a list of supported countries and their states
      GET
    • Get SubCategories and AdditionalCategories
      GET
    • Get Site Details for Your Plan
      GET
  • Organizing locations
    • Organizing locations
    • Create a new folder
    • List all folders
    • List all folders under an account in hierarchical structure
    • Get details of a folder
    • Rename a folder
    • Add locations to a folder
    • Remove locations from a folder
    • Delete a folder
    • List locations under a folder
    • List all tags
    • List locations by tags
    • Add location to a tag
    • Remove location from a tag
  • User Management
    • User Attributes
    • Create User with Role
    • List Users
    • List Users by ID
    • Add Locations to User
    • Add User and folder
    • List User Roles
    • Add folders to user
    • List User Resources
    • Update a User
    • Remove Folders for User
    • Remove Locations for User
  • Grid Rank
    • Local Rank Grid
    • Create Rank Grid Report
    • Fetch All Grid Reports for Location
    • Fetch Rank Grid Report By ID
  • Review Campaigns
    • Review Campaign Info Attributes
    • Create a review campaign
    • Add customers to a review campaign
    • List review campaigns
    • List review campaign customers
  • Listings
    • Listings
      MARKDOWN
    • Listing Status Webhooks
      MARKDOWN
    • Get premium listings
      GET
    • Get voice listings for a location
      GET
    • Get duplicate listings for a location
      GET
    • Get all duplicate listings for an account
      GET
    • Mark listings as duplicates
      POST
    • Mark listings as not duplicates
      POST
    • Get AI listings
      GET
  • Connected Accounts
    • Connected Accounts
    • Connect Google Profile to Account
    • Connect Facebook Page to Account
    • List all connected accounts
    • List folders under a Google account
    • Create GMB Listing
    • Disconnect GMB Profile
    • Disconnect Facebook Account
    • Fetch Connected Account Details
    • Trigger New Matches
    • List Connection Suggestions
    • Fetch Connected Account Listings
    • Confirm Connected Account Matches
    • Connect a location with a listing of a connected account
    • Disconnect Location from Listing
  • Rankings
    • Rankings Analytics Attributes
    • Add keywords
    • List Keywords
    • Get keywords performance
    • Archive a keyword
    • Get Rollup Keyword Performance
    • Get Rankings Distribution By Time
  • Profile Analytics
    • Profile Analytics
    • Get Bing Analytics
    • Get Facebook Page Analytics
    • Get Google My Business Analytics
  • Reviews
    • Reviews
    • Review Sources
      • Get a list of interaction sources for location
      • Get a list of interaction sources for account
      • Add / Edit interaction source
    • Fetch all interactions
    • List Interactions by IDs
    • Respond to an Interaction
    • Edit Response for Interaction
    • Archive Response for Interaction
    • Get Interaction Analytics
    • Add Review Widget
    • Edit Review Widget
  • Automations
    • Temporary Close Location with a reopening date
  • Error Codes
    • ERROR CODES
  1. Listings

Listings

MARKDOWN
https://api.synup.com/api/v4

Listings Overview#

Listings are live business profiles for a location, displayed on partner websites. We offer the following listing solutions:

Premium Listings#

Our core offering that includes business profiles on major business directories and search engines.

Additional Listings#

Supplementary listings that can be purchased separately via the dashboard or customer support to expand your online presence beyond the Premium package.

Voice Assistant Listings#

Ensure your business information is accessible through popular voice platforms, including:
Google Assistant
Alexa
Siri
Cortana
Bixby

Duplicate Listings#

Duplicate listings occur when multiple entries exist for the same business across different online directories and platforms. Our platform helps identify and manage these duplicates to maintain consistent business information.

Listing States#

Sync Status#

A listing can have the following sync states:
IN_PROGRESS – Listing sync is currently in progress.
SYNCED – Successfully synced with a live listing URL.
FAILED – Listing sync has failed.
REQUIRING_ACTION – Manual action needed to start syncing.
AVAILABLE – Available for syncing.
COMPLETED – Sync completed.
PENDING_APPROVAL – Awaiting approval before sync.

Common Sync Issues#

Common issues that may prevent successful listing sync:
Wrong credentials – Invalid login details for the listing platform.
City not found – The provided city is incorrect or not recognized.
Unable to claim listing – Listing ownership cannot be verified.

Listing Status Notifications#

The platform can notify your system about listing status changes via webhooks.

Key Notification Events:#

Successful listing submission
Failed submission due to non-retriable errors
Status changes during the sync process

Webhook Configuration:#

To enable webhooks:
Configure the webhook URL in your account’s Notification Settings.
Contact support to activate the webhook feature.
Modified at 2025-02-19 10:34:39
Previous
List review campaign customers
Next
Listing Status Webhooks
Built with