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
Server: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

​

Mengembalikan dataset yang cocok dengan kueri 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)[]
    • depth
      Tipe: integer | null

      kedalaman parsing

      field opsional

      jumlah hasil di SERP

      nilai default: 20

      nilai maksimum: 200


      Akun Anda akan ditagih untuk setiap SERP yang berisi hingga 20 hasil;

      Menetapkan kedalaman di atas 20 dapat menyebabkan biaya tambahan jika mesin pencari mengembalikan lebih dari 20 hasil;

      Jika kedalaman yang ditentukan lebih tinggi daripada jumlah hasil dalam respons, selisihnya akan dikembalikan secara otomatis ke saldo akun Anda.

    • device
      Tipe: string | null

      jenis perangkat

      field opsional

      kembalikan hasil untuk jenis perangkat tertentu

      nilai yang mungkin: desktop

    • file_formats
      Tipe: array string[] | null

      format file dataset

      field opsional

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

    • is_free
      Tipe: boolean | null

      menunjukkan apakah dataset yang ditampilkan gratis

      field opsional

      nilai yang mungkin: true, false

    • keyword
      Tipe: string

      kata kunci

      field wajib

      Anda dapat menentukan hingga 700 karakter di field keyword

      semua %## akan didekode (karakter ‘+’ juga akan didekode menjadi karakter spasi)

      jika Anda perlu menggunakan karakter “%” untuk keyword, tentukan sebagai “%25”;

      jika Anda perlu menggunakan karakter “+” untuk keyword, tentukan sebagai “%2B”;


      pelajari lebih lanjut tentang aturan dan batasan field keyword dan keywords di API DataForSEO dalam artikel Pusat Bantuan ini

    • language_code
      Tipe: string | null

      kode bahasa mesin pencari

      field opsional jika Anda tidak menentukan language_name

      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

    • last_updated
      Tipe: string | null

      terakhir kali dataset diperbarui

      field opsional

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

    • os
      Tipe: string | null

      sistem operasi perangkat

      field opsional

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

    • topics
      Tipe: array string[] | null

      topik dataset

      field opsional

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

    • usage_rights
      Tipe: string | null

      hak penggunaan dataset

      field opsional

      nilai yang mungkin: commercial, noncommercial

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

            item elemen

            • 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
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 berhasil

Live Google Dataset Search Advanced