Felo API PlatformFelo API Platform
Wszystkie endpointy DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Tworzenie zadań organicznych SERP Baidu

Felo API Support
MIT
Serwer:https://openapi.felo.ai
Biblioteki klienckie
Shell Curl

DataForSEO

​

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

DataForSEO Operacje

Tworzenie zadań organicznych SERP Baidu

​

Kolejkuje wyniki pozycjonowane dla słowa kluczowego w Baidu i zwraca id zadania w tasks[0].id. Opakowane w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200. Wersja na żywo odpowiada natychmiast i jest prostsza dla pojedynczego zapytania; kolejkuj, gdy partia przekroczyłaby czas wywołania narzędzia.

Cennik referencyjny

  • Rozliczanie: zgłoszony koszt odpowiedzi.
  • Szacunek referencyjny dla żądania: USD 0.02.
  • Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.

Wyłącznie metadane referencyjne, a nie wycena konta, gwarantowana cena lub limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Treść
application/json
  • Typ: array (object | null)[]
    • depth
      Typ: integer | null

      głębokość parsowania
      pole opcjonalne
      liczba wyników w SERP
      wartość domyślna: 10
      wartość maksymalna: 700
      Twoje konto zostanie obciążone za każdy SERP zawierający do 10 wyników;
      Ustawienie głębokości powyżej 10 może wiązać się z dodatkowymi opłatami jeśli wyszukiwarka zwróci więcej niż 10 wyników;
      Koszt można obliczyć na stronie Cennik.

    • device
      Typ: string | null

      typ urządzenia
      pole opcjonalne
      zwracaj wyniki dla określonego typu urządzenia
      możliwe wartości: desktop, mobile, tablet
      wartość domyślna: desktop

    • get_website_url
      Typ: boolean | null

      dołącz bezpośredni adres URL dla każdego wyniku rankingowego
      pole opcjonalne
      jeśli ustawisz true, zwrócone wyniki będą zawierać bezpośrednie adresy URL witryn w rankingu
      domyślnie adresy URL w wynikach Baidu są kodowane przez wyszukiwarkę,
      na przykład:
      http://www.baidu.com/link?url=KQt6LSwU5OHnPtB8210R8flBP40grY6lTPxH_0UO7S2kgiZMTmw3ztV0hCo5c1kLwartość domyślna: false
      Uwaga: jeśli ustawisz true, opłata za zadanie zostanie pomnożona przez 10, ponieważ nasz system wykonuje osobne żądanie dla każdej sklasyfikowanej witryny, aby zwrócić jej bezpośredni adres URL

    • keyword
      Typ: string

      słowo kluczowe
      pole wymagane
      w polu keyword możesz podać do 700 znaków
      wszystkie %## zostaną zdekodowane (znak ‘+’ zostanie zdekodowany jako spacja)
      jeśli chcesz użyć znaku „%” w keyword, podaj go jako „%25”;
      jeśli chcesz użyć znaku „+” w keyword, podaj go jako „%2B”

      więcej o zasadach i ograniczeniach pól keyword i keywords w interfejsach API DataForSEO znajdziesz w artykule Centrum pomocy

    • language_code
      Typ: string

      kod języka wyszukiwarki
      pole wymagane, jeśli nie podasz language_name
      listę dostępnych języków wyszukiwarki wraz z ich language_code można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesuwaga: jedynym językiem obsługiwanym przez wyszukiwarkę Baidu jest Chinese (Simplified) z kodem języka zh_CN. Baidu może jednak zwracać wyniki również dla zapytań w innych językach, więc podanie keyword po chińsku nie jest obowiązkowe

      przykład:
      zh_CN

    • language_name
      Typ: string

      pełna nazwa języka wyszukiwarki
      pole wymagane, jeśli nie podasz language_code
      listę dostępnych języków wyszukiwarki wraz z ich language_name można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesuwaga: jedynym językiem obsługiwanym przez wyszukiwarkę Baidu jest Chinese (Simplified). Baidu może jednak zwracać wyniki również dla zapytań w innych językach, więc podanie keyword po chińsku nie jest obowiązkowe

      przykład:
      Chinese (Simplified)

    • location_code
      Typ: integer

      kod lokalizacji wyszukiwarki
      pole wymagane, jeśli nie podasz location_name lub location_coordinate
      jeśli używasz tego pola, nie musisz podawać location_name lub location_coordinate
      listę dostępnych lokalizacji wyszukiwarek wraz z ich location_code można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
      przykład:
      2156

    • location_coordinate
      Typ: string

      współrzędne GPS lokalizacji
      pole wymagane, jeśli nie podasz location_name lub location_code
      jeśli używasz tego pola, nie musisz podawać location_name lub location_code
      parametr location_coordinate należy podać w formacie "latitude,longitude,radius"
      maksymalna liczba cyfr po przecinku dla "latitude" i "longitude": 7
      wartość minimalna dla "radius": 199.9 (mm)
      wartość maksymalna dla "radius": 199999 (mm)jeśli używasz tego pola, zwrócone wyniki będą oparte na najbliższym mieście znalezionym dla Twoich współrzędnych. Dlatego nie zalecamy używania tego pola, ponieważ wyniki mogą nie być istotne dla podanych współrzędnych
      przykład:
      53.476225,-2.243572,200

    • location_name
      Typ: string

      pełna nazwa lokalizacji wyszukiwarki
      pole wymagane, jeśli nie podasz location_code lub location_coordinate
      jeśli używasz tego pola, nie musisz podawać location_code lub location_coordinate
      listę dostępnych lokalizacji wyszukiwarki wraz z ich location_name można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
      przykład:
      New York,New York,United States

    • max_crawl_pages
      Typ: integer | null

      limit indeksowania stron
      pole opcjonalne
      liczba stron wyników wyszukiwania do indeksowania
      wartość domyślna: 1
      wartość maksymalna: 100
      Uwaga: parametry max_crawl_pages i depth uzupełniają się;
      więcej informacji w naszym Centrum pomocy

    • os
      Typ: string | null

      system operacyjny urządzenia
      pole opcjonalne
      jeśli w polu device podasz desktop, wybierz spośród następujących wartości: windows, macos
      wartość domyślna: windows
      jeśli w polu device podasz mobile, wybierz spośród następujących wartości: android, ios
      wartość domyślna: android
      jeśli w polu device podasz tablet, wybierz spośród następujących wartości: android, ios
      wartość domyślna: android

    • pingback_url
      Typ: string | null

      adres URL powiadomienia o zakończonym zadaniu
      pole opcjonalne
      po zakończeniu zadania powiadomimy Cię żądaniem GET wysłanym na podany adres URL
      możesz użyć ciągu ‘$id’ jako zmiennej $id, a ‘$tag’ jako zmiennej $tag zakodowanej w adresie URL. Przed wysłaniem żądania ustawimy wymagane wartości.
      przykład:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      Uwaga: znaki specjalne w pingback_url zostaną zakodowane w adresie URL;
      m.in. znak # zostanie zakodowany jako %23

      więcej informacji znajdziesz w Centrum pomocy

    • postback_data
      Typ: string

      typ danych postback_url
      pole wymagane, jeśli podasz postback_url
      odpowiada typowi danych, który zostanie wysłany na Twój serwer
      możliwe wartości:
      regular, html

    • postback_url
      Typ: string | null

      adres URL do wysyłania wyników zadania
      pole opcjonalne
      po zakończeniu zadania wyślemy żądanie POST z wynikami skompresowanymi w formacie gzip na podany postback_url
      możesz użyć ciągu ‘$id’ jako zmiennej $id, a ‘$tag’ jako zmiennej $tag zakodowanej w adresie URL. Przed wysłaniem żądania ustawimy wymagane wartości.
      przykład:
      http://your-server.com/postbackscript?id=$id
      http://your-server.com/postbackscript?id=$id&tag=$tag
      Uwaga: znaki specjalne w postback_url zostaną zakodowane w adresie URL;
      m.in. znak # zostanie zakodowany jako %23

      więcej informacji znajdziesz w Centrum pomocy

    • priority
      Typ: integer | null

      priorytet zadania
      pole opcjonalne
      może przyjmować następujące wartości:
      1 – normalny priorytet wykonania (ustawiany domyślnie)
      2 – wysoki priorytet wykonania
      Za zadania o wysokim priorytecie wykonania zostanie naliczona dodatkowa opłata.
      Koszt można obliczyć na stronie Cennik.

    • stop_crawl_on_match
      Typ: array (object | null)[] | null

      tablica celów do zatrzymania indeksowania pole opcjonalne jeśli zostanie podana, odpowiedź będzie zawierać wyniki SERP do wskazanego match_value włącznie; w tej tablicy możesz podać do 10 wartości docelowych przykład: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] więcej o tym parametrze przeczytasz w naszym Centrum pomocy — https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Twoje konto zostanie obciążone za każdy SERP przeszukany przez wskazane cele

      • match_type
        Typ: string | null

        typ dopasowania celu pole wymagane, jeśli podano stop_crawl_on_match; typ dopasowania dla match_value możliwe wartości: domain, with_subdomains, wildcard

      • match_value
        Typ: string | null

        domena docelowa lub wartość wieloznaczna pole wymagane, jeśli podano stop_crawl_on_match; podaj domenę docelową lub wartość wieloznaczną; Uwaga: nazwę domeny należy podać bez protokołu żądania; przykład: dataforseo.com

    • tag
      Typ: string | null

      identyfikator zadania zdefiniowany przez użytkownika
      pole opcjonalne
      limit znaków: 255
      ten parametr służy do identyfikacji zadania i dopasowania go do wyniku
      podaną wartość tag znajdziesz w obiekcie data odpowiedzi

