Felo API PlatformFelo API Platform
Semua endpoint DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Membuat Tugas SERP Organik Baidu

Felo API Support
MIT
Server:https://openapi.felo.ai
Pustaka Klien
Shell Curl

DataForSEO

​

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

DataForSEO Operasi

Membuat Tugas SERP Organik Baidu

​

Mengantrekan hasil peringkat untuk kata kunci di Baidu, mengembalikan id tugas di tasks[0].id. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Pasangan live-nya menjawab segera dan lebih sederhana untuk satu kueri; antrekan bila batch akan melebihi satu panggilan alat.

Referensi harga

  • Metering: Biaya respons yang dilaporkan.
  • Estimasi referensi per permintaan: USD 0.02.
  • Pengali pelanggan referensi: 1.0. Jangan terapkan lagi pada jumlah pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.

Isi
application/json
  • Tipe: array (object | null)[]
    • depth
      Tipe: integer | null

      kedalaman parsing
      field opsional
      jumlah hasil di SERP
      nilai default: 10
      nilai maksimum: 700
      Akun Anda akan ditagih per setiap SERP yang berisi hingga 10 hasil;
      Menetapkan kedalaman di atas 10 dapat mengakibatkan biaya tambahan jika mesin pencari mengembalikan lebih dari 10 hasil;
      Biaya dapat dihitung di halaman Harga.

    • device
      Tipe: string | null

      jenis perangkat
      field opsional
      kembalikan hasil untuk jenis perangkat tertentu
      dapat mengambil nilai: desktop, mobile, tablet
      nilai default: desktop

    • get_website_url
      Tipe: boolean | null

      sertakan URL langsung untuk setiap hasil yang diperingkat
      field opsional
      jika diatur ke true, hasil yang dikembalikan akan berisi URL langsung dari situs web yang diperingkat
      secara default, URL dalam hasil Baidu dienkode oleh mesin pencari,
      contoh:
      http://www.baidu.com/link?url=KQt6LSwU5OHnPtB8210R8flBP40grY6lTPxH_0UO7S2kgiZMTmw3ztV0hCo5c1kLnilai default: false
      Catatan: jika diatur ke true, biaya per tugas akan dikalikan 10 karena sistem kami menjalankan permintaan terpisah untuk setiap situs web yang diperingkat guna mengembalikan URL langsungnya

    • keyword
      Tipe: string

      kata kunci
      field wajib
      Anda dapat menentukan hingga 700 karakter di field keyword
      semua %## akan didekode (karakter '+' akan didekode menjadi karakter spasi)
      jika Anda perlu menggunakan karakter “%” untuk keyword, tentukan sebagai “%25”;
      jika Anda perlu menggunakan karakter “+” untuk keyword, tentukan sebagai “%2B”

      pelajari lebih lanjut tentang aturan dan batasan field keyword dan keywords di API DataForSEO di artikel Pusat Bantuan ini

    • language_code
      Tipe: string

      kode bahasa mesin pencari
      field wajib jika Anda tidak menentukan language_name
      Anda dapat memperoleh daftar bahasa mesin pencari yang tersedia beserta language_code-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesperhatikan bahwa satu-satunya bahasa yang didukung di mesin pencari Baidu adalah Chinese (Simplified) dengan kode bahasa zh_CN. Namun, Baidu juga dapat mengembalikan hasil untuk kueri dalam bahasa lain, jadi menentukan keyword dalam bahasa Mandarin tidak wajib

      contoh:
      zh_CN

    • language_name
      Tipe: string

      nama lengkap bahasa mesin pencari
      field wajib jika Anda tidak menentukan language_code
      Anda dapat memperoleh daftar bahasa mesin pencari yang tersedia beserta language_name-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesperhatikan bahwa satu-satunya bahasa yang didukung di mesin pencari Baidu adalah Chinese (Simplified). Namun, Baidu juga dapat mengembalikan hasil untuk kueri dalam bahasa lain, jadi menentukan keyword dalam bahasa Mandarin tidak wajib

      contoh:
      Chinese (Simplified)

    • location_code
      Tipe: integer

      kode lokasi mesin pencari
      field wajib jika Anda tidak menentukan location_name atau location_coordinate
      jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name atau location_coordinate
      Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia beserta location_code-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
      contoh:
      2156

    • location_coordinate
      Tipe: string

      koordinat GPS suatu lokasi
      field wajib jika Anda tidak menentukan location_name atau location_code
      jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name atau location_code
      parameter location_coordinate harus ditentukan dalam format "latitude,longitude,radius"
      jumlah maksimum digit desimal untuk "latitude" dan "longitude": 7
      nilai minimum untuk "radius": 199.9 (mm)
      nilai maksimum untuk "radius": 199999 (mm)jika Anda menggunakan field ini, hasil yang dikembalikan akan didasarkan pada kota terdekat yang ditemukan untuk koordinat Anda. Oleh karena itu, kami tidak menyarankan menggunakan field ini karena hasilnya mungkin tidak relevan dengan koordinat yang ditentukan
      contoh:
      53.476225,-2.243572,200

    • location_name
      Tipe: string

      nama lengkap lokasi mesin pencari
      field wajib jika Anda tidak menentukan location_code atau location_coordinate
      jika Anda menggunakan field ini, Anda tidak perlu menentukan location_code atau location_coordinate
      Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia beserta location_name-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
      contoh:
      New York,New York,United States

    • max_crawl_pages
      Tipe: integer | null

      batas perayapan halaman
      field opsional
      jumlah halaman hasil penelusuran yang akan dirayapi
      nilai default: 1
      nilai maksimum: 100
      Catatan: parameter max_crawl_pages dan depth saling melengkapi;
      pelajari lebih lanjut di pusat bantuan kami

    • os
      Tipe: string | null

      sistem operasi perangkat
      field opsional
      jika Anda menentukan desktop di field device, pilih dari nilai berikut: windows, macos
      nilai default: windows
      jika Anda menentukan mobile di field device, pilih dari nilai berikut: android, ios
      nilai default: android
      jika Anda menentukan tablet di field device, pilih dari nilai berikut: android, ios
      nilai default: android

    • pingback_url
      Tipe: string | null

      URL notifikasi tugas yang selesai
      field opsional
      saat tugas selesai, kami akan memberi tahu Anda melalui permintaan GET yang dikirim ke URL yang Anda tentukan
      Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag berenkode URL. Kami akan menyetel nilai yang diperlukan sebelum mengirim permintaan.
      contoh:
      http://your-server.com/pingscript?id=$id
      http://your-server.com/pingscript?id=$id&tag=$tag
      Catatan: karakter khusus dalam pingback_url akan dienkode URL;
      yaitu, karakter # akan dienkode menjadi %23

      pelajari lebih lanjut di Pusat Bantuan kami

    • postback_data
      Tipe: string

      tipe data postback_url
      field wajib jika Anda menentukan postback_url
      sesuai dengan tipe data yang akan dikirim ke server Anda
      nilai yang mungkin:
      regular, html

    • postback_url
      Tipe: string | null

      URL untuk mengirim hasil tugas
      field opsional
      setelah tugas selesai, kami akan mengirim permintaan POST dengan hasilnya yang dikompresi dalam format gzip ke postback_url yang Anda tentukan
      Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag berenkode URL. Kami akan menyetel nilai yang diperlukan sebelum mengirim permintaan.
      contoh:
      http://your-server.com/postbackscript?id=$id
      http://your-server.com/postbackscript?id=$id&tag=$tag
      Catatan: karakter khusus dalam postback_url akan dienkode URL;
      yaitu, karakter # akan dienkode menjadi %23

      pelajari lebih lanjut di Pusat Bantuan kami

    • priority
      Tipe: integer | null

      prioritas tugas
      field opsional
      dapat mengambil nilai berikut:
      1 – prioritas eksekusi normal (ditetapkan secara default)
      2 – prioritas eksekusi tinggi
      Anda akan dikenai biaya tambahan untuk tugas dengan prioritas eksekusi tinggi.
      Biaya dapat dihitung di halaman Harga.

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

      array target untuk menghentikan perayapan field opsional jika ditentukan, respons akan berisi hasil SERP hingga dan termasuk match_value yang ditentukan; Anda dapat menentukan hingga 10 nilai target dalam array ini contoh: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] pelajari selengkapnya tentang parameter ini di Pusat Bantuan kami - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Akun Anda akan ditagih untuk setiap SERP yang dirayapi melalui target yang ditentukan

      • match_type
        Tipe: string | null

        jenis pencocokan target field wajib jika stop_crawl_on_match ditentukan; jenis pencocokan untuk match_value nilai yang mungkin: domain, with_subdomains, wildcard

      • match_value
        Tipe: string | null

        domain target atau nilai wildcard field wajib jika stop_crawl_on_match ditentukan; tentukan domain target atau nilai wildcard; Catatan: nama domain harus ditentukan tanpa protokol permintaan; contoh: dataforseo.com

    • tag
      Tipe: string | null

      pengenal tugas yang ditentukan pengguna
      field opsional
      batas karakter adalah 255
      Anda dapat menggunakan parameter ini untuk mengidentifikasi tugas dan mencocokkannya dengan hasil
      Anda akan menemukan nilai tag yang ditentukan di objek data pada respons

