POST/api/v4/locations/listings/mark-as-not-duplicate

Marquer une fiche comme n’étant pas un doublon

Écarte un ou plusieurs doublons potentiels en tant que faux positifs afin qu’ils n’apparaissent plus dans la liste des doublons.

Nécessite une clé API. Consultez Authentification pour le format de l’en-tête et la rotation des clés.

Paramètres

Corps

NomTypeObligatoireDescription
input.listingItemIdsarrayobligatoireArray of base64-encoded listing item IDs to dismiss as not duplicates. Use the `listingItemId` values from the duplicate-listings endpoints.
input.locationIdstringfacultatifLocation that owns the listing items (base64-encoded Relay ID or raw numeric ID). Scopes the operation to a single location.

Exemple de requête

Corps prêt à coller. Remplacez les identifiants et valeurs d’exemple par les vôtres.

Request body
{  "input": {    "locationId": "TG9jYXRpb246MTgwMDI4OQ==",    "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="]  }}

Réponses

200Listing items dismissed as not duplicates. On failure, `success` is `false` and `errors` describes why.
Response
{  "data": {    "markAsNotDuplicate": {      "success": true,      "errors": null    }  }}
400Validation error, e.g. an unknown or malformed listing item ID. See the `errors` array (`code`, `message`, `path`).
401Unauthenticated, missing or invalid API key.

Écarte les doublons potentiels en tant que faux positifs. Une fois écartés, les éléments sont marqués comme des non-doublons confirmés et n’apparaissent plus dans Obtenir les fiches en double pour un établissement ni dans le récapitulatif à l’échelle du compte. Renseignez listingItemIds avec les valeurs listingItemId provenant de ces endpoints.

Cas d’utilisation : retirer les faux positifs de la file d’attente

La détection est prudente et signale des fiches légitimes qui se ressemblent simplement (un second profil valide, un autre établissement de la même franchise, un établissement renommé). Lorsqu’une personne chargée de la vérification confirme qu’une entrée correspond à la bonne fiche, écartez-la afin qu’elle cesse d’encombrer la file d’attente des doublons :

JSON
{  "input": {    "locationId": "TG9jYXRpb246MTgwMDI4OQ==",    "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="]  }}

listingItemIds est obligatoire et accepte plusieurs ID : regroupez tous les faux positifs d’un établissement dans un seul appel. Un 200 avec success: true confirme que les éléments ont été écartés ; success: false ou un 400 renvoie un tableau errors non vide à examiner.

Cas d’utilisation : l’inverse de la suppression

Cet endpoint est le pendant de Marquer une fiche comme doublon et accepte un corps de requête de structure identique ; utilisez-le pour annuler le signalement d’un élément effectué par erreur. Les deux sont des opérations d’écriture qui sont comptabilisées dans la limite de débit du compte ; privilégiez donc le traitement par lots plutôt que les requêtes individuelles.

Request
curl -X POST 'https://listingsapi.com/api/v4/locations/listings/mark-as-not-duplicate' \  -H "Authorization: API $LISTINGSAPI_KEY" \  -H 'Content-Type: application/json' \  -d '{    "input": {      "locationId": "TG9jYXRpb246MTgwMDI4OQ==",      "listingItemIds": [        "TGlzdGluZ0l0ZW06MjM1OTg0NTA="      ]    }  }'