v0.2.0-beta

OpenAPI 3.1.0

Google Play: App-Wettbewerber (Live)

Felo API Support

MIT

Server

https://openapi.felo.ai

Client-Bibliotheken

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operationen

post/v1/beta/dataforseo/dataforseo_labs/google/app_competitors/live

Google Play: App-Wettbewerber (Live)

Google-Play-Apps, die mit einer bestimmten App um gemeinsame Keywords konkurrieren. Blättern mit limit, offset und offset_token; jenseits der ersten Seiten verwenden Sie das Token. Eingebettet in das DataForSEO-Envelope: Daten in tasks[0].result, Ergebnis in tasks[0].status_code – eine abgelehnte Anfrage liefert weiterhin HTTP 200. Das Apple-Pendant ist post_dataforseo_labs_apple_app_competitors_live. Für die Keywords hinter der Überschneidung verwenden Sie post_dataforseo_labs_google_app_intersection_live.

Preisreferenz

Abrechnung: Gemeldete Antwortkosten.
Referenzschätzung pro Anfrage: USD 0.1356.
Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf bereits abgerechnete Kundenbeträge anwenden.

Nur Referenzmetadaten, kein Kontenangebot und keine garantierte Preis- oder Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.

Body

application/json

Typ: array (object | null)[]
- app_id
  Typ: string
  
  ID der App
  Pflichtfeld
  ID der mobilen Anwendung bei Google Play;
  Die ID finden Sie in der URL jeder bei Google Play gelisteten App;
  Beispiel:
  in der URL https://play.google.com/store/apps/details?id=org.telegram.messenger
  ist die ID org.telegram.messenger
- filters
  Typ: array (object | null)[] | null
  
  Array der Filterparameter für Ergebnisse
  Optionales Feld
  Sie können mehrere Filter gleichzeitig hinzufügen (maximal 8 Filter)
  Zwischen den Bedingungen setzen Sie einen logischen Operator and oder or
  Die folgenden Operatoren werden unterstützt:
  <, <=, >, >=, =, <>, in, not_in
  Beispiel:
  ["intersections",">",500]
  
  [["competitor_metrics.google_play_search_organic.pos_1","<>",10],"and",["avg_position",">=","10"]]
  
  [[["intersections",">=",50],"and",["competitor_metrics.google_play_search_organic.pos_1","in",[1,5]]], "or", ["sum_position",">=","10000"]]
  
  Weitere Informationen zu Filtern finden Sie unter Dataforseo Labs - Filters oder in dieser Anleitung im Help Center
  
  Leeres Objekt
- language_code
  Typ: string | null
  
  Sprachcode
  Pflichtfeld, wenn Sie language_name nicht angeben
  Hinweis: Sie müssen entweder language_name oder language_code angeben
  Die Liste der verfügbaren Sprachen mit language_code erhalten Sie durch eine separate Anfrage an
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Hinweis: Dieser Endpunkt unterstützt derzeit nur die englische Sprache
  Beispiel:
  en
- language_name
  Typ: string
  
  vollständiger Name der Sprache
  Pflichtfeld, wenn Sie language_code nicht angeben
  Hinweis: Sie müssen entweder language_name oder language_code angeben
  Die Liste der verfügbaren Sprachen mit language_name erhalten Sie durch eine separate Anfrage an
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Hinweis: Dieser Endpunkt unterstützt derzeit nur die englische Sprache;
  Beispiel:
  English
- limit
  Typ: integer | null
  
  maximale Anzahl der zurückgegebenen Apps
  Optionales Feld
  Standardwert: 100
  Höchstwert: 1000
- location_code
  Typ: integer
  
  Standortcode
  Pflichtfeld, wenn Sie location_name nicht angeben
  Hinweis: Sie müssen entweder location_name oder location_code angeben
  Die Liste der verfügbaren Standorte mit location_code erhalten Sie durch eine separate Anfrage an
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Hinweis: Dieser Endpunkt unterstützt derzeit nur den Standort USA;
  Beispiel:
  2840
- location_name
  Typ: string
  
  vollständiger Name des Standorts
  Pflichtfeld, wenn Sie location_code nicht angeben
  Hinweis: Sie müssen entweder location_name oder location_code angeben
  Die Liste der verfügbaren Standorte mit location_name erhalten Sie durch eine separate Anfrage an
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Hinweis: Dieser Endpunkt unterstützt derzeit nur den Standort USA;
  Beispiel:
  United States
