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

SERP Google Local Finder Langsung

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

SERP Google Local Finder Langsung

​

Mengembalikan hasil lokal yang diperluas yang ditampilkan Google saat kueri jelas bersifat lokal di Google, secara sinkron. Mengembalikan keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count, dan items. advanced adalah pilihan default; ambil regular bila hanya daftar peringkat yang penting dan html hanya untuk memeriksa apa yang dibuang parser. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200.

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: 100


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

      Menetapkan kedalaman di atas 10 dapat menyebabkan biaya tambahan jika mesin pencari mengembalikan lebih dari 10 hasil masing-masing;

      Jika kedalaman yang ditentukan lebih tinggi daripada jumlah hasil dalam respons, selisihnya akan dikembalikan secara otomatis ke saldo akun Anda

      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

    • 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

    • 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, 9z akan diterapkan sebagai nilai default

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

      nilai minimum untuk "zoom": 4z

      nilai maksimum untuk "zoom": 18z

      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

    • min_rating
      Tipe: number | null Format: double

      filter hasil berdasarkan peringkat minimum

      field opsional

      nilai yang mungkin untuk desktop: 3.5, 4, 4.5;

      nilai yang mungkin untuk mobile: 2, 2.5, 3, 3.5, 4, 4.5

    • 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

    • 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.

    • 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

    • time_filter
      Tipe: string | null

      memfilter hasil berdasarkan jam buka

      field opsional

      dengan field ini, Anda dapat memfilter tempat dalam hasil berdasarkan waktu tempat tersebut buka untuk pengunjung

      perhatikan bahwa Google juga dapat memberikan hasil yang tidak cocok dengan filter ini

      nilai yang mungkin: "open_now", "24_hours", "$day_value", "$day_value;$time_value";

      alih-alih $day_value, gunakan salah satu nilai berikut: "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday";

      alih-alih $time_value, gunakan salah satu nilai berikut: "00", "01", "02", "03", "04", "05", "06", "07", "08", "09", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23"

      contoh: "tuesday;18"

