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

Membuat Tugas SERP Google Maps

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 Google Maps

​

Mengantrekan map pack untuk kueri lokal, dengan peringkat, alamat, dan place id setiap bisnis di Google, 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: 100

      nilai maksimum: 700


      Akun Anda akan ditagih untuk setiap SERP yang berisi hingga 100 hasil;

      Menetapkan kedalaman di atas 100 dapat menyebabkan biaya tambahan jika mesin pencari mengembalikan lebih dari 100 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

      nilai default: desktop

      catatan: untuk perangkat mobile, hanya 20 hasil yang dikembalikan untuk setiap SERP

    • keyword
      Tipe: string

      kata kunci

      field wajib

      Anda dapat menentukan hingga 700 karakter di field keyword

      semua %## akan didekode (karakter ‘+’ juga 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 dalam artikel Pusat Bantuan ini

    • language_code
      Tipe: string

      kode bahasa mesin pencari

      field wajib jika Anda tidak menentukan language_name

      jika Anda menggunakan field ini, Anda tidak perlu menentukan language_name

      Anda dapat menerima daftar bahasa mesin pencari yang tersedia beserta language_code dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages

      contoh:

      en

    • language_name
      Tipe: string

      nama lengkap bahasa mesin pencari

      field wajib jika Anda tidak menentukan language_code

      jika Anda menggunakan field ini, Anda tidak perlu menentukan language_code

      Anda dapat menerima daftar bahasa mesin pencari yang tersedia beserta language_name dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages

      contoh:

      English

    • 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 menerima daftar lokasi mesin pencari yang tersedia beserta location_code dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations

      contoh:

      2840

    • 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,zoom"

      jika "zoom" tidak ditentukan, 17z akan diterapkan sebagai nilai default

      jumlah maksimum digit desimal untuk "latitude" dan "longitude": 7

      nilai minimum untuk "zoom": 3z

      nilai maksimum untuk "zoom": 21z

      contoh:

      52.6178549,-155.352142,20z

    • 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 yang tersedia dari mesin pencari beserta location_name dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations

      contoh:

      London,England,United Kingdom

    • max_crawl_pages
      Tipe: integer | null

      batas perayapan halaman

      field opsional

      jumlah halaman hasil pencarian yang akan dirayapi

      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

    • pingback_url
      Tipe: string | null

      URL notifikasi tugas yang selesai

      field opsional

      setelah tugas selesai, kami akan memberi tahu Anda dengan permintaan GET yang dikirim ke URL yang Anda tentukan

      Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag yang dienkode URL. Kami akan menetapkan 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 di pingback_url akan dienkode URL;

      khususnya, 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 fungsi yang Anda gunakan untuk menyetel tugas

      nilai yang mungkin:

      advanced

    • 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 yang di-urlencode. Kami akan menetapkan 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 di-urlencode;

      yaitu, karakter # akan dienkode menjadi %23


      pelajari selengkapnya 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.

    • se_domain
      Tipe: string | null

      domain mesin pencari

      field opsional

      kami memilih domain mesin pencari yang relevan secara otomatis sesuai lokasi dan bahasa yang Anda tentukan

      namun, Anda dapat menetapkan domain mesin pencari kustom di field ini

      contoh:

      google.co.uk

    • search_places
      Tipe: boolean | null

      mode pencarian tempat

      field opsional

      mode pencarian tempat memungkinkan memperoleh hasil Google Maps untuk tempat tertentu (misalnya, Apple Store di New York)

      namun, karena kekhususan algoritme perayapan kami, mode ini dapat mengganggu beberapa kueri dengan niat lokal - dan menampilkan hasil untuk lokasi yang berbeda dari yang ditentukan dalam permintaan;

      untuk menghindari gangguan ini dan mendapatkan hasil yang akurat untuk kata kunci dengan niat lokal, Anda dapat menetapkan parameter ini ke false;nilai default: true

      Catatan: jika mode search_places dinonaktifkan dan tidak ada hasil yang ditemukan di area pencarian, array results akan kosong

    • search_this_area
      Tipe: boolean | null

      tampilkan hasil dari area yang ditampilkan

      field opsional

      dapat mengambil nilai:true, false

      nilai default: true

      jika diatur ke false, mode search_this_area akan dimatikan

      Catatan: jika mode search_this_area dimatikan, daftar Google Maps dapat berisi hasil di luar area yang ditampilkan

    • 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

    • url
      Tipe: string | null

      URL langsung dari kueri pencarian

      field opsional

      Anda dapat menentukan URL langsung dan kami akan mengurainya menjadi field yang diperlukan. Perhatikan bahwa metode ini paling sulit ditangani oleh API kami dan juga mengharuskan Anda menentukan bahasa dan lokasi dengan benar di URL. Dalam sebagian besar kasus, kami tidak menyarankan metode ini.

      contoh:

      https://google.com/maps/search/pizza/@37.09024,-95.712891,4z


      Catatan: parameter mesin pencari berikut tidak didukung dan akan otomatis dibatalkan jika ditentukan di URL: allinanchor:, allintext:, allintitle:, allinurl:, cache:, define:, definition:, filetype:, id:, inanchor:, info:, intext:, intitle:, inurl:, link:, site:.
Respons
  • 200
    Tipe: object | null · Response36Afe1097B20_SerpGoogleMapsTaskPostResponseInfo
    • 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_SerpGoogleMapsTaskPostTaskInfo
        • 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/google/maps/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/maps/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein"
  }
]'

{
  "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 Google Maps SERP Tasks