v0.2.0-beta

OpenAPI 3.1.0

SERP Google AI Mode 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/google/ai_mode/live/advanced

SERP Google AI Mode Langsung

Memulangkan jawapan AI Mode Google untuk pertanyaan, bersama sumber yang dipetiknya 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; ambil regular apabila hanya senarai berkedudukan yang penting dan html hanya untuk memeriksa apa yang digugurkan 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.004.
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)[]
- browser_screen_height
  Jenis: integer | null
  
  tinggi skrin pelayar
  
  medan pilihan
  
  anda boleh menetapkan tinggi skrin pelayar tersuai untuk mengira kedudukan piksel bagi peranti tertentu;
  
  boleh ditentukan dalam julat berikut: 240-9999;
  
  secara lalai, parameter ditetapkan kepada:
  
  1080 untuk desktop;
  
  640 untuk mobile pada android;
  
  812 untuk mobile pada iOS;
  
  Nota: untuk menggunakan parameter ini, tetapkan calculate_rectangles kepada true
- browser_screen_resolution_ratio
  Jenis: integer | null
  
  nisbah resolusi skrin pelayar
  
  medan pilihan
  
  anda boleh menetapkan nisbah resolusi skrin pelayar tersuai untuk mengira kedudukan piksel bagi peranti tertentu;
  
  boleh ditentukan dalam julat berikut: 0.5-3;
  
  secara lalai, parameter ditetapkan kepada:
  
  1 untuk desktop;
  
  3 untuk mobile pada android;
  
  3 untuk mobile pada iOS;
  
  Nota: untuk menggunakan parameter ini, tetapkan calculate_rectangles kepada true
- browser_screen_width
  Jenis: integer | null Format: int64
  
  lebar skrin pelayar
  
  medan pilihan
  
  anda boleh menetapkan lebar skrin pelayar tersuai untuk mengira kedudukan piksel bagi peranti tertentu;
  
  boleh ditentukan dalam julat berikut: 240-9999;
  
  secara lalai, parameter ditetapkan kepada:
  
  1920 untuk desktop;
  
  360 untuk mobile pada android;
  
  375 untuk mobile pada iOS;
  
  Nota: untuk menggunakan parameter ini, tetapkan calculate_rectangles kepada true
- calculate_rectangles
  Jenis: boolean | null
  
  kira kedudukan piksel untuk elemen SERP dalam hasil lanjutan
  
  medan pilihan
  
  kedudukan piksel merujuk kepada jarak antara coretan hasil dan sudut kiri atas skrin;
  
  Lawati Pusat Bantuan untuk mengetahui lebih lanjut>>
  
  secara lalai, parameter ditetapkan kepada false
  
  Nota: jika ditetapkan kepada true, caj bagi setiap tugas akan didarabkan dengan 2
- 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-nya dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/google/ai_mode/languages
- 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-nya dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/google/ai_mode/languages;
- 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/google/locations
  
  Nota: semak Google Search Help untuk senarai negara tempat AI Mode tersedia pada masa ini
- 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,18z
- 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 dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/google/locations
  
  Nota: semak Google Search Help untuk senarai negara tempat AI Mode tersedia pada masa ini
- 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
- 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

Respons

200
Jenis: object | null · Response36Afe1097B20_SerpGoogleAiModeLiveAdvancedResponseInfo
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_SerpGoogleAiModeLiveAdvancedTaskInfo
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:
ai_overview

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

item elemen

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

item yang ada dalam elemen

position
Jenis: string | null

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

type
Jenis: string | null

jenis elemen

markdown
Jenis: string | null

kandungan elemen dalam format markdown
teks ai_overview yang diformatkan dalam bahasa markup markdown

page
Jenis: integer | null

halaman SERP
halaman SERP tempat elemen disenaraikan

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

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

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

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

rujukan tambahan yang berkaitan dengan item
merangkumi rujukan kepada halaman web yang mungkin digunakan untuk menjana ai_overview

domain
Jenis: string | null

nama domain rujukan

position
Jenis: string | null

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

source
Jenis: string | null

nama atau tajuk sumber rujukan

text
Jenis: string | null

teks komponen

title
Jenis: string | null

teks sauh pautan

type
Jenis: string | null

jenis elemen

url
Jenis: string | null

URL pautan

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 (simbol 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
dalam kes ini, nilainya akan menjadi 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;
dalam kes ini, nilainya akan menjadi null

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/google/ai_mode/live/advanced

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ai_mode/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "what is google ai mode"
  }
]'

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,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "page": null,
              "position": null,
              "xpath": null,
              "markdown": null,
              "items": [
                "[Max Depth Exceeded]"
              ],
              "references": [
                "[Max Depth Exceeded]"
              ],
              "rectangle": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operasi berjaya

SERP Google AI Mode Langsung

PengesahanRequired

DataForSEO

SERP Google AI Mode Langsung

Rujukan harga