Respons
  • 200
    Tipe: object | null · Response36Afe1097B20_SerpBaiduOrganicTaskPostResponseInfo
    • cost
      Tipe: number | null Format: double

      total biaya tugas, USD

    • status_code
      Tipe: integer | null

      kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini

    • status_message
      Tipe: string | null

      pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

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

      array tugas

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

          total biaya tugas, USD

        • data
          Tipe: object | null

          berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST

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

          pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID

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

          Jalur URL

        • result
          Tipe: object | null

          array hasil
          dalam kasus ini, nilainya akan menjadi null

        • result_count
          Tipe: integer | null Format: int64

          jumlah elemen dalam array hasil

        • status_code
          Tipe: integer | null

          kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini

        • status_message
          Tipe: string | null

          pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

        • time
          Tipe: string | null

          waktu eksekusi, detik

    • tasks_count
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks

    • tasks_error
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks yang dikembalikan dengan error

    • time
      Tipe: string | null

      total waktu eksekusi, detik

    • version
      Tipe: string | null

      versi API saat ini

    application/json
  • 400

    Permintaan tidak dapat diproses. Periksa parameter permintaan.

  • 401

    Kunci API Felo yang valid diperlukan.

  • 402

    Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.

  • 403

    Akun tidak diizinkan melakukan operasi ini.

  • 429

    Batas permintaan atau batas pengeluaran telah tercapai.

  • 502

    Layanan tidak dapat menyelesaikan permintaan.

  • 503

    API atau layanan penagihan untuk sementara tidak tersedia.

  • 504

    Layanan kehabisan waktu saat memproses permintaan.

  • default

    Respons error; respons passthrough upstream dapat menggunakan format penyedia

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

Operasi berhasil

Setting Baidu Organic SERP Tasks