v0.2.0-beta

OpenAPI 3.1.0

Google Dataset Info Lanjutan 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

post/v1/beta/dataforseo/serp/google/dataset_info/live/advanced

Google Dataset Info Lanjutan Langsung

Mengembalikan catatan satu dataset di Google Dataset Search pada Google, secara sinkron. Mengembalikan keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count, dan items. advanced adalah pilihan default; ambil regular bila hanya daftar peringkat yang penting dan html hanya untuk memeriksa apa yang dibuang parser. 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)[]
- dataset_id
  Tipe: string
  
  ID dataset
  
  field wajib
  
  Anda dapat menemukan ID dataset di URL dataset atau item dataset dari hasil Google Dataset Search
  
  contoh:
  
  L2cvMTFqbl85ZHN6MQ==
- device
  Tipe: string | null
  
  jenis perangkat
  
  field opsional
  
  kembalikan hasil untuk jenis perangkat tertentu
  
  nilai yang mungkin: desktop
- language_code
  Tipe: string | null
  
  kode bahasa mesin pencari
  
  field opsional
  
  jika Anda menggunakan field ini, Anda tidak perlu menentukan language_name
  
  nilai yang mungkin:
  
  en
- language_name
  Tipe: string | null
  
  nama lengkap bahasa mesin pencari
  
  field opsional
  
  jika Anda menggunakan field ini, Anda tidak perlu menentukan language_code
  
  nilai yang mungkin:
  
  English
- os
  Tipe: string | null
  
  sistem operasi perangkat
  
  field opsional
  
  nilai yang mungkin: windows, macos
  
  nilai default: windows
- 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

Respons

200
Tipe: object | null · Response36Afe1097B20_SerpGoogleDatasetInfoLiveAdvancedResponseInfo
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_SerpGoogleDatasetInfoLiveAdvancedTaskInfo
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 pencari
Anda dapat menggunakannya untuk memastikan kami memberikan hasil yang akurat

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 pencarian di SERP
berisi jenis hasil pencarian (items) yang ditemukan di SERP.
jenis item yang mungkin: dataset

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

elemen hasil pencarian yang ditemukan di SERP

area_covered
Tipe: array (string | null)[] | null

daftar area yang dicakup dalam dataset
misalnya: Africa, Global

authors
Tipe: array (object | null)[] | null

daftar penulis dataset

domain
Tipe: string | null

domain tautan penulis

name
Tipe: string | null

nama penulis kumpulan data

type
Tipe: string | null

jenis elemen

url
Tipe: string | null

URL tautan penulis

dataset_description
Tipe: object | null · Response36Afe1097B20_DatasetDescription

deskripsi dataset

links
Tipe: array (object | null)[] | null

tautan yang ditampilkan dalam 'dataset_description'

description
Tipe: string | null

deskripsi elemen hasil

domain
Tipe: string | null

domain tempat tautan mengarah

snippet
Tipe: string | null

teks di samping judul tautan

title
Tipe: string | null

judul elemen tautan tertentu

type
Tipe: string | null

jenis elemen

url
Tipe: string | null

URL

xpath
Tipe: string | null

XPath elemen

text
Tipe: string | null

teks deskripsi

dataset_id
Tipe: string | null

ID dataset

dataset_providers
Tipe: array (object | null)[] | null

daftar institusi yang menyediakan dataset

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

formats
Tipe: array (object | null)[] | null

daftar format file dataset

format
Tipe: string | null

jenis format file dataset
misalnya: zip, html, csv

size
Tipe: integer | null Format: int64

ukuran file dalam byte

type
Tipe: string | null

jenis elemen

image_url
Tipe: string | null

URL gambar
URL yang mengarah ke gambar di sumber asli atau penyimpanan DataForSEO (jika sumber asli tidak tersedia)

licenses
Tipe: array (object | null)[] | null

daftar lisensi yang dikeluarkan untuk dataset

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

links
Tipe: array (object | null)[] | null

sitelinks
tautan yang ditampilkan di bawah sebagian hasil pencarian Google Dataset
jika tidak ada, nilainya adalah null

description
Tipe: string | null

deskripsi elemen hasil

domain
Tipe: string | null

domain tempat tautan mengarah

snippet
Tipe: string | null

teks di samping judul tautan

title
Tipe: string | null

judul elemen tautan tertentu

type
Tipe: string | null

jenis elemen

url
Tipe: string | null

URL

xpath
Tipe: string | null

XPath elemen

period_covered
Tipe: object | null · Response36Afe1097B20_PeriodCovered

periode yang dicakup dalam dataset

displayed_date
Tipe: string | null

periode yang ditampilkan di SERP
contoh:
Mar 2, 2020 - Dec 9, 2022

end_date
Tipe: string | null

tanggal dan waktu saat periode berakhir
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2022-12-09 02:00:00 +00:00

start_date
Tipe: string | null

tanggal dan waktu saat periode dimulai
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2020-03-02 02:00:00 +00:00

position
Tipe: string | null

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

rank_absolute
Tipe: integer | null

peringkat absolut di SERP
posisi absolut di antara semua elemen di SERP

rank_group
Tipe: integer | null

peringkat grup di SERP
posisi dalam grup elemen dengan nilai type yang sama
posisi elemen dengan nilai type berbeda dihilangkan dari rank_group

related_article
Tipe: string | null

tautan ke artikel terkait
tautan ke artikel terbitan yang terkait dengan dataset

scholarly_articles_url
Tipe: string | null

url artikel ilmiah
tautan ke daftar artikel ilmiah di Google Scholar
contoh: https://scholar.google.com/scholar?q=%2210.6084%20m9%20figshare%207427933%20v1%22

scholarly_citations_count
Tipe: integer | null Format: int64

jumlah artikel yang merujuk dataset

title
Tipe: string | null

judul elemen

type
Tipe: string | null

jenis elemen

unique_identifier
Tipe: string | null

pengenal digital suatu objek
pengenal digital unik dataset
contoh: https://doi.org/10.5061/dryad.hmgqnk9m3

updated_date
Tipe: string | null

tanggal dan waktu hasil terakhir diperbarui
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2022-11-27 02:00:00 +00:00

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

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

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

post/v1/beta/dataforseo/serp/google/dataset_info/live/advanced

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/dataset_info/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "dataset_id": "L2cvMTFqbl85ZHN6MQ=="
  }
]'

Tampilkan 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,
          "se_domain": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "item_types": [
            null
          ],
          "se_results_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "position": null,
              "xpath": null,
              "dataset_id": null,
              "title": null,
              "image_url": null,
              "scholarly_citations_count": null,
              "scholarly_articles_url": null,
              "unique_identifier": null,
              "related_article": null,
              "links": [
                "[Max Depth Exceeded]"
              ],
              "dataset_providers": [
                "[Max Depth Exceeded]"
              ],
              "formats": [
                "[Max Depth Exceeded]"
              ],
              "authors": [
                "[Max Depth Exceeded]"
              ],
              "licenses": [
                "[Max Depth Exceeded]"
              ],
              "updated_date": null,
              "area_covered": [
                "[Max Depth Exceeded]"
              ],
              "period_covered": "[Max Depth Exceeded]",
              "dataset_description": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operasi berhasil

Google Dataset Info Lanjutan Langsung

AutentikasiRequired

DataForSEO

Google Dataset Info Lanjutan Langsung

Referensi harga