Odpowiedzi
  • 200
    Typ: object | null · Response36Afe1097B20_SerpBaiduOrganicTaskPostResponseInfo
    • cost
      Typ: number | null Format: double

      łączny koszt zadań, USD

    • status_code
      Typ: integer | null

      ogólny kod statusu pełną listę kodów odpowiedzi znajdziesz tutaj

    • status_message
      Typ: string | null

      ogólny komunikat informacyjny pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

    • tasks
      Typ: array (object | null)[] | null

      tablica zadań

      • Typ: object | null · Response36Afe1097B20_SerpBaiduOrganicTaskPostTaskInfo
        • cost
          Typ: number | null Format: double

          łączny koszt zadań, USD

        • data
          Typ: object | null

          zawiera te same parametry, które podano w żądaniu POST

          • propertyName
            Typ: object | null
        • id
          Typ: string | null

          identyfikator zadania unikalny identyfikator zadania w naszym systemie w formacie UUID

        • path
          Typ: array (string | null)[] | null

          ścieżka URL

        • result
          Typ: object | null

          tablica wyników
          w tym przypadku wartością będzie null

        • result_count
          Typ: integer | null Format: int64

          liczba elementów w tablicy result

        • status_code
          Typ: integer | null

          kod statusu zadania wygenerowany przez DataForSEO; może mieścić się w następującym zakresie: 10000-60000 pełną listę kodów odpowiedzi znajdziesz tutaj

        • status_message
          Typ: string | null

          komunikat informacyjny zadania pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

        • time
          Typ: string | null

          czas wykonania, sekundy

    • tasks_count
      Typ: integer | null Format: int64

      liczba zadań w tablicy tasks

    • tasks_error
      Typ: integer | null Format: int64

      liczba zadań w tablicy tasks zwróconych z błędem

    • time
      Typ: string | null

      łączny czas wykonania, sekundy

    • version
      Typ: string | null

      bieżąca wersja interfejsu API

    application/json
  • 400

    Nie można przetworzyć żądania. Sprawdź parametry żądania.

  • 401

    Wymagany jest prawidłowy klucz API Felo.

  • 402

    Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.

  • 403

    Konto nie ma uprawnień do wykonania tej operacji.

  • 429

    Osiągnięto limit żądań lub wydatków.

  • 502

    Usługa nie mogła ukończyć żądania.

  • 503

    API lub usługa rozliczeniowa jest tymczasowo niedostępna.

  • 504

    Upłynął limit czasu usługi podczas przetwarzania żądania.

  • default

    Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

    application/json
Request Example for post/v1/beta/dataforseo/serp/baidu/organic/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/baidu/organic/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2156,
    "keyword": "best iphone ever",
    "tag": "some_string_123",
    "priority": 2
  }
]'

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

Operacja zakończona powodzeniem

Setting Baidu Organic SERP Tasks