v0.2.0-beta

OpenAPI 3.1.0

Google-News-SERP-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/google/news/task_post

Google-News-SERP-Aufgaben einstellen

Stellt die News-Ergebnisse für ein Keyword bei Google 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)[]
- browser_screen_height
  Typ: integer | null
  
  Bildschirmhöhe des Browsers
  
  Optionales Feld
  
  Sie können eine benutzerdefinierte Bildschirmhöhe des Browsers festlegen, um Pixel-Rankings für ein bestimmtes Gerät zu berechnen;
  
  standardmäßig ist der Parameter auf 1080 gesetzt;
  
  Hinweis: um diesen Parameter zu verwenden, setzen Sie calculate_rectangles auf true
- browser_screen_resolution_ratio
  Typ: integer | null
  
  Bildschirmauflösungsverhältnis des Browsers
  
  Optionales Feld
  
  Sie können ein benutzerdefiniertes Bildschirmauflösungsverhältnis des Browsers festlegen, um Pixel-Rankings für ein bestimmtes Gerät zu berechnen;
  
  standardmäßig ist der Parameter auf 1 gesetzt;
  
  Hinweis: um diesen Parameter zu verwenden, setzen Sie calculate_rectangles auf true
- browser_screen_width
  Typ: integer | null Format: int64
  
  Bildschirmbreite des Browsers
  
  Optionales Feld
  
  Sie können eine benutzerdefinierte Bildschirmbreite des Browsers festlegen, um Pixel-Rankings für ein bestimmtes Gerät zu berechnen;
  
  standardmäßig ist der Parameter auf 1920 gesetzt;
  
  Hinweis: um diesen Parameter zu verwenden, setzen Sie calculate_rectangles auf true
- calculate_rectangles
  Typ: boolean | null
  
  Pixel-Rankings für SERP-Elemente in erweiterten Ergebnissen berechnen
  
  Optionales Feld
  
  Das Pixel-Ranking bezeichnet den Abstand zwischen dem Ergebnis-Snippet und der oberen linken Ecke des Bildschirms;
  
  Weitere Informationen im Help Center>>
  
  standardmäßig ist der Parameter auf false gesetzt
  
  Hinweis: bei true wird die Gebühr pro Aufgabe mit 2 multipliziert
- depth
  Typ: integer | null
  
  Parsing-Tiefe
  
  Optionales Feld
  
  Anzahl der Ergebnisse in der SERP
  
  Standardwert: 10
  
  Höchstwert: 700
  
  Ihr Konto wird pro SERP mit bis zu 10 Ergebnissen abgerechnet;
  Eine Tiefe über 10 kann zu zusätzlichen Kosten führen, wenn die Suchmaschine mehr als 10 Ergebnisse zurückgibt;
  
  Wenn die angegebene Tiefe höher ist als die Anzahl der Ergebnisse in der Antwort, wird die Differenz automatisch Ihrem Kontostand gutgeschrieben;
  
  Die Kosten können auf der Seite Pricing berechnet werden.
- keyword
  Typ: string
  
  keyword
  
  Pflichtfeld
  
  im Feld keyword können Sie bis zu 700 Zeichen angeben
  
  alle %## werden dekodiert (das Zeichen ‘+’ wird zudem in ein Leerzeichen dekodiert)
  
  Wenn Sie das Zeichen “%” für Ihr keyword benötigen, geben Sie es als “%25” an;
  
  Wenn Sie das Zeichen “+” für Ihr keyword benötigen, geben Sie es als “%2B” an;
  
  Wenn dieses Feld Parameter wie ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘define:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘related:’, ‘site:’ enthält, wird die Berechnung pro Aufgabe mit 5 multipliziert
  
  Hinweis: Abfragen mit dem Parameter ‘cache:’ werden nicht unterstützt und geben einen Validierungsfehler zurück
  
  Mehr über Regeln und Einschränkungen der Felder keyword und keywords in DataForSEO-APIs erfahren Sie in diesem Help-Center-Artikel
- language_code
  Typ: string
  
  Sprachcode der Suchmaschine
  
  Pflichtfeld, wenn nicht angegeben language_name
  
  bei Verwendung dieses Feldes ist keine Angabe von language_name nötig
  
  die Liste der verfügbaren Sprachen der Suchmaschine mit ihrem language_code erhalten Sie durch eine separate Anfrage an die https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
  
  Beispiel:
  
  en
- language_name
  Typ: string
  
  vollständiger Name der Suchmaschinensprache
  
  Pflichtfeld, wenn nicht angegeben language_code
  
  bei Verwendung dieses Feldes ist keine Angabe von language_code nötig
  
  die Liste der verfügbaren Sprachen der Suchmaschine mit ihrem language_name erhalten Sie durch eine separate Anfrage an die https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
  
  Beispiel:
  
  English
- location_code
  Typ: integer
  
  Standortcode der Suchmaschine
  
  Pflichtfeld, wenn nicht angegeben location_name oder location_coordinate
  
  bei Verwendung dieses Feldes ist keine Angabe von location_name oder location_coordinate nötig
  
  die Liste der verfügbaren Standorte der Suchmaschinen mit ihrem location_code erhalten Sie durch eine separate Anfrage an die https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
  
  Beispiel:
  
  2840
