Felo API PlatformFelo API Platform
Tüm DataForSEO endpoint'leri
v0.2.0-beta
OpenAPI 3.1.0

Baidu Organik SERP Görevlerini Ayarlama

Felo API Support
MIT
Sunucu:https://openapi.felo.ai
İstemci Kitaplıkları
Shell Curl

DataForSEO

​

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

DataForSEO İşlemler

Baidu Organik SERP Görevlerini Ayarlama

​

Baidu'da bir anahtar kelime için sıralı sonuçları kuyruğa alır ve tasks[0].id içinde bir görev id değeri döndürür. DataForSEO zarfına sarılıdır: veriler tasks[0].result içinde, sonuç tasks[0].status_code içinde — reddedilen bir istek yine de HTTP 200 döndürür. Canlı eşi hemen yanıtlar ve tek bir sorgu için daha basittir; toplu iş bir araç çağrısını aşacaksa kuyruğa alın.

Fiyatlandırma referansı

  • Ölçümlendirme: bildirilen yanıt maliyeti.
  • Referans istek tahmini: USD 0.02.
  • Referans müşteri çarpanı: 1.0. Kesinleşmiş müşteri tutarına yeniden uygulamayın.

Yalnızca referans üst verisidir; hesap teklifi, garantili fiyat veya harcama üst sınırı değildir. Kaynak kredileri Felo kredisi değildir. Nihai ücretler Felo faturalandırma kayıtlarını izler.

