Synupv1
Schlüssel erstellen
v1Ressourcen/SEO/getWettbewerber-Rangliste eines Standorts abrufen

Wettbewerber-Rangliste eines Standorts abrufen

Liefert die Unternehmen, die das Ranking-Raster dieses Standorts für sein zuletzt verfolgtes Keyword dominieren, gerankt danach, wie viel des Rasters sie in den Top 3 belegen. Enthält das eigene Unternehmen (isYou) zum Vergleich und markiert Einträge, die bereits in Ihrer Wettbewerber-Verfolgungsliste stehen, mit deren Registrierungs-ID.

get/api/v1/seo/competitors
seo:read
Query-Parameter
locationIdstringerforderlich
Der abzurufende Standort.
clientIdstringoptional
Der Kunde des Standorts.
Antwort
dataobjectoptional
countnumberoptional
Anzahl der zurückgegebenen Wettbewerber.
competitorsarray of objectoptional
Die Wettbewerber-Rangliste, einschließlich des eigenen Unternehmens.
idstringoptional
Eine Kennung für dieses Unternehmen (seine Place-ID oder ein abgeleiteter Schlüssel, wenn keine Place-ID verfügbar ist).
competitorIdstringoptional
ID in Ihrer Wettbewerber-Verfolgungsliste, nur vorhanden, wenn dieses Unternehmen dort bereits erfasst ist.
namestringoptional
Firmenname.
isYoubooleanoptional
Ob diese Zeile das eigene Unternehmen ist.
ratingnumberoptional
Sternebewertung, oder null.
reviewCountnumberoptional
Anzahl der Bewertungen, oder null.
avgRanknumberoptional
Durchschnittlicher Rang über die Rasterpunkte, an denen dieses Unternehmen erschien, oder null.
top3Pctnumberoptional
Prozentsatz der Rasterpunkte, an denen dieses Unternehmen in den Top 3 rankt, gemittelt über alle verfolgten Keywords.
gridPointsnumberoptional
Anzahl der Rasterpunkte, an denen dieses Unternehmen erschien.
categorystringoptional
Unternehmenskategorie, oder null.
websitestringoptional
Website des Unternehmens, oder null (wird von der Datenquelle für die lokale Suche nicht zurückgegeben).
keywordBreakdownarray of objectoptional
Die Top-3-Abdeckung dieses Unternehmens, aufgeschlüsselt je verfolgtem Keyword.
keywordstringoptional
Das verfolgte Keyword.
top3Pctnumberoptional
Prozentsatz der Rasterpunkte dieses Keywords, an denen dieses Unternehmen in den Top 3 rankt.
featureComparisonarray of objectoptional
Merkmalsvergleichszeilen gegenüber Ihrem Unternehmen, falls vorhanden.
featurestringoptional
competitorbooleanoptional
youbooleanoptional
hoursComparisonarray of objectoptional
Vergleichszeilen der Öffnungszeiten gegenüber Ihrem Unternehmen, falls vorhanden.
daystringoptional
competitorstringoptional
youstringoptional
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.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
get/api/v1/seo/competitors
Ihr API-Schlüssel
locationId *
clientId
{
  "data": {
    "count": 2,
    "competitors": [
      {
        "id": "cm_comp_1",
        "competitorId": "cm_competitor_1",
        "name": "Acme Dental — Downtown",
        "isYou": true,
        "rating": 4.6,
        "reviewCount": 210,
        "avgRank": 4.2,
        "top3Pct": 44,
        "gridPoints": 25,
        "category": "Dentist",
        "website": "https://acmedental.example.com",
        "keywordBreakdown": [
          {
            "keyword": "dentist near me",
            "top3Pct": 60
          }
        ],
        "featureComparison": [
          {
            "feature": "Online booking",
            "competitor": false,
            "you": true
          }
        ],
        "hoursComparison": [
          {
            "day": "Monday",
            "competitor": "9am–5pm",
            "you": "8am–6pm"
          }
        ]
      }
    ]
  }
}