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

Naver-Organic-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

Naver-Organic-SERP-Aufgaben einstellen

​

Stellt die Rangfolge der Ergebnisse für ein Keyword bei Naver 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)[]
    • depth
      Typ: integer | null

      Parsingtiefe
      optionales Feld
      Anzahl der Ergebnisse in der SERP
      Standardwert: 15
      Maximalwert: 700
      Ihr Konto wird für jede SERP mit bis zu 15 Ergebnissen abgerechnet;
      Eine Tiefe über 15 kann zu zusätzlichen Kosten führen wenn die Suchmaschine mehr als 15 Ergebnisse zurückgibt;
      Die Kosten können auf der Seite Preise berechnet werden.

    • device
      Typ: string | null

      Gerätetyp
      Optionales Feld
      Ergebnisse für einen bestimmten Gerätetyp zurückgeben
      mögliche Werte:desktop, mobile
      Standardwert: desktop

    • 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 „%“ 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

      weitere Informationen zu den Regeln und Einschränkungen der Felder keyword und keywords in DataForSEO-APIs finden Sie in diesem Help-Center-Artikel

    • max_crawl_pages
      Typ: integer | null

      Crawl-Limit für Seiten
      Optionales Feld
      Anzahl der zu crawlenden Suchergebnisseiten
      Standardwert: 1
      Höchstwert: 100
      Hinweis: Die Parameter max_crawl_pages und depth ergänzen sich gegenseitig;
      weitere Informationen in unserem Help Center

    • os
      Typ: string | null

      Betriebssystem des Geräts
      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 für eine abgeschlossene 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 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 URL-kodiert;
      d. h. das Zeichen # wird zu %23 kodiert

      Weitere Informationen finden Sie in unserem Help Center

    • postback_data
      Typ: string

      Datentyp von postback_url
      Pflichtfeld, wenn Sie postback_url angeben
      entspricht der Funktion, die Sie zum Festlegen der Aufgabe verwendet haben
      mögliche Werte:
      regular, advanced, html

    • postback_url
      Typ: string | null

      URL zum Senden von Aufgabenergebnissen
      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 URL-kodierte $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 URL-kodiert;
      d. h. das Zeichen # wird zu %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 festgelegt)
      2 – hohe AusführungsprioritätFür Aufgaben mit hoher Ausführungspriorität wird zusätzlich berechnet.
      Die Kosten können auf der Seite Preise berechnet werden.

    • se_domain
      Typ: string | null

      Domain der Suchmaschine
      optionales Feld
      wir wählen die passende Suchmaschinen-Domain automatisch aus
      Sie können in diesem Feld jedoch eine benutzerdefinierte Suchmaschinen-Domain festlegen
      Beispiel:
      search.naver.com

    • search_param
      Typ: string | null

      zusätzliche Parameter der Suchabfrage
      optionales Feld
      Die Liste der verfügbaren Parameter und weitere Details finden Sie hier

    • 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

      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

    • 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
      In den meisten Fällen würden wir diese Methode nicht empfehlen;
      Beispiel:
      https://search.naver.com/search.naver?where=nexearch&sm=top_hty&fbm=1&ie=utf8&query=iphone

Antworten
  • 200
    Typ: object | null · Response36Afe1097B20_SerpNaverOrganicTaskPostResponseInfo
    • 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_SerpNaverOrganicTaskPostTaskInfo
        • 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
Request Example for post/v1/beta/dataforseo/serp/naver/organic/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/naver/organic/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "albert einstein",
    "device": "desktop",
    "tag": "some_string_123",
    "postback_url": "https://your-server.com/postbackscript.php",
    "postback_data": "regular"
  }
]'

{
  "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

Setting Naver Organic SERP Tasks