Gövde
application/json
  • Tür: array (object | null)[]
    • depth
      Tür: integer | null

      ayrıştırma derinliği
      isteğe bağlı alan
      SERP'teki sonuç sayısı
      varsayılan değer: 10
      maksimum değer: 700
      Hesabınız 10 sonuca kadar içeren her SERP için faturalandırılır;
      10'un üzerinde derinlik ayarlamak arama motoru 10'dan fazla sonuç döndürürse ek ücretlere yol açabilir;
      Maliyet Fiyatlandırma sayfasında hesaplanabilir.

    • device
      Tür: string | null

      cihaz türü
      isteğe bağlı alan
      belirli bir cihaz türü için sonuç döndür
      şu değerleri alabilir: desktop, mobile, tablet
      varsayılan değer: desktop

    • get_website_url
      Tür: boolean | null

      sıralanan her sonuç için doğrudan URL ekle
      isteğe bağlı alan
      true olarak ayarlanırsa döndürülen sonuçlar sıralanan sitelerin doğrudan URL'lerini içerir
      varsayılan olarak Baidu sonuçlarındaki URL'ler arama motoru tarafından kodlanır,
      örnek:
      http://www.baidu.com/link?url=KQt6LSwU5OHnPtB8210R8flBP40grY6lTPxH_0UO7S2kgiZMTmw3ztV0hCo5c1kLvarsayılan değer: false
      Not: true olarak ayarlanırsa, her sıralanan site için doğrudan URL'sini döndürmek üzere sistemimiz ayrı bir istek çalıştırdığından görev başına ücret 10 ile çarpılır

    • keyword
      Tür: string

      anahtar kelime
      zorunlu alan
      keyword alanında en fazla 700 karakter belirtebilirsiniz
      tüm %## kodları çözülür (‘+’ karakteri boşluk karakteri olarak çözülür)
      keyword için “%” karakterini kullanmanız gerekiyorsa “%25” olarak belirtin;
      keyword için “+” karakterini kullanmanız gerekiyorsa “%2B” olarak belirtin

      DataForSEO API'lerinde keyword ve keywords alanlarının kural ve sınırlamaları hakkında daha fazla bilgi için Yardım Merkezi makalesine bakın

    • language_code
      Tür: string

      arama motoru dil kodu
      language_name belirtmezseniz zorunlu alan
      arama motorunun mevcut dillerinin listesini language_code değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesnot: Baidu arama motorunda desteklenen tek dil zh_CN dil koduna sahip Chinese (Simplified) dilidir. Ancak Baidu başka dillerdeki sorgular için de sonuç döndürebilir, bu nedenle keyword değerini Çince belirtmek zorunlu değildir

      örnek:
      zh_CN

    • language_name
      Tür: string

      arama motoru dilinin tam adı
      language_code belirtmezseniz zorunlu alan
      arama motorunun mevcut dillerinin listesini language_name değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesnot: Baidu arama motorunda desteklenen tek dil Chinese (Simplified) dilidir. Ancak Baidu başka dillerdeki sorgular için de sonuç döndürebilir, bu nedenle keyword değerini Çince belirtmek zorunlu değildir

      örnek:
      Chinese (Simplified)

    • location_code
      Tür: integer

      arama motoru konum kodu
      location_name veya location_coordinate belirtmezseniz zorunlu alan
      bu alanı kullanırsanız location_name veya location_coordinate belirtmeniz gerekmez
      arama motorlarının mevcut konumlarının listesini location_code değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
      örnek:
      2156

    • location_coordinate
      Tür: string

      bir konumun GPS koordinatları
      location_name veya location_code belirtmezseniz zorunlu alan
      bu alanı kullanırsanız location_name veya location_code belirtmeniz gerekmez
      location_coordinate parametresi "latitude,longitude,radius" biçiminde belirtilmelidir
      "latitude" ve "longitude" için maksimum ondalık basamak sayısı: 7
      "radius" için minimum değer: 199.9 (mm)
      "radius" için maksimum değer: 199999 (mm)bu alanı kullanırsanız döndürülen sonuçlar koordinatlarınız için bulunan en yakın şehre dayanır. Bu nedenle sonuçlar belirtilen koordinatlarla ilgili olmayabileceğinden bu alanı kullanmanızı önermiyoruz
      örnek:
      53.476225,-2.243572,200

    • location_name
      Tür: string

      arama motoru konumunun tam adı
      location_code veya location_coordinate belirtmezseniz zorunlu alan
      bu alanı kullanırsanız location_code veya location_coordinate belirtmeniz gerekmez
      arama motorunun mevcut konumlarının listesini location_name değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
      örnek:
      New York,New York,United States

    • max_crawl_pages
      Tür: integer | null

      sayfa tarama limiti
      isteğe bağlı alan
      taranacak arama sonuçları sayfası sayısı
      varsayılan değer: 1
      maksimum değer: 100
      Not: max_crawl_pages ve depth parametreleri birbirini tamamlar;
      daha fazla bilgi için yardım merkezimize bakın

    • os
      Tür: string | null

      cihaz işletim sistemi
      isteğe bağlı alan
      device alanında desktop belirtirseniz şu değerlerden birini seçin: windows, macos
      varsayılan değer: windows
      device alanında mobile belirtirseniz şu değerlerden birini seçin: android, ios
      varsayılan değer: android
      device alanında tablet belirtirseniz şu değerlerden birini seçin: android, ios
      varsayılan değer: android

    • pingback_url
      Tür: string | null

      tamamlanan görevin bildirim URL'si
      isteğe bağlı alan
      görev tamamlandığında belirttiğiniz URL'ye gönderilen GET isteğiyle sizi bilgilendireceğiz
      ‘$id’ dizesini $id değişkeni, ‘$tag’ dizesini ise URL kodlu $tag değişkeni olarak kullanabilirsiniz. İsteği göndermeden önce gerekli değerleri ayarlayacağız.
      örnek:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      Not: pingback_url içindeki özel karakterler URL kodlanır;
      yani, # karakteri %23 olarak kodlanır

      daha fazla bilgi için Yardım Merkezimize bakın

    • postback_data
      Tür: string

      postback_url veri türü
      postback_url belirtirseniz zorunlu alan
      sunucunuza gönderilecek veri türüne karşılık gelir
      olası değerler:
      regular, html

    • postback_url
      Tür: string | null

      görev sonuçlarını göndermek için URL
      isteğe bağlı alan
      görev tamamlandığında sonuçlarını gzip biçiminde sıkıştırarak belirttiğiniz postback_url adresine POST isteğiyle göndereceğiz
      ‘$id’ dizesini $id değişkeni, ‘$tag’ dizesini ise URL kodlu $tag değişkeni olarak kullanabilirsiniz. İsteği göndermeden önce gerekli değerleri ayarlayacağız.
      örnek:
      http://your-server.com/postbackscript?id=$id
      http://your-server.com/postbackscript?id=$id&tag=$tag
      Not: postback_url içindeki özel karakterler URL kodlanır;
      yani, # karakteri %23 olarak kodlanır

      daha fazla bilgi için Yardım Merkezimize bakın

    • priority
      Tür: integer | null

      görev önceliği
      isteğe bağlı alan
      şu değerleri alabilir:
      1 – normal yürütme önceliği (varsayılan olarak ayarlanır)
      2 – yüksek yürütme önceliği
      Yüksek yürütme önceliğine sahip görevler için ek ücret alınır.
      Maliyet Fiyatlandırma sayfasında hesaplanabilir.

    • stop_crawl_on_match
      Tür: array (object | null)[] | null

      taramayı durduracak hedef dizisi isteğe bağlı alan belirtilirse yanıt, belirtilen match_value dahil olmak üzere bu değere kadar SERP sonuçlarını içerir; bu dizide en fazla 10 hedef değer belirtebilirsiniz örnek: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] bu parametre hakkında daha fazla bilgi için Yardım Merkezimize bakın — https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Hesabınız, belirtilen hedefler üzerinden taranan her SERP için faturalandırılır

      • match_type
        Tür: string | null

        hedef eşleme türü stop_crawl_on_match belirtilirse zorunlu alan; match_value için eşleme türü olası değerler: domain, with_subdomains, wildcard

      • match_value
        Tür: string | null

        hedef alan adı veya joker değeri stop_crawl_on_match belirtilirse zorunlu alan; bir hedef alan adı veya joker değeri belirtin; Not: alan adı istek protokolü olmadan belirtilmelidir; örnek: dataforseo.com

    • tag
      Tür: string | null

      kullanıcı tanımlı görev tanımlayıcısı
      isteğe bağlı alan
      karakter sınırı 255
      bu parametreyi görevi tanımlamak ve sonuçla eşleştirmek için kullanabilirsiniz
      belirtilen tag değerini yanıtın data nesnesinde bulacaksınız

