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

SERP Organik Google HTML 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 Organik Google HTML Langsung

​

Mengembalikan hasil peringkat untuk kata kunci di Google, secara sinkron. Sumber halaman mentah alih-alih hasil terurai. 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: 200


      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

      nilai default: desktop

    • expand_ai_overview
      Tipe: boolean | null

      perluas ikhtisar AI

      field opsional

      atur ke true untuk memperluas item ai_overview;

      nilai default: false

    • find_targets_in
      Tipe: array string[] | null

      jenis elemen SERP yang akan diperiksa untuk target

      field opsional

      untuk mengaktifkan parameter ini, stop_crawl_on_match juga harus diaktifkan

      tentukan jenis elemen SERP yang akan diperiksa untuk kecocokan target

      jika tidak ditentukan, semua elemen tingkat pertama yang memiliki field url dan domain akan diperiksa untuk target

      nilai yang mungkin: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter

      Catatan: tidak boleh berisi jenis elemen yang sama dengan ignore_targets_in

      contoh:

      "find_targets_in": ["organic", "featured_snippet"]

      pelajari lebih lanjut tentang parameter ini di Pusat Bantuan

    • ignore_targets_in
      Tipe: array string[] | null

      jenis elemen SERP yang akan dikecualikan dari pencarian target

      field opsional

      untuk mengaktifkan parameter ini, stop_crawl_on_match juga harus diaktifkan

      tentukan jenis elemen SERP yang akan dikecualikan saat mencari kecocokan target

      nilai yang mungkin: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter

      Catatan: tidak boleh berisi jenis elemen yang sama dengan find_targets_in

      contoh:

      "ignore_targets_in": ["paid", "images"]

      pelajari lebih lanjut tentang parameter ini di Pusat Bantuan

    • 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”;

      jika field ini berisi parameter seperti 'allinanchor:', 'allintext:', 'allintitle:', 'allinurl:', ‘cache:’, 'define:', 'filetype:', 'id:', 'inanchor:', 'info:', 'intext:', 'intitle:', 'inurl:', 'link:', 'related:', 'site:', biaya per tugas akan dikalikan 5

    • 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 memperoleh daftar bahasa yang tersedia dari mesin pencari dengan language_code dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/google/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 memperoleh daftar bahasa yang tersedia dari mesin pencari dengan language_name dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/google/languages

      contoh:

      English

    • load_async_ai_overview
      Tipe: boolean | null

      muat ikhtisar AI secara asinkron

      field opsional

      atur ke true untuk menerima item ai_overview di SERP meskipun dimuat secara asinkron;

      jika diatur ke false, Anda hanya akan menerima item ai_overview dari cache;

      nilai default: false

      Catatan akun Anda akan dikenai biaya tambahan $0.002 untuk setiap permintaan;

      jika elemen tidak ada atau berisi "asynchronous_ai_overview": false, seluruh biaya tambahan akan dikembalikan ke saldo akun Anda

    • 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 yang tersedia dari mesin pencari dengan location_code dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/google/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,radius"

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

      nilai minimum untuk "radius": 199 (mm)

      nilai maksimum untuk "radius": 199999 (mm)

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

      contoh:

      London,England,United Kingdom

    • match_type
      Tipe: string

      jenis kecocokan target

      field wajib jika stop_crawl_on_match ditentukan

      jenis kecocokan untuk match_value

      nilai yang mungkin:

      domain – domain atau subdomain tertentu

      with_subdomains – domain utama dan subdomainnya

      wildcard – pola wildcard

    • match_value
      Tipe: string

      nilai domain, subdomain, atau wildcard target

      field wajib jika stop_crawl_on_match ditentukan

      tentukan domain, subdomain, atau nilai wildcard target;

      Catatan: domain atau subdomain harus ditentukan tanpa protokol permintaan;

      contoh: "match_value": "dataforseo.com",

      "match_value": "/blog/post-*"

    • max_crawl_pages
      Tipe: integer | null

      batas perayapan halaman

      field opsional

      jumlah halaman hasil pencarian yang akan dirayapi

      nilai maksimum: 100

      Catatan: Anda akan ditagih untuk setiap halaman yang dirayapi (10 hasil organik per halaman);

      pelajari lebih lanjut tentang harga di halaman Harga kami;

      Catatan #2: 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

    • 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, google.com.au, google.de, dll.

    • search_param
      Tipe: string | null

      parameter tambahan dari kueri pencarian

      field opsional

      dapatkan daftar parameter yang tersedia dan detail tambahan di sini


      Catatan: parameter mesin pencari berikut tidak didukung dan akan otomatis dibatalkan jika ditentukan: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
    • 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

    • target_search_mode
      Tipe: string | null

      mode pencocokan target

      field opsional

      untuk mengaktifkan parameter ini, stop_crawl_on_match juga harus diaktifkan

      menentukan bagaimana perayapan harus berhenti ketika beberapa target ditentukan dalam stop_crawl_on_match

      nilai yang mungkin: all, any

      all – perayapan berhenti hanya ketika semua target yang ditentukan ditemukan

      any – perayapan berhenti ketika salah satu target ditemukan

      nilai default: any

      pelajari selengkapnya tentang parameter ini di Pusat Bantuan kami

    • url
      Tipe: string | null

      URL langsung dari kueri pencarian

      field opsional

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

      contoh:

      https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS


      Catatan: parameter mesin pencari berikut tidak didukung dan akan otomatis dibatalkan jika ditentukan di URL: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
Respons
  • 200
    Tipe: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveHtmlResponseInfo
    • 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_SerpGoogleOrganicLiveHtmlTaskInfo
        • 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

          • 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

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

            elemen hasil pencarian yang ditemukan di SERP

            • date
              Tipe: string | null

              tanggal dan waktu halaman HTML dipindai
              dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              contoh:
              2019-11-15 12:57:46 +00:00

            • html
              Tipe: string | null

              halaman HTML

            • page
              Tipe: integer | null

              nomor urut halaman HTML yang dikembalikan

          • 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

          • se_domain
            Tipe: string | null

            domain mesin pencari dalam array POST

          • 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/organic/live/html
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/organic/live/html \
  --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": [
        {
          "keyword": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "page": null,
              "date": null,
              "html": null
            }
          ]
        }
      ]
    }
  ]
}

Operasi berhasil

Live Google Organic SERP HTML