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

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

​

Memulangkan hasil berkedudukan untuk kata kunci di Yahoo, secara segerak. Sumber halaman mentah dan bukan hasil yang dihuraikan. 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: 200
      Akaun anda akan dicaj bagi setiap SERP yang mengandungi sehingga 10 hasil;
      Menetapkan kedalaman melebihi 10 boleh menyebabkan caj tambahan jika enjin carian mengembalikan lebih daripada 10 hasil;
      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 bersama language_code masing-masing 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 mendapatkan senarai bahasa enjin carian yang tersedia bersama language_name masing-masing 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-nya 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 hendaklah ditentukan dalam format "latitude,longitude,radius"
      bilangan maksimum digit perpuluhan untuk "latitude" dan "longitude": 7
      nilai minimum untuk "radius": 199.9 (mm)
      nilai maksimum untuk "radius": 199999 (mm)
      contoh:
      53.476225,-2.243572,200

    • 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 menerima senarai lokasi enjin carian yang tersedia berserta location_name-nya dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
      contoh:
      London,England,United Kingdom

    • max_crawl_pages
      Jenis: integer | null

      had crawl halaman
      medan pilihan
      bilangan halaman hasil carian untuk di-crawl
      nilai lalai: 1
      nilai maksimum: 100
      Nota: parameter max_crawl_pages dan depth saling melengkapi;
      ketahui lebih lanjut di pusat bantuan kami

    • 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

    • se_domain
      Jenis: string | null

      domain enjin carian
      medan pilihan
      kami memilih domain enjin carian yang berkaitan secara automatik mengikut lokasi dan bahasa yang anda tentukan
      namun begitu, anda boleh menetapkan domain enjin carian tersuai dalam medan ini
      contoh:
      au.search.yahoo.com, uk.search.yahoo.com, ca.search.yahoo.com, dsb.

    • search_param
      Jenis: string | null

      parameter tambahan pertanyaan carian
      medan pilihan
      lihat senarai parameter yang tersedia dan butiran tambahan di sini

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

      tatasusunan sasaran untuk menghentikan crawl medan pilihan jika ditentukan, respons akan mengandungi hasil SERP sehingga dan termasuk match_value yang ditentukan; anda boleh menentukan sehingga 10 nilai sasaran dalam tatasusunan ini contoh: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] ketahui lebih lanjut tentang parameter ini di Pusat Bantuan kami - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Akaun anda akan dicaj bagi setiap SERP yang di-crawl melalui sasaran yang ditentukan

      • match_type
        Jenis: string | null

        jenis padanan sasaran medan wajib jika stop_crawl_on_match ditentukan; jenis padanan untuk match_value nilai yang mungkin: domain, with_subdomains, wildcard

      • match_value
        Jenis: string | null

        domain sasaran atau nilai wildcard medan wajib jika stop_crawl_on_match ditentukan; tentukan domain sasaran atau nilai wildcard; Nota: nama domain mesti ditentukan tanpa protokol permintaan; contoh: dataforseo.com

    • url
      Jenis: string | null

      URL langsung pertanyaan carian
      medan pilihan
      anda boleh menentukan URL langsung dan kami akan memisahkannya kepada medan yang diperlukan. Ambil perhatian bahawa kaedah ini paling sukar diproses oleh API kami dan juga memerlukan anda menentukan bahasa dan lokasi yang tepat dalam URL. Dalam kebanyakan kes, kami tidak mengesyorkan penggunaan kaedah ini.
      contoh:
      https://search.yahoo.com/search?p=rank+checker&n=100&vl=lang_en&vc=us&ei=UTF-8

Respons
  • 200
    Jenis: object | null · Response36Afe1097B20_SerpYahooOrganicLiveHtmlResponseInfo
    • 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_SerpYahooOrganicLiveHtmlTaskInfo
        • 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

          • 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

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

            elemen hasil carian yang ditemui dalam SERP

            • date
              Jenis: string | null

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

            • html
              Jenis: string | null

              halaman HTML

            • page
              Jenis: integer | null

              nombor siri halaman HTML yang dipulangkan

          • 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

          • se_domain
            Jenis: string | null

            domain enjin carian dalam array POST

          • 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/yahoo/organic/live/html
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/yahoo/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 berjaya

Live Yahoo Organic SERP HTML