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

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

​

Mengembalikan hasil peringkat untuk kata kunci di Yahoo, secara sinkron. Mengembalikan keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count, dan items. 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: 6
      nilai maksimum: 200
      Akun Anda akan ditagih untuk setiap SERP;
      Setiap SERP Yahoo dapat berisi kurang dari 10 hasil, sehingga menetapkan kedalaman di atas nilai default dapat mengakibatkan biaya tambahan ;
      Biaya dapat dihitung di halaman Harga.

    • device
      Tipe: string | null

      jenis perangkat
      field opsional
      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 selengkapnya 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 memperoleh daftar bahasa mesin pencari yang tersedia beserta language_code-nya 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 memperoleh daftar bahasa mesin pencari yang tersedia beserta language_name-nya 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 memperoleh daftar lokasi mesin pencari yang tersedia beserta location_code-nya 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,radius"
      jumlah maksimum digit desimal 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
      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 mesin pencari yang tersedia beserta location_name-nya 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 untuk dirayapi
      nilai default: 1
      nilai maksimum: 100
      Catatan: parameter max_crawl_pages dan depth saling melengkapi;
      pelajari selengkapnya 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:
      au.search.yahoo.com, uk.search.yahoo.com, ca.search.yahoo.com, dll.

    • search_param
      Tipe: string | null

      parameter tambahan kueri pencarian
      field opsional
      lihat daftar parameter yang tersedia dan detail tambahan di sini

    • 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
      Tipe: string | null

      domain target, subdomain, atau halaman web untuk mendapatkan hasil
      field opsional
      domain atau subdomain harus ditentukan tanpa https:// dan www.
      perhatikan bahwa hasil tugas khusus target hanya akan menyertakan elemen SERP yang berisi string url;
      Anda juga dapat menggunakan karakter wildcard (‘’) untuk menentukan pola pencarian di SERP dan mempersempit hasil;
      contoh:
      example.com - mengembalikan hasil untuk halaman beranda situs web dengan URL, seperti https://example.com, atau https://www.example.com/, atau https://example.com/;
      example.com       - mengembalikan hasil untuk domain, termasuk semua halamannya;
      example.com - mengembalikan hasil untuk seluruh domain, termasuk semua halaman dan subdomainnya;
      example.com - mengembalikan hasil untuk halaman beranda terlepas dari subdomain, seperti https://en.example.com;
      example.com/example-page - mengembalikan hasil untuk URL yang tepat;
      example.com/example-page       - mengembalikan hasil untuk semua URL domain yang dimulai dengan string yang ditentukan

    • 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://search.yahoo.com/search?p=rank+checker&n=100&vl=lang_en&vc=us&ei=UTF-8

Respons
  • 200
    Tipe: object | null · Response36Afe1097B20_SerpYahooOrganicLiveRegularResponseInfo
    • 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_SerpYahooOrganicLiveRegularTaskInfo
        • 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 penelusuran
            Anda dapat menggunakannya untuk memastikan bahwa 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 penelusuran yang ditemukan di SERP
            berisi jenis semua hasil penelusuran (items) yang ditemukan di SERP yang dikembalikan
            jenis item yang mungkin:
            featured_snippet, images, local_pack, hotels_pack, organic, paid, people_also_ask, related_searches, shopping, recipes, top_stories, video, ai_overview;
            perhatikan bahwa array ini berisi semua jenis hasil penelusuran yang ditemukan di SERP yang dikembalikan;
            namun, endpoint ini hanya menyediakan data untuk jenis organic, paid, dan featured_snippet;
            untuk mendapatkan semua item (termasuk fitur SERP dan cuplikan kaya) yang ditemukan di SERP yang dikembalikan, lihat endpoint Yahoo Organiс Advanced SERP

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

            item di SERP

            • page
              Tipe: integer | null

              nomor halaman hasil pencarian
              menunjukkan nomor halaman SERP tempat elemen berada

            • position
              Tipe: string | null

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

            • 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

            • type
              Tipe: string | null

              jenis elemen

            • 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

          • pages_count
            Tipe: integer | null Format: int64

            total halaman yang diambil
            jumlah total SERP yang diambil dalam hasil

          • refinement_chips
            Tipe: object | null · Response36Afe1097B20_RefinementChipsInfo

            chip penyempurnaan pencarian
            sama dengan null

            • 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/yahoo/organic/live/regular
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/yahoo/organic/live/regular \
  --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,
          "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,
          "pages_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "page": null,
              "position": null,
              "xpath": null,
              "rectangle": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operasi berhasil

Live Yahoo Organic SERP Regular