v1Ressources/Fiches publiées/getObtenir les problèmes de fiches
Obtenir les problèmes de fiches
Les problèmes affichés dans la vue d'ensemble des fiches, sous forme de données. Chaque problème correspond à une correction (une modification, une connexion ou une étape hors de l'application) et indique les fiches de publishers que cette correction débloquerait. Avec locationId, renvoie tous les problèmes de cet emplacement. Sans lui, renvoie une synthèse sur les emplacements de votre clé, éventuellement limitée à un client et à un tag, lue par pages d'emplacements : répétez l'appel avec cursor égal à page.nextCursor et les mêmes autres paramètres jusqu'à ce que page.nextCursor soit null. Lecture seule.
get
listings:read/api/v1/listings/issuesParamètres de requête
locationIdstringfacultatif
Lit les problèmes d'un emplacement, par son id ou son id public loc_. Omettez-le pour une synthèse sur plusieurs emplacements.
clientIdstringfacultatif
Limite la lecture aux emplacements d'un client.
tagstringfacultatif
Limite la synthèse aux emplacements portant ce nom de tag. Ignoré lorsque locationId est fourni.
problemstringfacultatif
Clés de problème séparées par des virgules à inclure, par exemple phone,hours. Une clé inconnue renvoie 400 avec code invalid_problem.
familystringfacultatif
Familles de problèmes séparées par des virgules à inclure : access, identity, hours, content, media, map ou other. Une famille inconnue renvoie 400 avec code invalid_family.
qstringfacultatif
Recherche dans la synthèse par nom d'emplacement, sans tenir compte de la casse, jusqu'à 100 caractères.
cursorstringfacultatif
Le page.nextCursor de la réponse précédente, pour poursuivre une synthèse. Envoyez-le avec les mêmes autres paramètres : un curseur émis pour un autre périmètre ou filtre renvoie 400 avec code cursor_scope_mismatch.
Réponse
dataobjectfacultatif
scopeobjectobligatoire
kindstring (location | rollup)facultatif
keystringfacultatif
clientIdstringfacultatif
tagstringfacultatif
locationIdstringfacultatif
requestedLocationIdstringfacultatif
filtersobjectfacultatif
problemsarray of stringfacultatif
familiesarray of stringfacultatif
qstringfacultatif
generatedAtstringobligatoire
completebooleanobligatoire
True uniquement lorsque cette seule réponse a couvert tous les emplacements du périmètre. Dans ce cas totals est exact ; sinon totals est null.
totalsobjectobligatoire
fixesintegerobligatoire
Corrections distinctes. Une reconnexion de compte partagé compte une seule fois, quel que soit le nombre d'emplacements couverts.
affectedListingsintegerobligatoire
locationsWithIssuesintegerobligatoire
pageCountsobjectobligatoire
fixesintegerobligatoire
Corrections distinctes. Une reconnexion de compte partagé compte une seule fois, quel que soit le nombre d'emplacements couverts.
affectedListingsintegerobligatoire
locationsWithIssuesintegerobligatoire
pageobjectobligatoire
scopeLocationsintegerfacultatif
scannedLocationsintegerfacultatif
previouslyScannedintegerfacultatif
nextCursorstringfacultatif
Passez-le comme cursor, avec les mêmes autres paramètres, pour lire la page suivante d'emplacements. Null lorsqu'il n'y a plus de pages.
lastPagebooleanfacultatif
noticestring (archived | not_a_listing_location)obligatoire
issuesarray of objectobligatoire
idstringobligatoire
fixKeystringobligatoire
groupKeystringobligatoire
locationIdstringobligatoire
locationPublicIdstringfacultatif
locationNamestringfacultatif
locationCitystringfacultatif
clientIdstringfacultatif
clientNamestringfacultatif
problemstringobligatoire
Ce qui ne va pas, sous forme de clé de problème stable, par exemple phone ou reconnect_google.
familystring (access | identity | hours | content | media | map | other)obligatoire
tierinteger (1 | 2 | 3)obligatoire
statestring (open | update_in_flight | update_saved)obligatoire
reasonKeystringfacultatif
fixobjectobligatoire
L'action qui résout ce problème. kind indique laquelle : edit (un champ dans l'éditeur d'emplacement), connect, account (renouveler le même compte), verify (sur Google), external (une étape sur un autre site) ou explain (aucune correction dans l'application).
kindstring (edit | connect | account | verify | external | explain)obligatoire
sectionstring (identity | hours | description | social | media | businessDetails | openStatus | actionLinks | serviceArea | services | attributes | relationships | pin)facultatif
fieldstring (name | address | phone | website | primaryCategory | publisherCategory | hours | openingDate | openStatus | description | socialLinks | menuUrl | photos | serviceArea | services | attributes | relationships | coordinates)facultatif
tabstring (master | google | facebook | apple | bing)facultatif
providerstring (google | facebook | apple)facultatif
flowstring (renew)facultatif
accountobjectfacultatif
launchobjectfacultatif
targetobjectfacultatif
nextstring (contact_support | review_details | no_in_app_fix)facultatif
capabilityobjectobligatoire
allowedbooleanobligatoire
reasonstring (write_not_permitted | portal_not_permitted | field_not_portal_editable | clients_module_denied | agency_credential_requires_unrestricted_member | credential_serves_other_clients | account_unresolved | missing_api_scope)obligatoire
alternativesarray of objectfacultatif
fixobjectfacultatif
L'action qui résout ce problème. kind indique laquelle : edit (un champ dans l'éditeur d'emplacement), connect, account (renouveler le même compte), verify (sur Google), external (une étape sur un autre site) ou explain (aucune correction dans l'application).
capabilityobjectfacultatif
publishersarray of objectobligatoire
publisherIdstringfacultatif
publisherNamestringfacultatif
siteIdintegerfacultatif
affectedListingsintegerobligatoire
evidenceAtstringfacultatif
groupsarray of objectobligatoire
groupKeystringfacultatif
problemstringfacultatif
familystringfacultatif
tierintegerfacultatif
accountobjectfacultatif
keystringobligatoire
Une clé opaque et stable pour l'identifiant du compte. Regroupez selon cette clé, jamais selon le libellé.
labelstringobligatoire
agencyManagedbooleanobligatoire
locationsarray of objectfacultatif
locationIdstringfacultatif
locationPublicIdstringfacultatif
locationNamestringfacultatif
locationCitystringfacultatif
clientIdstringfacultatif
clientNamestringfacultatif
issueIdstringfacultatif
problemstringfacultatif
statestring (open | update_in_flight | update_saved)facultatif
affectedListingsintegerfacultatif
fixesintegerfacultatif
affectedListingsintegerfacultatif
affectedLocationsintegerfacultatif
Erreurs
400La requête n'est pas valide. code en indique la raison : invalid_cursor, cursor_scope_mismatch, invalid_problem, invalid_family ou search_too_long.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
get/api/v1/listings/issues
Votre clé API
locationId
clientId
tag
problem
family
q
cursor
{}Guides qui utilisent cette ressource
- What Is a Business Listings API?A business listings API manages a business's name, address, hours and more across many publishers at once, with sync status and duplicate detection built in.
- Business Listings API: Complete Developer GuideHow a business listings API works and how to create, update, sync and monitor locations across Google, Apple, Bing and directories with the Synup API.
- Google Business Profile API vs a Listings Management APIHow Google's Business Profile API compares with a listings management API on scope, access, sync status, duplicates and reviews, and when to use each.
- How to Add Local Marketing Features to Your SaaSAdd listings management, reviews, Google posts, profile analytics, rank tracking and AI visibility to a SaaS product with the Synup API, tenant by tenant.
- How to Manage Business Listings ProgrammaticallyKeep business listings accurate from your own system with the Synup API. Covers change detection, idempotent updates, hours, photos and sync reporting.
- What Is an AEO API?An AEO API measures how AI answer engines like ChatGPT, Gemini and Perplexity describe and recommend a business, and tracks that visibility over time.
- How to Update Business Information Across Google, Apple, Bing and DirectoriesPush one business-information change to Google, Apple, Bing and the directory network through a single API call, and verify it reached each publisher.
- How Listing Syndication WorksListing syndication takes one business record, translates it into each publisher's format, and pushes it out asynchronously, which is why sync status matters.
- How to Build an AI Agent for Local SEOBuild an AI agent that audits and fixes listings, tracks local rankings, checks AI visibility and drafts review replies with Synup's MCP server or REST tools.
- How to Manage Thousands of Business Locations via APIDesign a sync job for thousands of locations on the Synup API with cursor pagination, tags, rate-limit handling, an id map and rollup health checks.
- How to Find and Remove Duplicate Business ListingsDetect duplicate business listings across publishers, review them by confidence, and flag them for removal or dismiss them with the Synup API.
- How Duplicate Listing Suppression WorksDuplicate suppression detects listings that look like the same business, scores them by confidence, and requests removal from the publisher that controls them.
- How to Build a Multi-Location Marketing DashboardBuild a multi-location marketing dashboard from the API's rollup endpoints, one call per panel, covering listings, reviews, rank, AI visibility and duplicates.
- How to Connect and Manage Google Business Profiles via APIConnect a Google Business Profile to a location, match the account's listings, keep the profile in sync and handle reconnects with the Synup API.
- Building Publisher Integrations Directly vs Using SynupWhat it really costs to integrate Google, Apple, Bing and directories yourself, versus one API, and how to decide between them or combine both.
- Local SEO APIs: What Developers Actually NeedA practical checklist of what a local SEO API must cover, from listings and sync status to reviews, rank tracking and AI visibility, mapped to endpoints.
- How to Track Local Rankings with an APITrack local search rankings on a geo grid through an API, add keywords, read the grid and trend, and compare against competitors and citation coverage.
- How to Monitor Local SEO Across Multiple LocationsMonitor local SEO across hundreds of locations through rollup endpoints, with rank and AI visibility per location and the weakest surfaced first.