- offset
  Typ: integer | null
  
  Offset im Ergebnisarray der zurückgegebenen Apps
  Optionales Feld
  Standardwert: 0
  Wenn Sie den Wert 10 angeben, werden die ersten zehn Apps im Ergebnisarray ausgelassen und die Daten für die nachfolgenden Keywords bereitgestellt
- order_by
  Typ: array string[] | null
  
  Sortierregeln für Ergebnisse
  Optionales Feld
  Sie können dieselben Werte wie im Array filters verwenden, um die Ergebnisse zu sortieren;
  mögliche Sortierarten:
  asc – Ergebnisse werden in aufsteigender Reihenfolge sortiert;
  desc – Ergebnisse werden in absteigender Reihenfolge sortiert;
  Sie legen eine Sortierart mit einem Komma fest;
  Beispiel:
  ["intersections,asc"]
  Hinweis: Sie können pro Anfrage höchstens drei Sortierregeln festlegen;
  Mehrere Sortierregeln trennen Sie mit einem Komma;
  Beispiel:
  ["intersections,desc","sum_position,asc"]
  
  Standardregel:
  ["intersections,desc"]
  Hinweis: Enthält das Array item_types andere Elementtypen als organic, werden die Ergebnisse nach dem ersten Elementtyp im Array geordnet
- tag
  Typ: string | null
  
  Benutzerdefinierte Aufgaben-ID
  Optionales Feld
  Zeichenlimit: 255
  Mit diesem Parameter können Sie die Aufgabe identifizieren und dem Ergebnis zuordnen
  Den angegebenen Wert tag finden Sie im data-Objekt der Antwort

Antworten

200
Typ: object | null · Response36Afe1097B20_DataforseoLabsGoogleAppCompetitorsLiveResponseInfo
cost
Typ: number | null Format: double

Gesamtkosten der Aufgaben in USD

status_code
Typ: integer | null

allgemeiner Statuscode die vollständige Liste der Antwortcodes finden Sie hier

status_message
Typ: string | null

allgemeine Informationsmeldung die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier

tasks
Typ: array (object | null)[] | null

Array von Aufgaben

Typ: object | null · Response36Afe1097B20_DataforseoLabsGoogleAppCompetitorsLiveTaskInfo
cost
Typ: number | null Format: double

Gesamtkosten der Aufgaben in USD

data
Typ: object | null

Enthält dieselben Parameter, die Sie in der POST-Anfrage angegeben haben

propertyName
Typ: object | null
id
Typ: string | null

Aufgaben-ID eindeutige Aufgaben-ID in unserem System im UUID-Format

path
Typ: array (string | null)[] | null

URL-Pfad

result
Typ: array (object | null)[] | null

Array von Ergebnissen

app_id
Typ: string | null

ID der App in einem POST-Array

items
Typ: array (object | null)[] | null

enthält Daten zu app_id und Wettbewerber-Apps

app_id
Typ: string | null

ID der App in einem POST-Array

avg_position
Typ: number | null Format: float

durchschnittliche Position der App in der Google-Play-SERP
Hinweis: die durchschnittliche Position wird nur für überschneidende Keywords berechnet;
der Wert für eine bestimmte Anwendung kann in Kombination mit anderen Zielanwendungen abweichen

competitor_metrics
Typ: object | null

Metriken für überschneidende Keywords
Rankingdaten zu den Keywords, die die angegebene Wettbewerber-Anwendung mit der App in einer POST-Anfrage teilt;
Hinweis: in diesem Array werden Rankingdaten für die app_id des zurückgegebenen Wettbewerbers bereitgestellt

propertyName
Typ: object · Response36Afe1097B20_AppMetricsInfo
count
Typ: integer | null Format: int64

Gesamtzahl der organischen Amazon SERPs, die das Produkt enthalten

pos_1
Typ: integer | null

Anzahl der organischen SERPs, in denen das Produkt auf Platz 1 rangiert

pos_11_100
Typ: integer | null

Anzahl der organischen SERPs, in denen das Produkt auf Platz 11-100 rangiert

pos_2_3
Typ: integer | null

Anzahl der organischen SERPs, in denen das Produkt auf Platz 2-3 rangiert

pos_4_10
Typ: integer | null

Anzahl der organischen SERPs, in denen das Produkt auf Platz 4-10 rangiert

