v0.2.0-beta

OpenAPI 3.1.0

Live-Aufgaben für „DataForSEO Trends Subregion Interests“ einstellen

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/keywords_data/dataforseo_trends/subregion_interests/live

Live-Aufgaben für „DataForSEO Trends Subregion Interests“ einstellen

Wo sich das Interesse an einem Keyword konzentriert, aufgeschlüsselt nach Subregion innerhalb von location_code. Eingebettet in die DataForSEO-Hülle: Daten in tasks[0].result, Ergebnis in tasks[0].status_code – eine abgelehnte Anfrage gibt dennoch HTTP 200 zurück. Für das Wer statt des Wo: post_dataforseo_keywords_trends_demography_live.

Preisreferenz

Abrechnung: Gemeldete Antwortkosten.
Referenzschätzung pro Anfrage: USD 0.0024.
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)[]
- date_from
  Typ: string | null
  
  Startdatum des Zeitraums
  Optionales Feld
  wenn Sie dieses Feld nicht angeben, wird standardmäßig der heutige Tag und Monat des Vorjahres verwendet
  Mindestwert für den Typ web: 2004-01-01
  Mindestwert für andere Typen: 2008-01-01
  Datumsformat: "yyyy-mm-dd"
  Beispiel:
  "2019-01-15"
- date_to
  Typ: string | null
  
  Enddatum des Zeitraums
  Optionales Feld
  wenn Sie dieses Feld nicht angeben, wird standardmäßig das heutige Datum verwendet
  Datumsformat: "yyyy-mm-dd"
  Beispiel:
  "2019-01-15"
- keywords
  Typ: array string[]
  
  Keywords
  Pflichtfeld
  maximale Anzahl der Keywords, die Sie angeben können: 5
  Symbole und Sonderzeichen vermeiden (z. B. UTF-Symbole, Emojis);
  bei Angabe nicht lateinischer Zeichen erhalten Sie Daten für die Länder, in denen sie verwendet werden
  
  Weitere Informationen zu Regeln und Einschränkungen der Felder keyword und keywords in DataForSEO-APIs finden Sie in diesem Help-Center-Artikel
- location_code
  Typ: integer | null
  
  Standortcode der Suchmaschine
  Optionales Feld
  Wenn Sie dieses Feld nicht verwenden, erhalten Sie globale Ergebnisse
  Wenn Sie dieses Feld verwenden, müssen Sie location_name nicht angeben
  Die Liste der verfügbaren Standorte der Suchmaschinen mit ihrem location_code erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
  Beachten Sie, dass die Daten für das Land bereitgestellt werden, zu dem der angegebene location_code gehört;
  Beispiel:
  2840
- location_name
  Typ: string | null
  
  Vollständiger Name des Suchmaschinenstandorts
  Optionales Feld
  Wenn Sie dieses Feld nicht verwenden, erhalten Sie globale Ergebnisse
  Wenn Sie dieses Feld verwenden, müssen Sie location_code nicht angeben
  Die Liste der verfügbaren Standorte der Suchmaschine mit ihrem location_name erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
  Beachten Sie, dass die Daten für das Land bereitgestellt werden, zu dem der angegebene location_name gehört;
  Beispiel:
  United Kingdom
- 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
- time_range
  Typ: string | null
  
  voreingestellte Zeiträume
  Optionales Feld
  Wenn Sie die Parameter date_from oder date_to angeben, wird dieses Feld beim Einstellen einer Aufgabe ignoriert
  mögliche Werte für alle type-Parameter:
  past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years
- type
  Typ: string | null
  
  Elementtyp

Antworten

200
Typ: object | null · Response36Afe1097B20_KeywordsDataDataforseoTrendsSubregionInterestsLiveResponseInfo
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_KeywordsDataDataforseoTrendsSubregionInterestsLiveTaskInfo
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

datetime
Typ: string | null

Datum und Uhrzeit des Eingangs des Ergebnisses
im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“
Beispiel:
2019-11-15 12:57:46 +00:00

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

enthält Keyword-Popularität und zugehörige Daten

Typ: object | null · Response36Afe1097B20_DataforseoTrendsSubregionInterestsElementItem
Typ: object · Response36Afe1097B20_DataforseoTrendsSubregionInterestsElementItem
type
Diskriminator
Typ: string | null

Elementtyp

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

subregionale Keyword-Popularitätsdaten für jeden angegebenen Begriff

keyword
Typ: string | null

relevantes Keyword
die im Element values enthaltenen Daten basieren auf diesem Keyword

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

enthält Daten zur relativen Keyword-Popularität nach Land oder Region

geo_id
Typ: string | null

