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

Menyetel Tugas Langsung ‘DataForSEO Trends Subregion Interests’

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

Menyetel Tugas Langsung ‘DataForSEO Trends Subregion Interests’

​

Tempat minat terhadap sesuatu kata kunci tertumpu, dipecahkan mengikut subwilayah dalam location_code. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Untuk siapa dan bukan di mana, gunakan post_dataforseo_keywords_trends_demography_live.

Referensi harga

  • Metering: Biaya respons yang dilaporkan.
  • Estimasi referensi per permintaan: USD 0.0024.
  • 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)[]
    • date_from
      Tipe: string | null

      tanggal mulai rentang waktu
      field opsional
      jika Anda tidak menentukan field ini, hari dan bulan saat ini pada tahun sebelumnya akan digunakan secara default
      nilai minimum untuk tipe web: 2004-01-01
      nilai minimum untuk tipe lain: 2008-01-01
      format tanggal: "yyyy-mm-dd"
      contoh:
      "2019-01-15"

    • date_to
      Tipe: string | null

      tanggal akhir rentang waktu
      field opsional
      jika Anda tidak menentukan field ini, tanggal hari ini akan digunakan secara default
      format tanggal: "yyyy-mm-dd"
      contoh:
      "2019-01-15"

    • keywords
      Tipe: array string[]

      kata kunci
      field wajib
      jumlah maksimum kata kunci yang dapat Anda tentukan: 5
      hindari simbol dan karakter khusus (misalnya: simbol UTF, emoji);
      jika menentukan karakter non-Latin, Anda akan menerima data untuk negara yang menggunakan karakter tersebut

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

    • location_code
      Tipe: integer | null

      kode lokasi mesin pencari
      field opsional
      jika Anda tidak menggunakan field ini, Anda akan menerima hasil global
      jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name
      Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia beserta location_code-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
      perhatikan bahwa data akan diberikan untuk negara tempat location_code yang ditentukan berada;
      contoh:
      2840

    • location_name
      Tipe: string | null

      nama lengkap lokasi mesin pencari
      field opsional
      jika Anda tidak menggunakan field ini, Anda akan menerima hasil global
      jika Anda menggunakan field ini, Anda tidak perlu menentukan location_code
      Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia beserta location_name-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
      perhatikan bahwa data akan diberikan untuk negara tempat location_name yang ditentukan berada;
      contoh:
      United Kingdom

    • 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

    • time_range
      Tipe: string | null

      rentang waktu preset
      field opsional
      jika Anda menentukan parameter date_from atau date_to, field ini akan diabaikan saat menetapkan tugas
      nilai yang mungkin untuk semua parameter type:
      past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years

    • type
      Tipe: string | null

      jenis elemen

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

          • 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

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

            berisi popularitas kata kunci dan data terkait

            • Tipe: object | null · Response36Afe1097B20_DataforseoTrendsSubregionInterestsElementItem
                • Tipe: object · Response36Afe1097B20_DataforseoTrendsSubregionInterestsElementItem
                  • type
                    Diskriminator
                    Tipe: string | null

                    jenis elemen

                  • interests
                    Tipe: array (object | null)[] | null

                    data popularitas kata kunci subregional untuk setiap istilah yang ditentukan

                    • keyword
                      Tipe: string | null

                      kata kunci relevan
                      data yang disertakan dalam elemen values didasarkan pada kata kunci ini

                    • values
                      Tipe: array (object | null)[] | null

                      berisi data tentang popularitas relatif kata kunci menurut negara atau wilayah

                      • geo_id
                        Tipe: string | null

                        pengenal lokasi
                        Anda dapat menggunakan field ini untuk mencocokkan hasil yang diperoleh dengan parameter lokasi yang ditentukan dalam permintaan
                        lihat daftar lengkap lokasi yang tersedia beserta geo_id-nya di sini atau dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        contoh:
                        US-NY

                      • geo_name
                        Tipe: string | null

                        nama lokasi
                        Anda dapat menggunakan field ini untuk mencocokkan hasil yang diperoleh dengan parameter lokasi yang ditentukan dalam permintaan
                        lihat daftar lengkap lokasi yang tersedia beserta geo_name-nya di sini atau dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        contoh:
                        Andorra

                      • value
                        Tipe: integer | null

                        tingkat popularitas kata kunci relatif di lokasi tertentu
                        mewakili tingkat popularitas kata kunci spesifik lokasi selama rentang waktu yang ditentukan;
                        dengan value ini Anda dapat memahami seberapa populer suatu kata kunci di satu lokasi dibandingkan lokasi lain;
                        perhitungan: kami menentukan nilai popularitas tertinggi untuk kata kunci relevan di semua lokasi, lalu menyatakan semua nilai lain sebagai persentase dari nilai tertinggi tersebut (100);
                        nilai 100 adalah popularitas tertinggi untuk istilah tersebut
                        nilai 50 berarti istilah tersebut setengah populer
                        nilai 0 berarti data tidak cukup untuk istilah ini

                  • interests_comparison
                    Tipe: object | null · Response36Afe1097B20_InterestsComparison

                    perbandingan data popularitas kata kunci subregional untuk parameter yang ditentukan
                    jika Anda menentukan satu kata kunci, nilainya akan menjadi null

                    • absolute_items
                      Tipe: array (object | null)[] | null

                      tingkat popularitas kata kunci di semua lokasi
                      nilai dalam array ini mewakili persentase relatif terhadap nilai maksimum di semua lokasi

                      • geo_id
                        Tipe: string | null

                        pengenal lokasi
                        Anda dapat menggunakan field ini untuk mencocokkan hasil yang diperoleh dengan parameter lokasi yang ditentukan dalam permintaan
                        lihat daftar lengkap lokasi yang tersedia beserta geo_id-nya di sini atau dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        contoh:
                        US-NY

                      • geo_name
                        Tipe: string | null

                        nama lokasi
                        Anda dapat menggunakan field ini untuk mencocokkan hasil yang diperoleh dengan parameter lokasi yang ditentukan dalam permintaan
                        lihat daftar lengkap lokasi yang tersedia beserta geo_name-nya di sini atau dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        contoh:
                        Andorra

                      • values
                        Tipe: array (string | null)[] | null

                        berisi data tentang popularitas relatif kata kunci menurut negara atau wilayah

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

                      berisi popularitas kata kunci dan data terkait

                      • geo_id
                        Tipe: string | null

                        pengenal lokasi
                        Anda dapat menggunakan field ini untuk mencocokkan hasil yang diperoleh dengan parameter lokasi yang ditentukan dalam permintaan
                        lihat daftar lengkap lokasi yang tersedia beserta geo_id-nya di sini atau dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        contoh:
                        US-NY

                      • geo_name
                        Tipe: string | null

                        nama lokasi
                        Anda dapat menggunakan field ini untuk mencocokkan hasil yang diperoleh dengan parameter lokasi yang ditentukan dalam permintaan
                        lihat daftar lengkap lokasi yang tersedia beserta geo_name-nya di sini atau dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        contoh:
                        Andorra

                      • values
                        Tipe: array (string | null)[] | null

                        berisi data tentang popularitas relatif kata kunci menurut negara atau wilayah

                  • keywords
                    Tipe: array (string | null)[] | null

                    kata kunci dalam array POST

                  • position
                    Tipe: integer | null

                    perataan elemen
                    dapat bernilai: 1, 2, 3, 4, dst.

          • items_count
            Tipe: integer | null Format: int64

            jumlah hasil yang dikembalikan dalam array items

          • keywords
            Tipe: array (string | null)[] | null

            kata kunci dalam array POST

          • language_code
            Tipe: string | null

            kode bahasa dalam array POST
            jika tidak ada data, nilainya adalah_nulln

          • location_code
            Tipe: integer | null

            kode lokasi dalam array POST
            jika tidak ada data, nilainya adalah_nulln

          • type
            Tipe: string | null

            jenis elemen

        • 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/keywords_data/dataforseo_trends/subregion_interests/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/dataforseo_trends/subregion_interests/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "rugby",
      "cricket"
    ],
    "date_from": "2023-01-01",
    "date_to": "2024-01-01",
    "type": "web",
    "location_name": "United States"
  }
]'

{
  "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": [
        {
          "keywords": [
            null
          ],
          "type": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "type": "[Max Depth Exceeded]",
              "position": "[Max Depth Exceeded]",
              "keywords": "[Max Depth Exceeded]",
              "interests": "[Max Depth Exceeded]",
              "interests_comparison": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operasi berhasil

Setting Live ‘DataForSEO Trends Subregion Interests’ Tasks