- location_coordinate
  Typ: string
  
  GPS-Koordinaten eines Standorts
  
  Pflichtfeld, wenn nicht angegeben location_name oder location_code
  
  bei Verwendung dieses Feldes ist keine Angabe von location_name oder location_code nötig
  
  Der Parameter location_coordinate muss im Format "latitude,longitude,radius" angegeben werden
  
  die maximale Anzahl der Nachkommastellen für "latitude" und "longitude": 7
  
  der Mindestwert für "radius": 199.9 (mm)
  
  der Höchstwert für "radius": 199999 (mm)
  
  Beispiel:
  
  53.476225,-2.243572,200
- location_name
  Typ: string
  
  vollständiger Name des Suchmaschinen-Standorts
  
  Pflichtfeld, wenn nicht angegeben location_code oder location_coordinate
  
  bei Verwendung dieses Feldes ist keine Angabe von location_code oder location_coordinate nötig
  
  die Liste der verfügbaren Standorte der Suchmaschine mit ihrem location_name erhalten Sie durch eine separate Anfrage an die https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
  
  Beispiel:
  
  London,England,United Kingdom
- max_crawl_pages
  Typ: integer | null
  
  Begrenzung der zu crawlenden Seiten
  
  Optionales Feld
  
  Anzahl der zu crawlenden Seiten mit Suchergebnissen
  
  Höchstwert: 100
  
  Hinweis: Die Parameter max_crawl_pages und depth ergänzen sich;
  
  mehr dazu in unserem Help-Center
- os
  Typ: string | null
  
  Betriebssystem des Geräts
  
  Optionales Feld
  
  beachten Sie, dass diese API nur Ergebnisse für Desktop liefert
  
  wählen Sie aus folgenden Werten: windows, macos
  
  Standardwert: windows
- 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 URL-kodierte $tag-Variable verwenden. Wir legen die erforderlichen Werte vor dem Senden der Anfrage fest.
  
  Beispiel:
  
  http://your-server.com/pingscript?id=$id
  
  http://your-server.com/pingscript?id=$id&tag=$tag
  
  Hinweis: Sonderzeichen in pingback_url werden URL-kodiert;
  
  so wird das Zeichen # in %23 kodiert
  
  mehr dazu in unserem Help-Center
- postback_data
  Typ: string
  
  postback_url-Datentyp
  
  Pflichtfeld, wenn postback_url angegeben wird
  
  entspricht dem Datentyp, der an Ihren Server gesendet wird
  
  Mögliche Werte:
  
  advanced, html
- postback_url
  Typ: string | null
  
  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 Help Center
- priority
  Typ: integer | null
  
  Aufgabenpriorität
  
  Optionales Feld
  
  Kann folgende Werte annehmen:
  
  1 – normale Ausführungspriorität (standardmäßig gesetzt)
  
  2 – hohe Ausführungspriorität
  
  Für Aufgaben mit hoher Ausführungspriorität wird zusätzlich berechnet.
  Die Kosten lassen sich auf der Seite Pricing berechnen.
- se_domain
  Typ: string | null
  
  Suchmaschinen-Domain
  
  Optionales Feld
  
  Wir wählen die passende Suchmaschinen-Domain automatisch anhand des von Ihnen angegebenen Standorts und der Sprache aus
  
  Sie können in diesem Feld jedoch eine benutzerdefinierte Suchmaschinen-Domain festlegen
  
  Beispiel:
  
  google.co.uk, google.com.au, google.de usw.
- search_param
  Typ: string | null
  
  zusätzliche Parameter der Suchanfrage
  
  Optionales Feld
  
  die Liste der verfügbaren Parameter und weitere Details finden Sie hier
- tag
  Typ: string | null
  
  benutzerdefinierter Aufgabenbezeichner
  
  optionales Feld
  
  Das Zeichenlimit beträgt 255
  
  Sie können diesen Parameter verwenden, um die Aufgabe zu identifizieren und dem Ergebnis zuzuordnen
  
  Den angegebenen tag-Wert finden Sie im data-Objekt der Antwort
- url
  Typ: string | null
  
  direkte URL der Suchanfrage
  
  Optionales Feld
  
  Sie können eine direkte URL angeben, und wir ordnen sie den erforderlichen Feldern zu;
  
  Hinweis: Diese Methode ist für unsere API am schwierigsten zu verarbeiten und erfordert zudem die Angabe der genauen Sprache und des Standorts in der URL. In den meisten Fällen würden wir diese Methode nicht empfehlen;
  
  Beispiel:
  
  https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS

Antworten

200
Typ: object | null · Response36Afe1097B20_SerpGoogleNewsTaskPostResponseInfo
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_SerpGoogleNewsTaskPostTaskInfo
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/google/news/task_post

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

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

Google-News-SERP-Aufgaben einstellen

AuthentifizierungRequired

DataForSEO

Google-News-SERP-Aufgaben einstellen

Preisreferenz