Felo API PlatformFelo API Platform
Alle Endpoints von DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Aufgaben für Google Events SERP einstellen

Server:https://openapi.felo.ai
Client-Bibliotheken

DataForSEO

​

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

Aufgaben für Google Events SERP einstellen

​

Stellt die Veranstaltungen, die Google für eine Suchanfrage anzeigt, in die Warteschlange und gibt eine Aufgaben-id in tasks[0].id zurück. 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. Der Live-Zwilling antwortet sofort und ist für eine einzelne Anfrage einfacher; nutzen Sie die Warteschlange, wenn der Batch einen Tool-Aufruf überdauern würde.

Preisreferenz

  • Abrechnung: Gemeldete Antwortkosten.
  • Referenzschätzung pro Anfrage: USD 0.02.
  • Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf einen bereits abgerechneten Kundenbetrag anwenden.

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

Body
erforderlich
application/json
  • Typ: array object[]
    • keyword
      Typ: string
      erforderlich

      Keyword, nach dem gesucht werden soll

    • language_code
      Typ: string

      Sprachcode der Suchmaschine

    • language_name
      Typ: string

      Vollständiger Name der Suchmaschinensprache

    • location_code
      Typ: integer

      Standortcode der Suchmaschine

    • location_coordinate
      Typ: string

      GPS-Koordinaten eines Standorts

    • location_name
      Typ: string

      Vollständiger Name des Suchmaschinen-Standorts

    • pingback_url
      Typ: string

      Benachrichtigungs-URL einer abgeschlossenen Aufgabe

    • postback_data
      Typ: string

      Postback-Datentyp

    • postback_url
      Typ: string

      URL zum Senden der Aufgabenergebnisse

    • priority
      Typ: integer

      Aufgabenpriorität

Antworten
  • 200
    Typ: object

    Erfolgreiche Antwort

    • cost
      Typ: number

      Gesamtkosten der Aufgaben, USD

    • status_code
      Typ: integer

      Allgemeiner Statuscode

    • status_message
      Typ: string

      Allgemeine Informationsmeldung

    • tasks
      Typ: array string[]

      Array von Aufgabenobjekten

    • tasks_count
      Typ: integer

      Die Anzahl der Aufgaben im tasksarray

    • tasks_error
      Typ: integer

      Die Anzahl der Aufgaben im tasksarray, die mit einem Fehler zurückgegeben wurden

    • tasks[].cost
      Typ: number

      Kosten der Aufgabe, USD

    • tasks[].id
      Typ: string

      Aufgabenbezeichner im UUID-Format

    • tasks[].result_count
      Typ: integer

      Anzahl der Elemente im Ergebnisarray

    • tasks[].status_code
      Typ: integer

      Aufgaben-Statuscode

    • tasks[].status_message
      Typ: string

      Aufgaben-Statusmeldung

    • time
      Typ: string

      Ausführungszeit, Sekunden

    • version
      Typ: string

      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
Request Example for post/v1/beta/dataforseo/serp/google/events/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/events/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "",
    "location_code": 1,
    "location_name": "",
    "location_coordinate": "",
    "language_code": "",
    "language_name": "",
    "priority": 1,
    "postback_url": "",
    "pingback_url": "",
    "postback_data": ""
  }
]'
{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks_count": 1,
  "tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks[].id": "string",
  "tasks[].status_code": 1,
  "tasks[].status_message": "string",
  "tasks[].cost": 1,
  "tasks[].result_count": 1
}
Setting Google Events SERP Tasks