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

Menetapkan Tugas SERP Google Finance Explore

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 SERP Google Finance Explore

​

Memasukkan instrumen yang dikelompokkan Google Finance mengikut tema di Google ke baris gilir, memulangkan id tugas dalam tasks[0].id. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak tetap memulangkan HTTP 200. Kembar langsung menjawab serta-merta dan lebih mudah untuk satu pertanyaan; masukkan ke baris gilir apabila kelompok akan melebihi satu panggilan alat.

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)[]
    • device
      Jenis: string | null

      jenis peranti

      medan pilihan

      pulangkan hasil untuk jenis peranti tertentu

      nilai yang mungkin: desktop

    • language_code
      Jenis: string

      kod bahasa enjin carian

      medan wajib jika anda tidak menentukan language_name

      jika anda menggunakan medan ini, anda tidak perlu menentukan language_name

      anda boleh menerima senarai bahasa enjin carian yang tersedia berserta language_code dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/google/languages

      contoh:

      en

    • language_name
      Jenis: string

      nama penuh bahasa enjin carian

      medan wajib jika anda tidak menentukan language_code

      jika anda menggunakan medan ini, anda tidak perlu menentukan language_code

      anda boleh menerima senarai bahasa enjin carian yang tersedia berserta language_name dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/google/languages

      contoh:

      English

    • location_code
      Jenis: integer

      kod lokasi enjin carian

      medan wajib jika anda tidak menentukan location_name

      jika anda menggunakan medan ini, anda tidak perlu menentukan location_name

      anda boleh menerima senarai lokasi enjin carian yang tersedia berserta location_code dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/google/locations

      contoh:

      2840

    • location_name
      Jenis: string

      nama penuh lokasi enjin carian

      medan wajib jika anda tidak menentukan location_code

      jika anda menggunakan medan ini, anda tidak perlu menentukan location_code

      anda boleh menerima senarai lokasi enjin carian yang tersedia berserta location_name dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/google/locations

      contoh:

      London,England,United Kingdom

    • news_type
      Jenis: string | null

      penapis berita kewangan

      medan pilihan

      nilai yang mungkin: top_stories, local_market, world_markets

      nilai lalai: top_stories

      Nota: jika anda menentukan local_market atau world_markets, caj setiap tugas akan didarabkan dengan 2

    • os
      Jenis: string | null

      sistem pengendalian peranti

      medan pilihan

      nilai yang mungkin: windows

    • pingback_url
      Jenis: string | null

      URL pemberitahuan tugas yang selesai

      medan pilihan

      selepas tugas selesai, kami akan memberitahu anda dengan permintaan GET yang dihantar ke URL yang anda tentukan

      anda boleh menggunakan rentetan ‘$id’ sebagai pemboleh ubah $id dan ‘$tag’ sebagai pemboleh ubah $tag yang dikodkan URL. Kami akan menetapkan nilai yang diperlukan sebelum menghantar permintaan.

      contoh:

      http://your-server.com/pingscript?id=$id

      http://your-server.com/pingscript?id=$id&tag=$tag

      Nota: aksara khas dalam pingback_url akan dikodkan URL;

      khususnya, aksara # akan dikodkan sebagai %23


      ketahui lebih lanjut di Pusat Bantuan kami

    • postback_data
      Jenis: string

      jenis data postback_url

      medan wajib jika anda menentukan postback_url

      sepadan dengan jenis data yang akan dihantar ke pelayan anda

      nilai yang mungkin: advanced, html

    • postback_url
      Jenis: string | null

      URL untuk menghantar hasil tugas

      medan pilihan

      selepas tugas selesai, kami akan menghantar permintaan POST dengan hasilnya yang dimampatkan dalam format gzip ke postback_url yang anda tentukan

      anda boleh menggunakan rentetan ‘$id’ sebagai pemboleh ubah $id dan ‘$tag’ sebagai pemboleh ubah $tag yang di-urlencode. Kami akan menetapkan nilai yang diperlukan sebelum menghantar permintaan

      contoh:

      http://your-server.com/postbackscript?id=$id

      http://your-server.com/postbackscript?id=$id&tag=$tag

      Nota: aksara khas dalam postback_url akan di-urlencode;

      iaitu, aksara # akan dikodkan menjadi %23


      ketahui lebih lanjut di Pusat Bantuan kami

    • priority
      Jenis: integer | null

      keutamaan tugas

      medan pilihan

      boleh mengambil nilai berikut:

      1 – keutamaan pelaksanaan biasa (ditetapkan secara lalai);

      2 – keutamaan pelaksanaan tinggi


      Anda akan dicaj tambahan untuk tugas dengan keutamaan pelaksanaan tinggi;

      Kos boleh dikira di halaman Harga

    • 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_SerpGoogleFinanceExploreTaskPostResponseInfo
    • 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_SerpGoogleFinanceExploreTaskPostTaskInfo
        • 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: object | null

          tatasusunan hasil
          dalam kes ini, nilainya akan menjadi null

        • 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/finance_explore/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/finance_explore/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "language_name": "English"
  }
]'

{
  "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": null
    }
  ]
}

Operasi berjaya

Setting Google Finance Explore SERP Tasks