v0.2.0-beta

OpenAPI 3.1.0

Google Dataset Info Lanjutan 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/dataset_info/live/advanced

Google Dataset Info Lanjutan Langsung

Memulangkan rekod satu dataset dalam Google Dataset Search 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; gunakan regular apabila hanya senarai kedudukan yang penting dan html hanya untuk memeriksa apa yang digugurkan oleh 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.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)[]
- dataset_id
  Jenis: string
  
  ID set data
  
  medan wajib
  
  anda boleh menemui ID set data dalam URL set data atau item dataset bagi hasil Google Dataset Search
  
  contoh:
  
  L2cvMTFqbl85ZHN6MQ==
- device
  Jenis: string | null
  
  jenis peranti
  
  medan pilihan
  
  pulangkan hasil untuk jenis peranti tertentu
  
  nilai yang mungkin: desktop
- language_code
  Jenis: string | null
  
  kod bahasa enjin carian
  
  medan pilihan
  
  jika anda menggunakan medan ini, anda tidak perlu menentukan language_name
  
  nilai yang mungkin:
  
  en
- language_name
  Jenis: string | null
  
  nama penuh bahasa enjin carian
  
  medan pilihan
  
  jika anda menggunakan medan ini, anda tidak perlu menentukan language_code
  
  nilai yang mungkin:
  
  English
- os
  Jenis: string | null
  
  sistem pengendalian peranti
  
  medan pilihan
  
  nilai yang mungkin: windows, macos
  
  nilai lalai: windows
- 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_SerpGoogleDatasetInfoLiveAdvancedResponseInfo
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_SerpGoogleDatasetInfoLiveAdvancedTaskInfo
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: dataset

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

elemen hasil carian yang ditemui dalam SERP

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

senarai kawasan yang diliputi dalam dataset
contohnya: Africa, Global

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

senarai penulis dataset

domain
Jenis: string | null

domain pautan pengarang

name
Jenis: string | null

nama pengarang set data

type
Jenis: string | null

jenis elemen

url
Jenis: string | null

URL pautan pengarang

dataset_description
Jenis: object | null · Response36Afe1097B20_DatasetDescription

penerangan dataset

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

pautan yang dipaparkan dalam 'dataset_description'

description
Jenis: string | null

penerangan elemen hasil

domain
Jenis: string | null

domain tempat pautan menuju

snippet
Jenis: string | null

teks di sebelah tajuk pautan

title
Jenis: string | null

tajuk elemen pautan tertentu

type
Jenis: string | null

jenis elemen

url
Jenis: string | null

URL

xpath
Jenis: string | null

XPath elemen

text
Jenis: string | null

teks penerangan

dataset_id
Jenis: string | null

ID dataset

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

senarai institusi yang menyediakan dataset

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

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

senarai format fail dataset

format
Jenis: string | null

jenis format fail dataset
contohnya: zip, html, csv

size
Jenis: integer | null Format: int64

saiz fail dalam bait

type
Jenis: string | null

jenis elemen

image_url
Jenis: string | null

URL imej
URL yang menghala ke imej pada sumber asal atau storan DataForSEO (jika sumber asal tidak tersedia)

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

senarai lesen yang dikeluarkan untuk dataset

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

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

sitelinks
pautan yang dipaparkan di bawah sebahagian hasil carian Google Dataset
jika tiada, nilainya ialah null

description
Jenis: string | null

penerangan elemen hasil

domain
Jenis: string | null

domain tempat pautan menuju

snippet
Jenis: string | null

teks di sebelah tajuk pautan

title
Jenis: string | null

tajuk elemen pautan tertentu

type
Jenis: string | null

jenis elemen

url
Jenis: string | null

URL

xpath
Jenis: string | null

XPath elemen

period_covered
Jenis: object | null · Response36Afe1097B20_PeriodCovered

tempoh yang diliputi dalam dataset

displayed_date
Jenis: string | null

tempoh yang dipaparkan dalam SERP
contoh:
Mar 2, 2020 - Dec 9, 2022

end_date
Jenis: string | null

tarikh dan masa apabila tempoh tamat
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2022-12-09 02:00:00 +00:00

start_date
Jenis: string | null

tarikh dan masa apabila tempoh bermula
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2020-03-02 02:00:00 +00:00

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

related_article
Jenis: string | null

pautan ke artikel berkaitan
pautan ke artikel terbitan yang berkaitan dengan dataset

scholarly_articles_url
Jenis: string | null

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

scholarly_citations_count
Jenis: integer | null Format: int64

bilangan artikel yang merujuk dataset

title
Jenis: string | null

tajuk elemen

type
Jenis: string | null

jenis elemen

unique_identifier
Jenis: string | null

pengecam digital sesuatu objek
pengecam digital unik dataset
contoh: https://doi.org/10.5061/dryad.hmgqnk9m3

updated_date
Jenis: string | null

tarikh dan masa hasil terakhir dikemas kini
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2022-11-27 02:00:00 +00:00

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

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

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

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

Google Dataset Info Lanjutan Langsung

PengesahanRequired

DataForSEO

Google Dataset Info Lanjutan Langsung

Rujukan harga