v0.2.0-beta

OpenAPI 3.1.0

YouTube-Organic-Aufgaben 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/serp/youtube/organic/task_post

YouTube-Organic-Aufgaben einstellen

Stellt die Rangfolge der Ergebnisse für ein Keyword bei YouTube 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 Abfrage einfacher; nutzen Sie die Warteschlange, wenn der Stapel 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 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

application/json

Typ: array (object | null)[]
- block_depth
  Typ: integer | null
  
  Parsingtiefe optionales Feld Anzahl der Ergebnisblöcke in der SERP Standardwert: 20 Maximalwert: 700 Hinweis: Ihr Konto wird für jede SERP mit bis zu 20 Ergebnisblöcken abgerechnet; eine Blocktiefe über 20 kann daher zu zusätzlichen Kosten führen, wenn die Suchmaschine mehr als 20 Ergebnisse zurückgibt; wenn die angegebene Blocktiefe höher ist als die Anzahl der Ergebnisse in der Antwort, wird die Differenz automatisch Ihrem Kontoguthaben gutgeschrieben
- device
  Typ: string | null
  
  Gerätetyp optionales Feld Ergebnisse für einen bestimmten Gerätetyp zurückgeben verfügbare Werte: desktop, mobile
- keyword
  Typ: string
  
  Keyword Pflichtfeld Sie können im Feld keyword bis zu 700 Zeichen angeben alle %## werden dekodiert (das Zeichen ‚+‘ wird in ein Leerzeichen dekodiert) Wenn Sie das Zeichen „%“ in Ihrem keyword verwenden möchten, geben Sie es als „%25“ an; Wenn Sie das Zeichen „+“ in Ihrem keyword verwenden möchten, geben Sie es als „%2B“ an; Weitere Informationen zu Regeln und Einschränkungen der Felder keyword und keywords in DataForSEO-APIs finden Sie in diesem Hilfe-Center-Artikel
- language_code
  Typ: string | null
  
  Sprachcode der Suchmaschine Pflichtfeld, wenn Sie language_name nicht angeben Wenn Sie dieses Feld verwenden, müssen Sie language_name nicht angeben Die Liste der verfügbaren Sprachen der Suchmaschine mit ihrem language_code erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/serp/youtube/languages Beispiel: en
- language_name
  Typ: string | null
  
  Vollständiger Name der Sprache der Suchmaschine Pflichtfeld, wenn Sie language_code nicht angeben Wenn Sie dieses Feld verwenden, müssen Sie language_code nicht angeben Die Liste der verfügbaren Sprachen der Suchmaschine mit ihrem language_name erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/serp/youtube/languages Beispiel: English
- location_code
  Typ: integer | null
  
  Standortcode der Suchmaschine Pflichtfeld, wenn Sie location_name nicht angeben 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/serp/youtube/locations Beispiel: 2840
- location_name
  Typ: string | null
  
  Vollständiger Name des Standorts der Suchmaschine Pflichtfeld, wenn Sie location_code nicht angeben 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/serp/youtube/locations Beispiel: United States
- os
  Typ: string | null
  
  Gerätebetriebssystem optionales Feld wenn Sie im Feld device desktop angeben, wählen Sie aus folgenden Werten: windows, macos Standardwert: windows wenn Sie im Feld device mobile angeben, wählen Sie aus folgenden Werten: android, ios Standardwert: android
- pingback_url
  Typ: string | null
  
  Benachrichtigungs-URL einer abgeschlossenen Aufgabe optionales Feld wenn eine Aufgabe abgeschlossen ist, benachrichtigen wir Sie per GET-Anfrage an die von Ihnen angegebene URL Sie können die Zeichenfolge ‚$id‘ als $id-Variable und ‚$tag‘ als urlencodierte $tag-Variable verwenden. Wir setzen die erforderlichen Werte vor dem Senden der Anfrage. Beispiel: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag Hinweis: Sonderzeichen in pingback_url werden urlencodiert; u. a. wird das Zeichen # in %23 kodiert Weitere Informationen finden Sie in unserem Hilfe-Center
- postback_data
  Typ: string | null
  
  Datentyp von postback_url Pflichtfeld, wenn Sie postback_url angeben entspricht dem Datentyp, der an Ihren Server gesendet wird möglicher Wert: advanced
- postback_url
  Typ: string | null
  
  Rückgabe-URL zum Senden der Aufgabenergebnisse optionales Feld sobald die Aufgabe abgeschlossen ist, senden wir eine POST-Anfrage mit den im gzip-Format komprimierten Ergebnissen an die von Ihnen angegebene postback_url Sie können die Zeichenfolge ‚$id‘ als $id-Variable und ‚$tag‘ als urlencodierte $tag-Variable verwenden. Wir setzen die erforderlichen Werte vor dem Senden der Anfrage. Beispiel: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag Hinweis: Sonderzeichen in postback_url werden urlencodiert; u. a. wird das Zeichen # in %23 kodiert Weitere Informationen finden Sie in unserem Hilfe-Center
- priority
  Typ: integer | null
  
  Aufgabenpriorität optionales Feld kann folgende Werte annehmen: 1 – normale Ausführungspriorität (standardmäßig festgelegt) 2 – hohe Ausführungspriorität Für Aufgaben mit hoher Ausführungspriorität wird zusätzlich berechnet. Die Kosten können auf der Seite Preise berechnet werden.
- search_param
  Typ: string | null
  
  zusätzliche Parameter der Suchabfrage optionales Feld Beispiel: sp=EgIQAg%253D%253D
- tag
  Typ: string | null
  
  Benutzerdefinierte Aufgaben-ID Optionales Feld Das Zeichenlimit beträgt 255 Mit diesem Parameter können Sie die Aufgabe identifizieren und dem Ergebnis zuordnen Den angegebenen tag-Wert finden Sie im data-Objekt der Antwort

Antworten

200
Typ: object | null · Response36Afe1097B20_SerpYoutubeOrganicTaskPostResponseInfo
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 der Aufgaben

Typ: object | null · Response36Afe1097B20_SerpYoutubeOrganicTaskPostTaskInfo
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: object | null

Array von Ergebnissen. In diesem Fall ist der Wert null

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/serp/youtube/organic/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/youtube/organic/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "audi"
  }
]'

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": null
    }
  ]
}

Erfolgreicher Vorgang

YouTube-Organic-Aufgaben einstellen

AuthentifizierungRequired

DataForSEO

YouTube-Organic-Aufgaben einstellen

Preisreferenz