search_volume
Typ: integer | null Format: int64

Gesamtsuchvolumen der Ranking-Keywords des Produkts in der organischen SERP

full_metrics
Typ: object | null

Metriken für alle Keywords der Anwendung
vollständige Übersicht der Rankingdaten zu allen Keywords, für die die angegebene app_id rankt

propertyName
Typ: object · Response36Afe1097B20_AppMetricsInfo
count
Typ: integer | null Format: int64

Gesamtzahl der organischen Amazon SERPs, die das Produkt enthalten

pos_1
Typ: integer | null

Anzahl der organischen SERPs, in denen das Produkt auf Platz 1 rangiert

pos_11_100
Typ: integer | null

Anzahl der organischen SERPs, in denen das Produkt auf Platz 11-100 rangiert

pos_2_3
Typ: integer | null

Anzahl der organischen SERPs, in denen das Produkt auf Platz 2-3 rangiert

pos_4_10
Typ: integer | null

Anzahl der organischen SERPs, in denen das Produkt auf Platz 4-10 rangiert

search_volume
Typ: integer | null Format: int64

Gesamtsuchvolumen der Ranking-Keywords des Produkts in der organischen SERP

intersections
Typ: integer | null

Anzahl der überschneidenden Keywords

se_type
Typ: string | null

Typ der Suchmaschine

sum_position
Typ: integer | null

Summe aller App-Positionen in der Google-Play-SERP
Hinweis: die Summenposition wird nur für überschneidende Keywords berechnet;
der Wert für eine bestimmte Anwendung kann in Kombination mit anderen Zielanwendungen abweichen

items_count
Typ: integer | null Format: int64

die Anzahl der im Array items zurückgegebenen Ergebnisse

language_code
Typ: string | null

Sprachcode in einem POST-Array

location_code
Typ: integer | null

Standortcode in einem POST-Array

se_type
Typ: string | null

Typ der Suchmaschine

total_count
Typ: integer | null Format: int64

Gesamtmenge der für Ihre Anfrage relevanten Ergebnisse in unserer Datenbank

result_count
Typ: integer | null Format: int64

Anzahl der Elemente im Ergebnis-Array

status_code
Typ: integer | null

Statuscode der Aufgabe von DataForSEO erzeugt, kann im folgenden Bereich liegen: 10000-60000 die vollständige Liste der Antwortcodes finden Sie hier

status_message
Typ: string | null

Informationsmeldung der Aufgabe die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier

time
Typ: string | null

Ausführungszeit in Sekunden

tasks_count
Typ: integer | null Format: int64

Die Anzahl der Aufgaben im tasks-Array

tasks_error
Typ: integer | null Format: int64

Die Anzahl der Aufgaben im tasks-Array, die mit einem Fehler zurückgegeben wurden

time
Typ: string | null

Gesamtausführungszeit, Sekunden

version
Typ: string | null

Die aktuelle Version der API
application/json
400

Die Anfrage konnte nicht verarbeitet werden. Prüfen Sie die Anfrageparameter.
401

Ein gültiger Felo-API-Schlüssel ist erforderlich.
402

Die Anfrage kann nicht fortgesetzt werden, da eine Abrechnungsvoraussetzung nicht erfüllt ist.
403

Das Konto ist für diesen Vorgang nicht berechtigt.
429

Ein Anfrage- oder Ausgabenlimit wurde erreicht.
502

Der Dienst konnte die Anfrage nicht abschließen.
503

Die API oder der Abrechnungsdienst ist vorübergehend nicht verfügbar.
504

Beim Verarbeiten der Anfrage ist eine Zeitüberschreitung aufgetreten.
default

Fehlerantwort; Upstream-Passthrough-Antworten können Anbieterformate verwenden

application/json

post/v1/beta/dataforseo/dataforseo_labs/google/app_competitors/live

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/app_competitors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "app_id": "org.telegram.messenger",
    "language_name": "English",
    "location_code": 2840,
    "limit": 10
  }
]'

Schema anzeigen

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "se_type": null,
          "app_id": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "app_id": null,
              "avg_position": null,
              "sum_position": null,
              "intersections": null,
              "competitor_metrics": null,
              "full_metrics": null
            }
          ]
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

Google Play: App-Wettbewerber (Live)

AuthentifizierungRequired

DataForSEO

Google Play: App-Wettbewerber (Live)

Preisreferenz