v0.2.0-beta

OpenAPI 3.1.0

SERP Organik Yahoo Biasa 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

post/v1/beta/dataforseo/serp/yahoo/organic/live/regular

SERP Organik Yahoo Biasa Langsung

Memulangkan hasil berkedudukan untuk kata kunci di Yahoo, secara segerak. Memulangkan keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count dan items. 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: 6
  nilai maksimum: 200
  Akaun anda akan dicaj bagi setiap SERP;
  Setiap SERP Yahoo boleh mengandungi kurang daripada 10 hasil, jadi menetapkan kedalaman melebihi nilai lalai boleh menyebabkan caj tambahan ;
  Kos boleh dikira di halaman Harga.
- device
  Jenis: string | null
  
  jenis peranti
  medan pilihan
  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
- 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
- target
  Jenis: string | null
  
  domain sasaran, subdomain atau halaman web untuk mendapatkan hasil
  medan pilihan
  domain atau subdomain harus ditentukan tanpa https:// dan www.
  ambil perhatian bahawa hasil tugas khusus target hanya akan merangkumi elemen SERP yang mengandungi rentetan url;
  anda juga boleh menggunakan aksara kad bebas (‘’) untuk menentukan corak carian dalam SERP dan menyempitkan hasil;
  contoh:
  example.com - memulangkan hasil untuk laman utama laman web dengan URL, seperti https://example.com, atau https://www.example.com/, atau https://example.com/;
  example.com - memulangkan hasil untuk domain, termasuk semua halamannya;
  example.com - memulangkan hasil untuk keseluruhan domain, termasuk semua halaman dan subdomainnya;
  example.com - memulangkan hasil untuk laman utama tanpa mengira subdomain, seperti https://en.example.com;
  example.com/example-page - memulangkan hasil untuk URL yang tepat;
  example.com/example-page - memulangkan hasil untuk semua URL domain yang bermula dengan rentetan yang ditentukan
- 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_SerpYahooOrganicLiveRegularResponseInfo
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_SerpYahooOrganicLiveRegularTaskInfo
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 langsung 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 yang ditemui dalam SERP
mengandungi jenis semua hasil carian (items) yang ditemui dalam SERP yang dipulangkan
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;
nota bahawa array ini mengandungi semua jenis hasil carian yang ditemui dalam SERP yang dipulangkan;
namun, endpoint ini hanya menyediakan data untuk jenis organic, paid dan featured_snippet;
untuk mendapatkan semua item (termasuk ciri SERP dan coretan kaya) yang ditemui dalam SERP yang dipulangkan, sila rujuk endpoint Yahoo Organiс Advanced SERP

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

item dalam SERP

page
Jenis: integer | null

nombor halaman hasil carian
menunjukkan nombor halaman SERP tempat elemen berada

position
Jenis: string | null

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

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

type
Jenis: string | null

jenis elemen

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

pages_count
Jenis: integer | null Format: int64

jumlah halaman yang diambil
jumlah keseluruhan SERP yang diambil dalam hasil

refinement_chips
Jenis: object | null · Response36Afe1097B20_RefinementChipsInfo

cip penghalusan carian
sama dengan null

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

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"
  }
]'

Tunjukkan Skema

{
  "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 berjaya

SERP Organik Yahoo Biasa Langsung

PengesahanRequired

DataForSEO

SERP Organik Yahoo Biasa Langsung

Rujukan harga