Synup
Create a key
v1Resources/Duplicate Listings/getGet duplicate listings for a location

Get duplicate listings for a location

Returns duplicate listings detected for one location, grouped by publisher, with counts by status.

get/api/v1/listings/duplicates
listings:read
Query parameters
locationIdstringrequired
The location to look up. Required.
clientIdstringoptional
The location's client. Only needed to disambiguate when your key is scoped to specific clients.
statusstring (potential | flagged | deleted | failed)optional
Restrict results to one status: potential, flagged, deleted, or failed. Counts are always returned for every status regardless of this filter.
Response
dataobjectoptional
foundbooleanoptional
Whether the location was found and accessible to this key.
yourListingobjectoptional
This location's own name, address, and phone, for comparison against each duplicate row. Absent when found is false.
namestringoptional
This location's own business name.
addressstringoptional
This location's own address.
phonestringoptional
This location's own phone number.
countsobjectoptional
Counts of duplicate listings for this location, by status.
potentialnumberoptional
Number of duplicates awaiting review.
flaggednumberoptional
Number of duplicates flagged for removal.
deletednumberoptional
Number of duplicates successfully removed.
failednumberoptional
Number of duplicates whose removal attempt failed.
groupsarray of objectoptional
Duplicate listings, grouped by publisher.
publisherIdstringoptional
Identifier of the directory/publisher (its site URL).
publisherNamestringoptional
Display name of the publisher.
originalUrlstringoptional
Live URL of this location's own real listing on this publisher, or null.
rowsarray of objectoptional
The duplicate listings found on this publisher.
idstringoptional
Unique identifier for this duplicate listing row.
businessNamestringoptional
Business name as it appears on the duplicate listing.
businessNameMatchesbooleanoptional
Whether the duplicate's business name matches this location's own name.
addressstringoptional
Street, city, and postal code of the duplicate listing, joined into one string.
addressMatchesbooleanoptional
Whether the duplicate's address matches this location's own address.
phonestringoptional
Phone number as it appears on the duplicate listing.
phoneMatchesbooleanoptional
Whether the duplicate's phone number matches this location's own phone number.
matchScorenumberoptional
Model confidence, 0–1, that this is the same business as the real listing, or null if unscored.
duplicateUrlstringoptional
Live URL of the duplicate listing, or null.
statusstring (potential | flagged | deleted | failed)optional
One of: potential, flagged, deleted, failed.
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
404The resource wasn't found, or doesn't belong to your agency.
429Too many requests. Retry after the number of seconds in the Retry-After header.
get/api/v1/listings/duplicates
Your API key
locationId *
clientId
status
{
  "data": {
    "found": true,
    "yourListing": {
      "name": "Acme Dental — Downtown",
      "address": "123 Main St, Austin, TX 78701",
      "phone": "+15125551234"
    },
    "counts": {
      "potential": 2,
      "flagged": 1,
      "deleted": 0,
      "failed": 0
    },
    "groups": [
      {
        "publisherId": "yelp",
        "publisherName": "Yelp",
        "status": "potential",
        "duplicates": [
          {
            "id": "dup_1",
            "name": "Acme Dental Downtown",
            "address": "123 Main St, Austin, TX",
            "phone": "+15125551234",
            "url": "https://yelp.com/biz/acme-dental-downtown",
            "matchScore": 0.92
          }
        ]
      }
    ]
  }
}