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

Google Dataset Search 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

Google Dataset Search Lanjutan Langsung

​

Memulangkan dataset yang sepadan dengan pertanyaan 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)[]
    • depth
      Jenis: integer | null

      kedalaman penghuraian

      medan pilihan

      bilangan hasil dalam SERP

      nilai lalai: 20

      nilai maksimum: 200


      Akaun anda akan dicaj bagi setiap SERP yang mengandungi sehingga 20 hasil;

      Menetapkan kedalaman melebihi 20 boleh menyebabkan caj tambahan jika enjin carian memulangkan lebih daripada 20 hasil;

      Jika kedalaman yang ditentukan lebih tinggi daripada bilangan hasil dalam respons, perbezaannya akan dipulangkan secara automatik ke baki akaun anda.

    • device
      Jenis: string | null

      jenis peranti

      medan pilihan

      pulangkan hasil untuk jenis peranti tertentu

      nilai yang mungkin: desktop

    • file_formats
      Jenis: array string[] | null

      format fail set data

      medan pilihan

      nilai yang mungkin: other, archive, text, image, document, tabular

    • is_free
      Jenis: boolean | null

      menunjukkan sama ada set data yang dipaparkan adalah percuma

      medan pilihan

      nilai yang mungkin: true, false

    • keyword
      Jenis: string

      kata kunci

      medan wajib

      anda boleh menentukan sehingga 700 aksara dalam medan keyword

      semua %## akan dinyahkod (aksara ‘+’ juga akan dinyahkod menjadi aksara ruang)

      jika anda perlu menggunakan aksara “%” untuk keyword, nyatakan sebagai “%25”;

      jika anda perlu menggunakan aksara “+” untuk keyword, nyatakan sebagai “%2B”;


      ketahui lebih lanjut tentang peraturan dan had medan keyword dan keywords dalam API DataForSEO dalam artikel Pusat Bantuan ini

    • language_code
      Jenis: string | null

      kod bahasa enjin carian

      medan pilihan jika anda tidak menentukan language_name

      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

    • last_updated
      Jenis: string | null

      kali terakhir set data dikemas kini

      medan pilihan

      nilai yang mungkin: 1m, 1y, 3y

    • os
      Jenis: string | null

      sistem pengendalian peranti

      medan pilihan

      pilih daripada nilai berikut: 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

    • topics
      Jenis: array string[] | null

      topik set data

      medan pilihan

      nilai yang mungkin: humanities, social_sciences, life_sciences, agriculture, natural_sciences, geo, computer, architecture_and_urban_planning, engineering

    • usage_rights
      Jenis: string | null

      hak penggunaan set data

      medan pilihan

      nilai yang mungkin: commercial, noncommercial

Respons
  • 200
    Jenis: object | null · Response36Afe1097B20_SerpGoogleDatasetSearchLiveAdvancedResponseInfo
    • 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_SerpGoogleDatasetSearchLiveAdvancedTaskInfo
        • 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

            item elemen

            • 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
Request Example for post/v1/beta/dataforseo/serp/google/dataset_search/live/advanced
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/dataset_search/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "water quality",
    "last_updated": "1m",
    "file_formats": [
      "archive",
      "image"
    ],
    "usage_rights": "noncommercial",
    "is_free": true,
    "topics": [
      "natural_sciences",
      "geo"
    ]
  }
]'

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

Live Google Dataset Search Advanced