Skip to content
SynupAPI
Get an API key

Listings

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.