Standortbezeichner
Mit diesem Feld können Sie die erhaltenen Ergebnisse den in der Anfrage angegebenen Standortparametern zuordnen
Die vollständige Liste der verfügbaren Standorte mit ihrer geo_id finden Sie hier oder durch eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
Beispiel:
US-NY

geo_name
Typ: string | null

Standortname
Mit diesem Feld können Sie die erhaltenen Ergebnisse den in der Anfrage angegebenen Standortparametern zuordnen
Die vollständige Liste der verfügbaren Standorte mit ihrem geo_name finden Sie hier oder durch eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
Beispiel:
Andorra

value
Typ: integer | null

relative Keyword-Popularitätsrate an einem bestimmten Standort
stellt die standortspezifische Keyword-Popularitätsrate über den angegebenen Zeitraum dar;
mit diesem value können Sie nachvollziehen, wie populär ein Keyword an einem Standort im Vergleich zu einem anderen ist;
Berechnung: Wir ermitteln den höchsten Popularitätswert für das relevante Keyword über alle Standorte und drücken dann alle anderen Werte als Prozentsatz dieses höchsten Werts (100) aus;
ein Wert von 100 ist die höchste Popularität des Begriffs
ein Wert von 50 bedeutet, dass der Begriff halb so populär ist
ein Wert von 0 bedeutet, dass nicht genügend Daten für diesen Begriff vorlagen

interests_comparison
Typ: object | null · Response36Afe1097B20_InterestsComparison

Vergleich der Daten zur subregionalen Keyword-Popularität für die angegebenen Parameter
wenn Sie ein einzelnes Keyword angegeben haben, ist der Wert null

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

Keyword-Popularitätsraten über alle Standorte hinweg
die Werte in diesem Array sind Prozentsätze relativ zum Maximalwert über alle Standorte

geo_id
Typ: string | null

Standortbezeichner
Mit diesem Feld können Sie die erhaltenen Ergebnisse den in der Anfrage angegebenen Standortparametern zuordnen
Die vollständige Liste der verfügbaren Standorte mit ihrer geo_id finden Sie hier oder durch eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
Beispiel:
US-NY

geo_name
Typ: string | null

Standortname
Mit diesem Feld können Sie die erhaltenen Ergebnisse den in der Anfrage angegebenen Standortparametern zuordnen
Die vollständige Liste der verfügbaren Standorte mit ihrem geo_name finden Sie hier oder durch eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
Beispiel:
Andorra

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

enthält Daten zur relativen Keyword-Popularität nach Land oder Region

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

enthält Keyword-Popularität und zugehörige Daten

geo_id
Typ: string | null

Standortbezeichner
Mit diesem Feld können Sie die erhaltenen Ergebnisse den in der Anfrage angegebenen Standortparametern zuordnen
Die vollständige Liste der verfügbaren Standorte mit ihrer geo_id finden Sie hier oder durch eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
Beispiel:
US-NY

geo_name
Typ: string | null

Standortname
Mit diesem Feld können Sie die erhaltenen Ergebnisse den in der Anfrage angegebenen Standortparametern zuordnen
Die vollständige Liste der verfügbaren Standorte mit ihrem geo_name finden Sie hier oder durch eine separate Anfrage an https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
Beispiel:
Andorra

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

enthält Daten zur relativen Keyword-Popularität nach Land oder Region

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

Keywords in einem POST-Array

position
Typ: integer | null

die Ausrichtung des Elements
kann folgende Werte annehmen: 1, 2, 3, 4, usw.

items_count
Typ: integer | null Format: int64

die Anzahl der im items-Array zurückgegebenen Ergebnisse

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

Keywords in einem POST-Array

language_code
Typ: string | null

Sprachcode in einem POST-Array
liegen keine Daten vor, ist der Wert null

location_code
Typ: integer | null

Standortcode in einem POST-Array
liegen keine Daten vor, ist der Wert null

type
Typ: string | null

Elementtyp

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/keywords_data/dataforseo_trends/subregion_interests/live

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/dataforseo_trends/subregion_interests/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "rugby",
      "cricket"
    ],
    "date_from": "2023-01-01",
    "date_to": "2024-01-01",
    "type": "web",
    "location_name": "United States"
  }
]'

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": [
        {
          "keywords": [
            null
          ],
          "type": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "type": "[Max Depth Exceeded]",
              "position": "[Max Depth Exceeded]",
              "keywords": "[Max Depth Exceeded]",
              "interests": "[Max Depth Exceeded]",
              "interests_comparison": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

Live-Aufgaben für „DataForSEO Trends Subregion Interests“ einstellen

AuthentifizierungRequired

DataForSEO

Live-Aufgaben für „DataForSEO Trends Subregion Interests“ einstellen

Preisreferenz