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

​

Memulangkan hasil tempatan yang diperluas yang dipaparkan Google apabila pertanyaan jelas bersifat tempatan di Google, secara segerak. Memulangkan keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count dan items. advanced ialah pilihan lalai; gunakan regular apabila hanya senarai kedudukan yang penting dan html hanya untuk memeriksa apa yang digugurkan oleh penghurai. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak tetap memulangkan HTTP 200.

Rujukan harga

  • Pemeteran: Kos respons yang dilaporkan.
  • Anggaran rujukan setiap permintaan: USD 0.02.
  • Pengganda pelanggan rujukan: 1.0. Jangan gunakan semula pada amaun pelanggan yang telah diselesaikan.

Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.

Badan
application/json
  • Jenis: array (object | null)[]
    • depth
      Jenis: integer | null

      kedalaman penghuraian

      medan pilihan

      bilangan hasil dalam SERP

      nilai lalai: 10

      nilai maksimum: 100


      Akaun anda akan dicaj bagi setiap SERP yang mengandungi sehingga 10 hasil;

      Menetapkan kedalaman melebihi 10 boleh menyebabkan caj tambahan jika enjin carian memulangkan lebih daripada 10 hasil masing-masing;

      Jika kedalaman yang ditentukan lebih tinggi daripada bilangan hasil dalam respons, perbezaannya akan dipulangkan secara automatik ke baki akaun anda

      Kos boleh dikira di halaman Harga.

    • device
      Jenis: string | null

      jenis peranti

      medan pilihan

      pulangkan hasil untuk jenis peranti tertentu

      boleh mengambil nilai:desktop, mobile

      nilai lalai: desktop

    • keyword
      Jenis: string

      kata kunci

      medan wajib

      anda boleh menentukan sehingga 700 aksara dalam medan keyword

      semua %## akan dinyahkod (aksara ‘+’ akan dinyahkod menjadi aksara ruang)

      jika anda perlu menggunakan aksara “%” untuk keyword, tentukan sebagai “%25”;

      jika anda perlu menggunakan aksara “+” untuk keyword, tentukan sebagai “%2B”


      ketahui lebih lanjut tentang peraturan dan had medan keyword dan keywords dalam API DataForSEO dalam artikel Pusat Bantuan

    • language_code
      Jenis: string

      kod bahasa enjin carian

      medan wajib jika anda tidak menentukan language_name

      jika anda menggunakan medan ini, anda tidak perlu menentukan language_name

      anda boleh menerima senarai bahasa enjin carian yang tersedia berserta language_code dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages

      contoh:en

    • language_name
      Jenis: string

      nama penuh bahasa enjin carian

      medan wajib jika anda tidak menentukan language_code

      jika anda menggunakan medan ini, anda tidak perlu menentukan language_code

      anda boleh menerima senarai bahasa enjin carian yang tersedia berserta language_name dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages

      contoh:

      English

    • location_code
      Jenis: integer

      kod lokasi enjin carian

      medan wajib jika anda tidak menentukan location_name atau location_coordinate

      jika anda menggunakan medan ini, anda tidak perlu menentukan location_name atau location_coordinate

      anda boleh menerima senarai lokasi enjin carian yang tersedia berserta location_code dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations

      contoh:

      2840

    • location_coordinate
      Jenis: string

      koordinat GPS sesuatu lokasi

      medan wajib jika anda tidak menentukan location_name atau location_code

      jika anda menggunakan medan 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 digunakan sebagai nilai lalai

      bilangan maksimum digit perpuluhan untuk "latitude" dan "longitude": 7

      nilai minimum untuk "zoom": 4z

      nilai maksimum untuk "zoom": 18z

      contoh:

      52.6178549,-155.352142,20z

    • location_name
      Jenis: string

      nama penuh lokasi enjin carian

      medan wajib jika anda tidak menentukan location_code atau location_coordinate

      jika anda menggunakan medan ini, anda tidak perlu menentukan location_code atau location_coordinate

      anda boleh mendapatkan senarai lokasi tersedia bagi enjin carian berserta location_name dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations

      contoh:

      London,England,United Kingdom

    • min_rating
      Jenis: number | null Format: double

      tapis hasil mengikut penarafan minimum

      medan pilihan

      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
      Jenis: string | null

      sistem pengendalian peranti

      medan pilihan

      jika anda menentukan desktop dalam medan device, pilih daripada nilai berikut: windows, macos

      nilai lalai: windows

      jika anda menentukan mobile dalam medan device, pilih daripada nilai berikut: android, ios

      nilai lalai: android

    • priority
      Jenis: integer | null

      keutamaan tugas

      medan pilihan

      boleh mengambil nilai berikut:

      1 – keutamaan pelaksanaan biasa (ditetapkan secara lalai)

      2 – keutamaan pelaksanaan tinggi


      Anda akan dicaj tambahan untuk tugas dengan keutamaan pelaksanaan tinggi.

      Kos boleh dikira di halaman Harga.

    • tag
      Jenis: string | null

      pengecam tugas yang ditentukan pengguna

      medan pilihan

      had aksara ialah 255

      anda boleh menggunakan parameter ini untuk mengenal pasti tugas dan memadankannya dengan hasil

      anda akan menemui nilai tag yang ditentukan dalam objek data respons

    • time_filter
      Jenis: string | null

      menapis hasil mengikut waktu operasi

      medan pilihan

      dengan medan ini, anda boleh menapis tempat dalam hasil mengikut masa tempat itu dibuka kepada pelawat

      ambil perhatian bahawa Google juga mungkin memberikan hasil yang tidak sepadan dengan penapis ini

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

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

      sebagai ganti $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
    Jenis: object | null · Response36Afe1097B20_SerpGoogleLocalFinderLiveAdvancedResponseInfo
    • cost
      Jenis: number | null Format: double

      jumlah kos tugas, USD

    • status_code
      Jenis: integer | null

      kod status umum; anda boleh menemui senarai penuh kod respons di sini

    • status_message
      Jenis: string | null

      mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini

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

      tatasusunan tugas

      • Jenis: object | null · Response36Afe1097B20_SerpGoogleLocalFinderLiveAdvancedTaskInfo
        • cost
          Jenis: number | null Format: double

          jumlah kos tugas, USD

        • data
          Jenis: object | null

          mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST

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

          pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID

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

          Laluan URL

        • result
          Jenis: array (object | null)[] | null

          tatasusunan hasil

          • check_url
            Jenis: string | null

            URL terus ke hasil enjin carian
            anda boleh menggunakannya untuk memastikan bahawa kami memberikan hasil yang tepat

          • datetime
            Jenis: string | null

            tarikh dan masa hasil diterima
            dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
            contoh:
            2019-11-15 12:57:46 +00:00

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

            jenis hasil carian dalam SERP
            mengandungi jenis hasil carian (items) yang ditemui dalam SERP.
            jenis item yang mungkin:
            local_pack

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

            item elemen

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

                    jenis elemen

                  • booking_url
                    Jenis: string | null

                    URL halaman tempahan

                  • cid
                    Jenis: string | null

                    client id yang ditentukan Google

                  • description
                    Jenis: string | null

                    penerangan pautan

                  • domain
                    Jenis: string | null

                    domain laman web yang mengehos video

                  • is_paid
                    Jenis: boolean | null

                    menunjukkan sama ada elemen itu ialah iklan

                  • page
                    Jenis: integer | null

                    nombor halaman hasil carian
                    menunjukkan nombor halaman SERP tempat elemen berada

                  • phone
                    Jenis: string | null

                    nombor telefon

                  • position
                    Jenis: string | null

                    penjajaran elemen dalam SERP
                    boleh mengambil nilai berikut:
                    left, right

                  • rank_absolute
                    Jenis: integer | null

                    kedudukan mutlak dalam SERP
                    kedudukan mutlak antara semua elemen dalam SERP
                    sentiasa bersamaan 0 untuk desktop

                  • rank_group
                    Jenis: integer | null

                    kedudukan kumpulan dalam SERP
                    kedudukan dalam kumpulan elemen dengan nilai type yang sama;
                    kedudukan elemen dengan nilai type berbeza dikecualikan daripada rank_group;
                    sentiasa bersamaan 0 untuk desktop

                  • rating
                    Jenis: object | null · Response36Afe1097B20_RatingInfo

                    penilaian elemen
                    kadar populariti berdasarkan ulasan dan dipaparkan dalam SERP;
                    jika tiada, bersamaan null

                    • rating_max
                      Jenis: integer | null

                      nilai maksimum untuk rating_type

                    • rating_type
                      Jenis: string | null

                      jenis penilaian di sini anda boleh menemui elemen berikut: Max5, Percents, CustomMax

                    • value
                      Jenis: number | null Format: double

                      nilai penilaian

                    • votes_count
                      Jenis: integer | null Format: int64

                      jumlah maklum balas

                  • rectangle
                    Jenis: object | null · Response36Afe1097B20_AiModeRectangleInfo

                    parameter segi empat tepat
                    mengandungi koordinat kartesan dan dimensi piksel petikan hasil dalam SERP
                    sama dengan null jika calculate_rectangles dalam permintaan POST tidak ditetapkan kepada true

                    • height
                      Jenis: number | null Format: double

                      tinggi elemen dalam piksel

                    • width
                      Jenis: number | null Format: double

                      lebar elemen dalam piksel

                    • x
                      Jenis: number | null Format: double

                      koordinat paksi x koordinat paksi x sudut kiri atas petikan hasil, dengan sudut kiri atas skrin sebagai asalan

                    • y
                      Jenis: number | null Format: double

                      koordinat paksi y koordinat paksi y sudut kiri atas petikan hasil, dengan sudut kiri atas skrin sebagai asalan

                  • title
                    Jenis: string | null

                    tajuk baris

                  • url
                    Jenis: string | null

                    URL sumber ulasan pihak ketiga

                  • xpath
                    Jenis: string | null

                    XPath elemen

          • items_count
            Jenis: integer | null Format: int64

            bilangan hasil yang dipulangkan dalam tatasusunan items

          • keyword
            Jenis: string | null

            kata kunci yang diterima dalam array POST
            kata kunci dipulangkan dengan %## dinyahkod (aksara tambah '+' akan dinyahkod menjadi aksara ruang)

          • language_code
            Jenis: string | null

            kod bahasa dalam array POST

          • location_code
            Jenis: integer | null

            kod lokasi dalam array POST

          • refinement_chips
            Jenis: object | null · Response36Afe1097B20_RefinementChipsInfo

            cip penghalusan carian

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

              item elemen

              • domain
                Jenis: string | null

                domain dalam SERP

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

                pilihan penghalusan carian lanjut

                • domain
                  Jenis: string | null

                  domain dalam SERP

                • title
                  Jenis: string | null

                  tajuk elemen

                • type
                  Jenis: string | null

                  jenis elemen

                • url
                  Jenis: string | null

                  URL carian dengan parameter penghalusan

              • title
                Jenis: string | null

                tajuk elemen

              • type
                Jenis: string | null

                jenis elemen

              • url
                Jenis: string | null

                URL carian dengan parameter penghalusan

            • type
              Jenis: string | null

              jenis elemen

            • xpath
              Jenis: string | null

              XPath elemen

          • se_domain
            Jenis: string | null

            domain enjin carian dalam array POST

          • se_results_count
            Jenis: integer | null Format: int64

            jumlah keseluruhan hasil dalam SERP

          • spell
            Jenis: object | null · Response36Afe1097B20_SpellInfo

            pembetulan automatik enjin carian
            jika enjin carian memberikan hasil untuk kata kunci yang dibetulkan, kami akan menyatakan kata kunci yang dibetulkan oleh enjin carian dan jenis pembetulan automatiknya

            • keyword
              Jenis: string | null

              kata kunci yang diperoleh hasil daripada pembetulan automatik enjin carian keputusan akan diberikan untuk kata kunci yang dibetulkan

            • type
              Jenis: string | null

              jenis pembetulan automatik nilai yang mungkin: did_you_mean, showing_results_for, no_results_found_for, including_results_for nota: Yahoo dan Yandex hanya menyokong jenis pembetulan automatik berikut: including_results_for

          • type
            Jenis: string | null

            jenis elemen

        • result_count
          Jenis: integer | null Format: int64

          bilangan elemen dalam array hasil

        • status_code
          Jenis: integer | null

          kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini

        • status_message
          Jenis: string | null

          mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini

        • time
          Jenis: string | null

          masa pelaksanaan, saat

    • tasks_count
      Jenis: integer | null Format: int64

      bilangan tugas dalam array tasks

    • tasks_error
      Jenis: integer | null Format: int64

      bilangan tugas dalam array tasks yang dipulangkan dengan ralat

    • time
      Jenis: string | null

      jumlah masa pelaksanaan, saat

    • version
      Jenis: string | null

      versi semasa API

    application/json
  • 400

    Permintaan tidak dapat diproses. Semak parameter permintaan.

  • 401

    Kunci API Felo yang sah diperlukan.

  • 402

    Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.

  • 403

    Akaun tidak dibenarkan melakukan operasi ini.

  • 429

    Had permintaan atau had perbelanjaan telah dicapai.

  • 502

    Perkhidmatan tidak dapat menyelesaikan permintaan.

  • 503

    API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.

  • 504

    Perkhidmatan tamat masa semasa memproses permintaan.

  • default

    Respons ralat; respons passthrough huluan mungkin 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 berjaya

Live Google Local Finder SERP