v0.2.0-beta

OpenAPI 3.1.0

Live: Google-Organic-SERP als HTML

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/organic/live/html

Live: Google-Organic-SERP als HTML

Gibt die Rangfolge der Ergebnisse für ein Keyword bei Google synchron zurück. Rohe Seitenquelle statt geparster Ergebnisse. 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.

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)[]
- depth
  Typ: integer | null
  
  Parsing-Tiefe
  
  Optionales Feld
  
  Anzahl der Ergebnisse in der SERP
  
  Standardwert: 10
  
  Höchstwert: 200
  
  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;
  
  Die Kosten können auf der Seite Pricing berechnet werden.
- device
  Typ: string | null
  
  Gerätetyp
  
  Optionales Feld
  
  Ergebnisse für einen bestimmten Gerätetyp zurückgeben
  
  Kann die Werte annehmen:desktop, mobile
  
  Standardwert: desktop
- expand_ai_overview
  Typ: boolean | null
  
  AI Overview erweitern
  
  Optionales Feld
  
  auf true setzen, um das Element ai_overview zu erweitern;
  
  Standardwert: false
- find_targets_in
  Typ: array string[] | null
  
  SERP-Elementtypen, die auf Ziele geprüft werden
  
  Optionales Feld
  
  Um diesen Parameter zu aktivieren, muss auch stop_crawl_on_match aktiviert sein
  
  Legt fest, welche SERP-Elementtypen auf Zielübereinstimmungen geprüft werden sollen
  
  wenn nicht angegeben, werden alle Elemente der ersten Ebene mit den Feldern url und domain auf Ziele geprüft
  
  Mögliche Werte: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter
  
  Hinweis: darf nicht dieselben Elementtypen wie ignore_targets_in enthalten
  
  Beispiel:
  
  "find_targets_in": ["organic", "featured_snippet"]
  
  Mehr über diesen Parameter erfahren Sie in unserem Help Center
- ignore_targets_in
  Typ: array string[] | null
  
  SERP-Elementtypen, die von der Zielsuche ausgeschlossen werden
  
  Optionales Feld
  
  Um diesen Parameter zu aktivieren, muss auch stop_crawl_on_match aktiviert sein
  
  Legt fest, welche SERP-Elementtypen bei der Suche nach Zielübereinstimmungen ausgeschlossen werden sollen
  
  Mögliche Werte: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter
  
  Hinweis: darf nicht dieselben Elementtypen wie find_targets_in enthalten
  
  Beispiel:
  
  "ignore_targets_in": ["paid", "images"]
  
  Mehr über diesen Parameter erfahren Sie in unserem Help Center
- 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:', ‘cache:’, 'define:', 'filetype:', 'id:', 'inanchor:', 'info:', 'intext:', 'intitle:', 'inurl:', 'link:', 'related:', 'site:' enthält, wird die Berechnung pro Aufgabe mit 5 multipliziert
- 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/google/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/google/languages
  
  Beispiel:
  
  English
- load_async_ai_overview
  Typ: boolean | null
  
  Asynchrones AI Overview laden
  
  Optionales Feld
  
  auf true setzen, um ai_overview-Elemente in SERPs zu erhalten, auch wenn sie asynchron geladen werden;
  
  bei Einstellung auf false erhalten Sie ai_overview-Elemente nur aus dem Cache;
  
  Standardwert: false
  
  Hinweis Ihrem Konto werden für jede Anfrage zusätzlich $0.002 berechnet;
  
  wenn das Element fehlt oder "asynchronous_ai_overview": false enthält, werden alle zusätzlichen Kosten Ihrem Kontostand zurückerstattet
