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

Menetapkan Tugas Langsung ‘DataForSEO Trends Subregion Interests’

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

Menetapkan Tugas Langsung ‘DataForSEO Trends Subregion Interests’

​

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

Rujukan harga

  • Pemeteran: Kos respons yang dilaporkan.
  • Anggaran rujukan setiap permintaan: USD 0.0024.
  • 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)[]
    • date_from
      Jenis: string | null

      tarikh mula julat masa
      medan pilihan
      jika anda tidak menetapkan medan ini, hari dan bulan semasa pada tahun sebelumnya akan digunakan secara lalai
      nilai minimum untuk jenis web: 2004-01-01
      nilai minimum untuk jenis lain: 2008-01-01
      format tarikh: "yyyy-mm-dd"
      contoh:
      "2019-01-15"

    • date_to
      Jenis: string | null

      tarikh tamat julat masa
      medan pilihan
      jika anda tidak menetapkan medan ini, tarikh hari ini akan digunakan secara lalai
      format tarikh: "yyyy-mm-dd"
      contoh:
      "2019-01-15"

    • keywords
      Jenis: array string[]

      kata kunci
      medan wajib
      bilangan maksimum kata kunci yang boleh anda tentukan: 5
      elakkan simbol dan aksara khas (contohnya: simbol UTF, emoji);
      jika anda menentukan aksara bukan Latin, anda akan menerima data untuk negara yang menggunakannya

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

    • location_code
      Jenis: integer | null

      kod lokasi enjin carian
      medan pilihan
      jika anda tidak menggunakan medan ini, anda akan menerima hasil global
      jika anda menggunakan medan ini, anda tidak perlu menentukan location_name
      anda boleh menerima senarai lokasi enjin carian yang tersedia dengan location_codenya dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
      ambil perhatian bahawa data akan diberikan untuk negara tempat location_code yang ditentukan berada;
      contoh:
      2840

    • location_name
      Jenis: string | null

      nama penuh lokasi enjin carian
      medan pilihan
      jika anda tidak menggunakan medan ini, anda akan menerima hasil global
      jika anda menggunakan medan ini, anda tidak perlu menentukan location_code
      anda boleh menerima senarai lokasi enjin carian yang tersedia dengan location_namenya dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
      ambil perhatian bahawa data akan diberikan untuk negara tempat location_name yang ditentukan berada;
      contoh:
      United Kingdom

    • 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

    • time_range
      Jenis: string | null

      julat masa pratetap
      medan pilihan
      jika anda menentukan parameter date_from atau date_to, medan ini akan diabaikan semasa 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
      Jenis: string | null

      jenis elemen

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

          • 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

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

            mengandungi populariti kata kunci dan data berkaitan

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

                    jenis elemen

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

                    data populariti kata kunci subrantau bagi setiap istilah yang ditentukan

                    • keyword
                      Jenis: string | null

                      kata kunci berkaitan
                      data yang disertakan dalam elemen values adalah berdasarkan kata kunci ini

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

                      mengandungi data tentang populariti relatif kata kunci mengikut negara atau wilayah

                      • geo_id
                        Jenis: string | null

                        pengecam lokasi
                        anda boleh menggunakan medan ini untuk memadankan hasil yang diperoleh dengan parameter lokasi yang ditentukan dalam permintaan
                        lihat senarai penuh lokasi tersedia bersama geo_id masing-masing di sini atau dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        contoh:
                        US-NY

                      • geo_name
                        Jenis: string | null

                        nama lokasi
                        anda boleh menggunakan medan ini untuk memadankan hasil yang diperoleh dengan parameter lokasi yang ditentukan dalam permintaan
                        lihat senarai penuh lokasi tersedia bersama geo_name masing-masing di sini atau dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        contoh:
                        Andorra

                      • value
                        Jenis: integer | null

                        kadar populariti kata kunci relatif di lokasi tertentu
                        mewakili kadar populariti kata kunci khusus lokasi sepanjang julat masa yang ditentukan;
                        dengan value ini anda boleh memahami betapa popularnya sesuatu kata kunci di satu lokasi berbanding lokasi lain;
                        pengiraan: kami menentukan nilai populariti tertinggi bagi kata kunci berkaitan merentas semua lokasi, kemudian menyatakan semua nilai lain sebagai peratusan nilai tertinggi itu (100);
                        nilai 100 ialah populariti tertinggi bagi istilah itu
                        nilai 50 bermakna istilah itu separuh popular
                        nilai 0 bermakna data tidak mencukupi untuk istilah ini

                  • interests_comparison
                    Jenis: object | null · Response36Afe1097B20_InterestsComparison

                    perbandingan data populariti kata kunci subrantau bagi parameter yang ditentukan
                    jika anda menentukan satu kata kunci, nilainya akan menjadi null

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

                      kadar populariti kata kunci merentas semua lokasi
                      nilai dalam array ini mewakili peratusan berbanding nilai maksimum merentas semua lokasi

                      • geo_id
                        Jenis: string | null

                        pengecam lokasi
                        anda boleh menggunakan medan ini untuk memadankan hasil yang diperoleh dengan parameter lokasi yang ditentukan dalam permintaan
                        lihat senarai penuh lokasi tersedia bersama geo_id masing-masing di sini atau dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        contoh:
                        US-NY

                      • geo_name
                        Jenis: string | null

                        nama lokasi
                        anda boleh menggunakan medan ini untuk memadankan hasil yang diperoleh dengan parameter lokasi yang ditentukan dalam permintaan
                        lihat senarai penuh lokasi tersedia bersama geo_name masing-masing di sini atau dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        contoh:
                        Andorra

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

                        mengandungi data tentang populariti relatif kata kunci mengikut negara atau wilayah

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

                      mengandungi populariti kata kunci dan data berkaitan

                      • geo_id
                        Jenis: string | null

                        pengecam lokasi
                        anda boleh menggunakan medan ini untuk memadankan hasil yang diperoleh dengan parameter lokasi yang ditentukan dalam permintaan
                        lihat senarai penuh lokasi tersedia bersama geo_id masing-masing di sini atau dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        contoh:
                        US-NY

                      • geo_name
                        Jenis: string | null

                        nama lokasi
                        anda boleh menggunakan medan ini untuk memadankan hasil yang diperoleh dengan parameter lokasi yang ditentukan dalam permintaan
                        lihat senarai penuh lokasi tersedia bersama geo_name masing-masing di sini atau dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        contoh:
                        Andorra

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

                        mengandungi data tentang populariti relatif kata kunci mengikut negara atau wilayah

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

                    kata kunci dalam array POST

                  • position
                    Jenis: integer | null

                    penjajaran elemen
                    boleh mengambil nilai berikut: 1, 2, 3, 4, dsb.

          • items_count
            Jenis: integer | null Format: int64

            bilangan hasil yang dipulangkan dalam tatasusunan items

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

            kata kunci dalam array POST

          • language_code
            Jenis: string | null

            kod bahasa dalam array POST
            jika tiada data, nilainya ialah_nulln

          • location_code
            Jenis: integer | null

            kod lokasi dalam array POST
            jika tiada data, nilainya ialah_nulln

          • type
            Jenis: string | null

            jenis elemen

        • 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/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 berjaya

Setting Live ‘DataForSEO Trends Subregion Interests’ Tasks