Skip to content
SynupAPI
Get an API key
GETapi.synup.com/api/v4/locations/listings/duplicates

Get all duplicate listings for an account

This API retrieves a paginated list of all duplicate listings detected within the account, with optional filtering

Requires an API key. Send it as Authorization: API <your-key> — see Getting started.

Parameters

Query

NameTypeRequiredDescription
tagstringoptionalFilter duplicates by location tag
pageintegeroptionalPage number for pagination

Headers

NameTypeRequiredDescription
Content-Typestringrequired

Request

Request
curl -X GET 'https://api.synup.com/api/v4/locations/listings/duplicates?tag=&page=' \
  -H 'Authorization: API YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Responses

StatusDescription
200Duplicate listings retrieved successfully
400Bad request - invalid parameters
401Unauthorized - invalid or missing API key
403Forbidden - insufficient permissions
Example response
{
  "data": {
    "duplicateListingsRollup": {
      "pageInfo": {
        "hasNextPage": true,
        "hasPreviousPage": false,
        "totalPages": 2,
        "totalRecords": 89
      },
      "records": [
        {
          "addressValid": false,
          "categoryValid": null,
          "city": "Chicago",
          "countryCode": null,
          "duplicateProcessingState": "POTENTIAL",
          "id": "43843437",
          "liveLink": "https://www.judysbook.com/Buffalo-Wild-Wings-Restaurants-chicago-r14401354.htm",
          "locationId": "203040",
          "name": "Buffalo Wild Wings",
          "nameValid": true,
          "originalLiveLink": "https://www.judysbook.com/Buffalo-Wild-Wings-BtoB%7eAccountants-Business-chicago-r39915056.htm",
          "phone": "--- '7738689453'\n",
          "phoneValid": true,
          "postalCode": "60614",
          "siteName": "Judys Book",
          "siteUrl": "judysbook.com",
          "state": "IL",
          "street": "2464 North Lincoln Avenue"
        }
      ]
    }
  }
}

Response body

NameTypeRequiredDescription
dataobjectoptional
data.duplicateListingsRollupobjectoptional
data.duplicateListingsRollup.pageInfoobjectoptional
data.duplicateListingsRollup.pageInfo.hasNextPagebooleanoptionalIndicates if there are more pages after the current one
data.duplicateListingsRollup.pageInfo.hasPreviousPagebooleanoptionalIndicates if there are previous pages
data.duplicateListingsRollup.pageInfo.totalPagesintegeroptionalTotal number of pages available
data.duplicateListingsRollup.pageInfo.totalRecordsintegeroptionalTotal number of duplicate listings
data.duplicateListingsRollup.recordsarray of objectoptional
data.duplicateListingsRollup.records[].addressValidbooleanoptionalIndicates if the address matches the primary listing
data.duplicateListingsRollup.records[].categoryValidbooleanoptionalIndicates if the business category matches
data.duplicateListingsRollup.records[].citystringoptionalCity name
data.duplicateListingsRollup.records[].countryCodestringoptionalISO country code
data.duplicateListingsRollup.records[].duplicateProcessingStatestringoptionalCurrent state of duplicate processing
POTENTIAL
data.duplicateListingsRollup.records[].idstringoptionalUnique identifier for the duplicate listing
data.duplicateListingsRollup.records[].liveLinkstringoptionalURL of the duplicate listing
data.duplicateListingsRollup.records[].locationIdstringoptionalID of the associated location
data.duplicateListingsRollup.records[].namestringoptionalBusiness name
data.duplicateListingsRollup.records[].nameValidbooleanoptionalIndicates if the business name matches
data.duplicateListingsRollup.records[].originalLiveLinkstringoptionalURL of the primary listing
data.duplicateListingsRollup.records[].phonestringoptionalPhone number
data.duplicateListingsRollup.records[].phoneValidbooleanoptionalIndicates if the phone number matches
data.duplicateListingsRollup.records[].postalCodestringoptionalPostal/ZIP code
data.duplicateListingsRollup.records[].siteNamestringoptionalName of the directory site
data.duplicateListingsRollup.records[].siteUrlstringoptionalBase URL of the directory site
data.duplicateListingsRollup.records[].statestringoptionalState/province code
data.duplicateListingsRollup.records[].streetstringoptionalStreet address