- 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/google/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 (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/google/locations
  
  Beispiel:
  
  London,England,United Kingdom
- match_type
  Typ: string
  
  Typ des Zielabgleichs
  
  Pflichtfeld, wenn stop_crawl_on_match angegeben ist
  
  Typ der Übereinstimmung für den match_value
  
  Mögliche Werte:
  
  domain – bestimmte Domain oder Subdomain
  
  with_subdomains – Hauptdomain und Subdomains
  
  wildcard – Wildcard-Muster
- match_value
  Typ: string
  
  Ziel-Domain, -Subdomain oder Wildcard-Wert
  
  Pflichtfeld, wenn stop_crawl_on_match angegeben ist
  
  Geben Sie eine Ziel-Domain, -Subdomain oder einen Wildcard-Wert an;
  
  Hinweis: Domain oder Subdomain müssen ohne Anfrageprotokoll angegeben werden;
  
  Beispiel: "match_value": "dataforseo.com",
  
  "match_value": "/blog/post-*"
- max_crawl_pages
  Typ: integer | null
  
  Begrenzung der zu crawlenden Seiten
  
  Optionales Feld
  
  Anzahl der zu crawlenden Seiten mit Suchergebnissen
  
  Höchstwert: 100
  
  Hinweis: Für jede gecrawlte Seite wird abgerechnet (10 organische Ergebnisse pro Seite);
  
  mehr zur Preisgestaltung auf unserer Seite Pricing;
  
  Hinweis Nr. 2: 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
  
  wenn Sie desktop im Feld device angeben, wählen Sie aus folgenden Werten: windows, macos
  
  Standardwert: windows
  
  wenn Sie mobile im Feld device angeben, wählen Sie aus folgenden Werten: android, ios
  
  Standardwert: android
- 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
  
  Hinweis: Die folgenden Suchmaschinenparameter werden nicht unterstützt und automatisch zurückgesetzt, wenn sie angegeben werden: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
- stop_crawl_on_match
  Typ: array (object | null)[] | null
  
  Array von Zielen, bei denen das Crawling beendet wird optionales Feld wenn angegeben, enthält die Antwort SERP-Ergebnisse bis einschließlich des angegebenen match_value; Sie können bis zu 10 Zielwerte in diesem Array angeben Beispiel: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] Weitere Informationen zu diesem Parameter finden Sie in unserem Hilfe-Center - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Ihr Konto wird für jede über die angegebenen Ziele gecrawlte SERP abgerechnet
  
  match_type
  Typ: string | null
  
  Typ der Zielübereinstimmung Pflichtfeld, wenn stop_crawl_on_match angegeben ist; Art der Übereinstimmung für den match_value mögliche Werte: domain, with_subdomains, wildcard
  
  match_value
  Typ: string | null
  
  Ziel-Domain oder Wildcard-Wert Pflichtfeld, wenn stop_crawl_on_match angegeben ist; Geben Sie eine Ziel-Domain oder einen Wildcard-Wert an; Hinweis: Der Domainname muss ohne Anfrageprotokoll angegeben werden; Beispiel: dataforseo.com
- 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
- target_search_mode
  Typ: string | null
  
  Zielübereinstimmungsmodus
  
  optionales Feld
  
  Um diesen Parameter zu aktivieren, muss auch stop_crawl_on_match aktiviert sein
  
  Legt fest, wie das Crawling beendet werden soll, wenn mehrere Ziele in stop_crawl_on_match angegeben sind
  
  mögliche Werte: all, any
  
  all – das Crawling wird erst beendet, wenn alle angegebenen Ziele gefunden wurden
  
  any – das Crawling wird beendet, sobald ein einzelnes Ziel gefunden wurde
  
  Standardwert: any
  
  Weitere Informationen zu diesem Parameter finden Sie in unserem Hilfe-Center
- url
  Typ: string | null
  
  direkte URL der Suchabfrage
  
  optionales Feld
  
  Sie können eine direkte URL angeben, und wir ordnen sie den erforderlichen Feldern zu. Beachten Sie, dass diese Methode für unsere API am schwierigsten zu verarbeiten ist und Sie außerdem die genaue Sprache und den Standort in der URL angeben müssen. 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
  
  Hinweis: Die folgenden Suchmaschinen-Parameter werden nicht unterstützt und automatisch zurückgesetzt, wenn sie in der URL angegeben werden: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.

Antworten

200
Typ: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveHtmlResponseInfo
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_SerpGoogleOrganicLiveHtmlTaskInfo
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

Elemente der in der SERP gefundenen Suchergebnisse

date
Typ: string | null

Datum und Uhrzeit, zu denen die HTML-Seite gescannt wurde
im UTC-Format: “yyyy-mm-dd hh-mm-ss +00:00”
Beispiel:
2019-11-15 12:57:46 +00:00

html
Typ: string | null

HTML-Seite

page
Typ: integer | null

laufende Nummer der zurückgegebenen HTML-Seite

items_count
Typ: integer | null Format: int64

die Anzahl der im items-Array zurückgegebenen Ergebnisse

keyword
Typ: string | null

in einem POST-Array empfangenes Keyword
das Keyword wird dekodiert zurückgegeben (%##; das Zeichen „+“ wird in ein Leerzeichen dekodiert)

language_code
Typ: string | null

Sprachcode in einem POST-Array

location_code
Typ: integer | null

Standortcode in einem POST-Array

se_domain
Typ: string | null

Suchmaschinen-Domain in einem POST-Array

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/serp/google/organic/live/html

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/organic/live/html \
  --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": [
        {
          "keyword": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "page": null,
              "date": null,
              "html": null
            }
          ]
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

Live: Google-Organic-SERP als HTML

AuthentifizierungRequired

DataForSEO

Live: Google-Organic-SERP als HTML

Preisreferenz