Synupv1
Schlüssel erstellen
v1Ressourcen/Duplicate Listings/getDoppelte Listings für einen Standort abrufen

Doppelte Listings für einen Standort abrufen

Liefert für einen Standort erkannte doppelte Listings, gruppiert nach Publisher, mit Anzahlen je Status.

get/api/v1/listings/duplicates
listings:read
Query-Parameter
locationIdstringerforderlich
Der abzurufende Standort. Erforderlich.
clientIdstringoptional
Der Kunde des Standorts. Nur zur Eindeutigkeit nötig, wenn Ihr Schlüssel auf bestimmte Kunden beschränkt ist.
statusstring (potential | flagged | deleted | failed)optional
Ergebnisse auf einen Status beschränken: potential, flagged, deleted oder failed. Die Anzahlen werden unabhängig von diesem Filter immer für jeden Status zurückgegeben.
Antwort
dataobjectoptional
foundbooleanoptional
Ob der Standort gefunden und für diesen Schlüssel zugänglich war.
yourListingobjectoptional
Der eigene Name, die eigene Adresse und die eigene Telefonnummer dieses Standorts, zum Vergleich mit jeder Duplikat-Zeile. Fehlt, wenn found false ist.
namestringoptional
Der eigene Firmenname dieses Standorts.
addressstringoptional
Die eigene Adresse dieses Standorts.
phonestringoptional
Die eigene Telefonnummer dieses Standorts.
countsobjectoptional
Anzahl doppelter Listings für diesen Standort, je Status.
potentialnumberoptional
Anzahl der auf Prüfung wartenden Duplikate.
flaggednumberoptional
Anzahl der zur Entfernung markierten Duplikate.
deletednumberoptional
Anzahl der erfolgreich entfernten Duplikate.
failednumberoptional
Anzahl der Duplikate, deren Entfernungsversuch fehlgeschlagen ist.
groupsarray of objectoptional
Doppelte Listings, gruppiert nach Publisher.
publisherIdstringoptional
Kennung des Verzeichnisses/Publishers (dessen Site-URL).
publisherNamestringoptional
Anzeigename des Publishers.
originalUrlstringoptional
Live-URL des eigenen, echten Listings dieses Standorts bei diesem Publisher, oder null.
rowsarray of objectoptional
Die bei diesem Publisher gefundenen doppelten Listings.
idstringoptional
Eindeutige Kennung dieser Duplicate-Listing-Zeile.
businessNamestringoptional
Firmenname, wie er auf dem doppelten Listing erscheint.
businessNameMatchesbooleanoptional
Ob der Firmenname des Duplikats mit dem eigenen Namen dieses Standorts übereinstimmt.
addressstringoptional
Straße, Stadt und Postleitzahl des doppelten Listings, zu einer Zeichenfolge zusammengefügt.
addressMatchesbooleanoptional
Ob die Adresse des Duplikats mit der eigenen Adresse dieses Standorts übereinstimmt.
phonestringoptional
Telefonnummer, wie sie auf dem doppelten Listing erscheint.
phoneMatchesbooleanoptional
Ob die Telefonnummer des Duplikats mit der eigenen Telefonnummer dieses Standorts übereinstimmt.
matchScorenumberoptional
Modellvertrauen, 0–1, dass es sich um dasselbe Unternehmen wie beim echten Listing handelt, oder null, falls nicht bewertet.
duplicateUrlstringoptional
Live-URL des doppelten Listings, oder null.
statusstring (potential | flagged | deleted | failed)optional
Einer von: potential, flagged, deleted, failed.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
get/api/v1/listings/duplicates
Ihr API-Schlüssel
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
          }
        ]
      }
    ]
  }
}