Respons
  • 200
    Tipe: object | null · Response36Afe1097B20_SerpGoogleLocalFinderLiveAdvancedResponseInfo
    • 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_SerpGoogleLocalFinderLiveAdvancedTaskInfo
        • 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: array (object | null)[] | null

          array hasil

          • check_url
            Tipe: string | null

            URL langsung ke hasil mesin pencari
            Anda dapat menggunakannya untuk memastikan kami memberikan hasil yang tepat

          • datetime
            Tipe: string | null

            tanggal dan waktu saat hasil diterima
            dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
            misalnya:
            2019-11-15 12:57:46 +00:00

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

            jenis hasil pencarian di SERP
            berisi jenis hasil pencarian (items) yang ditemukan di SERP.
            jenis item yang mungkin:
            local_pack

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

            item elemen

            • Tipe: object | null · Response36Afe1097B20_LocalPackSerpElementItem
                • Tipe: object · Response36Afe1097B20_LocalPackSerpElementItem
                  • type
                    Diskriminator
                    Tipe: string | null

                    jenis elemen

                  • booking_url
                    Tipe: string | null

                    URL halaman pemesanan

                  • cid
                    Tipe: string | null

                    client id yang ditentukan Google

                  • description
                    Tipe: string | null

                    deskripsi tautan

                  • domain
                    Tipe: string | null

                    domain situs web yang menghosting video

                  • is_paid
                    Tipe: boolean | null

                    menunjukkan apakah elemen tersebut adalah iklan

                  • page
                    Tipe: integer | null

                    nomor halaman hasil pencarian
                    menunjukkan nomor halaman SERP tempat elemen berada

                  • phone
                    Tipe: string | null

                    nomor telepon

                  • position
                    Tipe: string | null

                    perataan elemen dalam SERP
                    dapat mengambil nilai berikut:
                    left, right

                  • rank_absolute
                    Tipe: integer | null

                    peringkat absolut di SERP
                    posisi absolut di antara semua elemen di SERP
                    selalu sama dengan 0 untuk desktop

                  • rank_group
                    Tipe: integer | null

                    peringkat grup di SERP
                    posisi dalam grup elemen dengan nilai type yang identik;
                    posisi elemen dengan nilai type berbeda dihilangkan dari rank_group;
                    selalu sama dengan 0 untuk desktop

                  • rating
                    Tipe: object | null · Response36Afe1097B20_RatingInfo

                    peringkat elemen
                    tingkat popularitas berdasarkan ulasan dan ditampilkan di SERP;
                    jika tidak ada, sama dengan null

                    • rating_max
                      Tipe: integer | null

                      nilai maksimum untuk rating_type

                    • rating_type
                      Tipe: string | null

                      jenis penilaian di sini Anda dapat menemukan elemen berikut: Max5, Percents, CustomMax

                    • value
                      Tipe: number | null Format: double

                      nilai penilaian

                    • votes_count
                      Tipe: integer | null Format: int64

                      jumlah umpan balik

                  • rectangle
                    Tipe: object | null · Response36Afe1097B20_AiModeRectangleInfo

                    parameter persegi panjang
                    berisi koordinat kartesius dan dimensi piksel cuplikan hasil di SERP
                    sama dengan null jika calculate_rectangles dalam permintaan POST tidak disetel ke true

                    • height
                      Tipe: number | null Format: double

                      tinggi elemen dalam piksel

                    • width
                      Tipe: number | null Format: double

                      lebar elemen dalam piksel

                    • x
                      Tipe: number | null Format: double

                      koordinat sumbu x koordinat sumbu x sudut kiri atas cuplikan hasil, dengan sudut kiri atas layar sebagai titik asal

                    • y
                      Tipe: number | null Format: double

                      koordinat sumbu y koordinat sumbu y sudut kiri atas cuplikan hasil, dengan sudut kiri atas layar sebagai titik asal

                  • title
                    Tipe: string | null

                    judul baris

                  • url
                    Tipe: string | null

                    URL sumber ulasan pihak ketiga

                  • xpath
                    Tipe: string | null

                    XPath elemen

          • items_count
            Tipe: integer | null Format: int64

            jumlah hasil yang dikembalikan dalam array items

          • keyword
            Tipe: string | null

            kata kunci yang diterima dalam array POST
            kata kunci dikembalikan dengan %## yang didekode (karakter plus '+' akan didekode menjadi karakter spasi)

          • language_code
            Tipe: string | null

            kode bahasa dalam array POST

          • location_code
            Tipe: integer | null

            kode lokasi dalam array POST

          • refinement_chips
            Tipe: object | null · Response36Afe1097B20_RefinementChipsInfo

            chip penyempurnaan pencarian

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

              item elemen

              • domain
                Tipe: string | null

                domain di SERP

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

                opsi penyempurnaan pencarian lebih lanjut

                • domain
                  Tipe: string | null

                  domain di SERP

                • title
                  Tipe: string | null

                  judul elemen

                • type
                  Tipe: string | null

                  jenis elemen

                • url
                  Tipe: string | null

                  URL penelusuran dengan parameter penyempurnaan

              • title
                Tipe: string | null

                judul elemen

              • type
                Tipe: string | null

                jenis elemen

              • url
                Tipe: string | null

                URL penelusuran dengan parameter penyempurnaan

            • type
              Tipe: string | null

              jenis elemen

            • xpath
              Tipe: string | null

              XPath elemen

          • se_domain
            Tipe: string | null

            domain mesin pencari dalam array POST

          • se_results_count
            Tipe: integer | null Format: int64

            jumlah total hasil di SERP

          • spell
            Tipe: object | null · Response36Afe1097B20_SpellInfo

            koreksi otomatis mesin pencari
            jika mesin pencari memberikan hasil untuk kata kunci yang telah dikoreksi, kami akan menentukan kata kunci yang dikoreksi oleh mesin pencari dan jenis koreksi otomatisnya

            • keyword
              Tipe: string | null

              kata kunci yang diperoleh sebagai hasil koreksi otomatis mesin penelusuran hasil akan diberikan untuk kata kunci yang dikoreksi

            • type
              Tipe: string | null

              jenis koreksi otomatis nilai yang mungkin: did_you_mean, showing_results_for, no_results_found_for, including_results_for catatan: Yahoo dan Yandex hanya mendukung jenis koreksi otomatis berikut: including_results_for

          • type
            Tipe: string | null

            jenis elemen

        • 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/local_finder/live/advanced
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/local_finder/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "local nail services",
    "min_rating": 4.5,
    "time_filter": "monday"
  }
]'

{
  "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": [
        {
          "keyword": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "refinement_chips": {
            "type": null,
            "xpath": null,
            "items": [
              "[Max Depth Exceeded]"
            ]
          },
          "item_types": [
            null
          ],
          "se_results_count": null,
          "items_count": null,
          "items": [
            {
              "type": "[Max Depth Exceeded]",
              "page": "[Max Depth Exceeded]",
              "position": "[Max Depth Exceeded]",
              "xpath": "[Max Depth Exceeded]",
              "rectangle": "[Max Depth Exceeded]",
              "rank_group": "[Max Depth Exceeded]",
              "rank_absolute": "[Max Depth Exceeded]",
              "title": "[Max Depth Exceeded]",
              "description": "[Max Depth Exceeded]",
              "domain": "[Max Depth Exceeded]",
              "phone": "[Max Depth Exceeded]",
              "booking_url": "[Max Depth Exceeded]",
              "url": "[Max Depth Exceeded]",
              "is_paid": "[Max Depth Exceeded]",
              "rating": "[Max Depth Exceeded]",
              "cid": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operasi berhasil

Live Google Local Finder SERP