Yanıtlar
  • 200
    Tür: object | null · Response36Afe1097B20_SerpBaiduOrganicTaskPostResponseInfo
    • cost
      Tür: number | null Biçim: double

      toplam görev maliyeti, USD

    • status_code
      Tür: integer | null

      genel durum kodu yanıt kodlarının tam listesini burada bulabilirsiniz

    • status_message
      Tür: string | null

      genel bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

    • tasks
      Tür: array (object | null)[] | null

      görev dizisi

      • Tür: object | null · Response36Afe1097B20_SerpBaiduOrganicTaskPostTaskInfo
        • cost
          Tür: number | null Biçim: double

          toplam görev maliyeti, USD

        • data
          Tür: object | null

          POST isteğinde belirttiğiniz parametrelerin aynısını içerir

          • propertyName
            Tür: object | null
        • id
          Tür: string | null

          görev tanımlayıcısı sistemimizde UUID biçiminde benzersiz görev tanımlayıcısı

        • path
          Tür: array (string | null)[] | null

          URL yolu

        • result
          Tür: object | null

          sonuç dizisi
          bu durumda değer null olur

        • result_count
          Tür: integer | null Biçim: int64

          result dizisindeki öğe sayısı

        • status_code
          Tür: integer | null

          görevin durum kodu DataForSEO tarafından oluşturulur; şu aralıkta olabilir: 10000-60000 yanıt kodlarının tam listesini burada bulabilirsiniz

        • status_message
          Tür: string | null

          görevin bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

        • time
          Tür: string | null

          yürütme süresi, saniye

    • tasks_count
      Tür: integer | null Biçim: int64

      tasks dizisindeki görev sayısı

    • tasks_error
      Tür: integer | null Biçim: int64

      tasks dizisinde hata ile dönen görev sayısı

    • time
      Tür: string | null

      toplam yürütme süresi, saniye

    • version
      Tür: string | null

      API'nin geçerli sürümü

    application/json
  • 400

    İstek işlenemedi. İstek parametrelerini kontrol edin.

  • 401

    Geçerli bir Felo API anahtarı gerekir.

  • 402

    Faturalandırma koşulu karşılanmadığı için istek devam edemiyor.

  • 403

    Hesabın bu işlemi gerçekleştirme izni yok.

  • 429

    İstek veya harcama sınırına ulaşıldı.

  • 502

    Hizmet isteği tamamlayamadı.

  • 503

    API veya faturalandırma hizmeti geçici olarak kullanılamıyor.

  • 504

    İstek işlenirken hizmet zaman aşımına uğradı.

  • default

    Hata yanıtı; upstream sağlayıcıdan doğrudan aktarılan yanıtlar sağlayıcı biçimlerini kullanabilir

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

Başarılı işlem

Setting Baidu Organic SERP Tasks