/api/v4/locations/listings/mark-as-not-duplicateMarcar una ficha como no duplicada
Descarta uno o varios posibles duplicados como falsos positivos para que dejen de aparecer en la lista de duplicados.
Parámetros
Cuerpo
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| input.listingItemIds | array | obligatorio | Array of base64-encoded listing item IDs to dismiss as not duplicates. Use the `listingItemId` values from the duplicate-listings endpoints. |
| input.locationId | string | opcional | Location that owns the listing items (base64-encoded Relay ID or raw numeric ID). Scopes the operation to a single location. |
Solicitud de ejemplo
Cuerpo listo para pegar. Sustituye los ID y valores de ejemplo por los tuyos.
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="] }}Respuestas
200Listing items dismissed as not duplicates. On failure, `success` is `false` and `errors` describes why.
{ "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.
Descarta posibles duplicados como falsos positivos. Una vez descartados, los elementos se marcan como no duplicados confirmados y dejan de aparecer en Obtener fichas duplicadas de una ubicación o en el resumen de toda la cuenta. Rellena listingItemIds con los valores de listingItemId de esos endpoints.
Caso de uso: eliminar falsos positivos de la cola
La detección es conservadora y marcará fichas legítimas que simplemente parezcan similares (un segundo perfil válido, otro establecimiento de la misma franquicia, una ubicación cuyo nombre ha cambiado). Cuando una persona que revisa las entradas confirme que una de ellas es la ficha correcta, descártala para que deje de saturar la cola de duplicados:
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="] }}listingItemIds es obligatorio y acepta varios IDs: agrupa todos los falsos positivos de una ubicación en una sola llamada. Un 200 con success: true confirma que se han descartado; success: false o un 400 devuelve un array errors con datos que puedes inspeccionar.
Caso de uso: la operación inversa a la supresión
Este endpoint es la contraparte de Marcar una ficha como duplicada y acepta exactamente la misma estructura del cuerpo; úsalo para revertir la marca de un elemento señalado por error. Ambas son operaciones de escritura que cuentan para el límite de solicitudes de la cuenta, así que prioriza las solicitudes por lotes frente a las solicitudes por elemento.
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=" ] } }'