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

Mencipta Tugas SERP Organik Google

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

Mencipta Tugas SERP Organik Google

​

Menghantar hasil berkedudukan untuk kata kunci di Google ke baris gilir dan 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. Pasangan langsungnya menjawab serta-merta dan lebih mudah untuk satu pertanyaan; hantar 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)[]
    • browser_screen_height
      Jenis: integer | null

      tinggi skrin pelayar

      medan pilihan

      anda boleh menetapkan tinggi skrin pelayar tersuai untuk mengira kedudukan piksel bagi peranti tertentu;

      boleh ditentukan dalam julat berikut: 240-9999;

      secara lalai, parameter ditetapkan kepada:

      1080 untuk desktop;

      640 untuk mobile pada android;

      812 untuk mobile pada iOS;

      Nota: untuk menggunakan parameter ini, tetapkan calculate_rectangles kepada true

    • browser_screen_resolution_ratio
      Jenis: integer | null

      nisbah resolusi skrin pelayar

      medan pilihan

      anda boleh menetapkan nisbah resolusi skrin pelayar tersuai untuk mengira kedudukan piksel bagi peranti tertentu;

      boleh ditentukan dalam julat berikut: 0.5-3;

      secara lalai, parameter ditetapkan kepada:

      1 untuk desktop;

      3 untuk mobile pada android;

      3 untuk mobile pada iOS;

      Nota: untuk menggunakan parameter ini, tetapkan calculate_rectangles kepada true

    • browser_screen_width
      Jenis: integer | null Format: int64

      lebar skrin pelayar

      medan pilihan

      anda boleh menetapkan lebar skrin pelayar tersuai untuk mengira kedudukan piksel bagi peranti tertentu;

      boleh ditentukan dalam julat berikut: 240-9999;

      secara lalai, parameter ditetapkan kepada:

      1920 untuk desktop;

      360 untuk mobile pada android;

      375 untuk mobile pada iOS;

      Nota: untuk menggunakan parameter ini, tetapkan calculate_rectangles kepada true

    • calculate_rectangles
      Jenis: boolean | null

      kira kedudukan piksel untuk elemen SERP dalam hasil lanjutan

      medan pilihan

      kedudukan piksel merujuk kepada jarak antara coretan hasil dan sudut kiri atas skrin;

      Lawati Pusat Bantuan untuk mengetahui lebih lanjut>>

      secara lalai, parameter ditetapkan kepada false

      Nota: anda akan dicaj tambahan $0.0006 kerana menggunakan parameter ini

    • depth
      Jenis: integer | null

      kedalaman penghuraian

      medan pilihan

      bilangan hasil dalam SERP

      nilai lalai: 10

      nilai maksimum: 700


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

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

      Kos boleh dikira di halaman Harga.

    • device
      Jenis: string | null

      jenis peranti

      medan pilihan

      pulangkan hasil untuk jenis peranti tertentu

      boleh mengambil nilai:desktop, mobile

      nilai lalai: desktop

    • expand_ai_overview
      Jenis: boolean | null

      kembangkan gambaran keseluruhan AI

      medan pilihan

      tetapkan kepada true untuk mengembangkan item ai_overview;

      nilai lalai: false;

      Nota: parameter ini hanya terpakai untuk hasil tugas HTML

    • find_targets_in
      Jenis: array string[] | null

      jenis elemen SERP untuk disemak bagi sasaran

      medan pilihan

      untuk mendayakan parameter ini, stop_crawl_on_match juga mesti didayakan

      tentukan jenis elemen SERP untuk disemak bagi padanan sasaran

      jika tidak ditentukan, semua elemen peringkat pertama yang mempunyai medan url dan domain akan disemak untuk sasaran

      nilai sah: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter

      Nota: tidak boleh mengandungi jenis elemen yang sama seperti ignore_targets_in

      contoh:

      "find_targets_in": ["organic", "featured_snippet"]

      ketahui lebih lanjut tentang parameter ini di Pusat Bantuan

    • group_organic_results
      Jenis: boolean | null

      paparkan hasil berkaitan

      medan pilihan

      jika ditetapkan kepada true, elemen related_result dalam respons akan disediakan sebagai coretan hasil organik asal;

      jika ditetapkan kepada false, elemen related_result akan disediakan sebagai hasil organik berasingan;

      nilai lalai: true

    • ignore_targets_in
      Jenis: array string[] | null

      jenis elemen SERP untuk dikecualikan daripada carian sasaran

      medan pilihan

      untuk mendayakan parameter ini, stop_crawl_on_match juga mesti didayakan

      tentukan jenis elemen SERP untuk dikecualikan semasa mencari padanan sasaran

      nilai sah: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter

      Nota: tidak boleh mengandungi jenis elemen yang sama seperti find_targets_in

      contoh:

      "ignore_targets_in": ["paid", "images"]

      ketahui lebih lanjut tentang parameter ini di Pusat Bantuan

    • keyword
      Jenis: string

      kata kunci

      medan wajib

      anda boleh menentukan sehingga 700 aksara dalam medan keyword

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

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

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

      jika medan ini mengandungi parameter seperti ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘cache:’, ‘define:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘site:’, caj setiap tugas akan didarab dengan 5

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

    • 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 mendapatkan senarai bahasa tersedia bagi enjin carian dengan 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 mendapatkan senarai bahasa tersedia bagi enjin carian dengan language_name dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/serp/google/languages

      contoh:

      English

    • load_async_ai_overview
      Jenis: boolean | null

      muatkan gambaran keseluruhan AI secara tak segerak

      medan pilihan

      tetapkan kepada true untuk menerima item ai_overview dalam SERP walaupun ia dimuatkan secara tak segerak;

      jika ditetapkan kepada false, anda hanya akan menerima item ai_overview daripada cache;

      nilai lalai: false

      Nota: anda akan dicaj tambahan $0.0006 kerana menggunakan parameter ini;

      jika elemen tiada atau mengandungi "asynchronous_ai_overview": false, seluruh caj tambahan akan dikembalikan ke baki akaun anda

    • location_code
      Jenis: integer

      kod lokasi enjin carian

      medan wajib jika anda tidak menentukan location_name atau location_coordinate

      jika anda menggunakan medan ini, anda tidak perlu menentukan location_name atau location_coordinate

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

      contoh:

      2840

    • location_coordinate
      Jenis: string

      koordinat GPS sesuatu lokasi

      medan wajib jika anda tidak menentukan location_name atau location_code

      jika anda menggunakan medan ini, anda tidak perlu menentukan location_name atau location_code

      parameter location_coordinate hendaklah ditentukan dalam format "latitude,longitude,radius"

      bilangan maksimum digit perpuluhan untuk "latitude" dan "longitude": 7

      nilai minimum untuk "radius": 199 (mm)

      nilai maksimum untuk "radius": 199999 (mm)

      contoh:

      53.476225,-2.243572,200

    • location_name
      Jenis: string

      nama penuh lokasi enjin carian

      medan wajib jika anda tidak menentukan location_code atau location_coordinate

      jika anda menggunakan medan ini, anda tidak perlu menentukan location_code atau location_coordinate

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

      contoh:

      London,England,United Kingdom

    • match_type
      Jenis: string

      jenis padanan sasaran

      medan wajib jika stop_crawl_on_match ditentukan

      jenis padanan untuk match_value

      nilai sah:

      domain – domain atau subdomain tertentu

      with_subdomains – domain utama dan subdomainnya

      wildcard – corak wildcard

    • match_value
      Jenis: string

      nilai domain, subdomain atau wildcard sasaran

      medan wajib jika stop_crawl_on_match ditentukan

      tentukan domain, subdomain atau nilai wildcard sasaran;

      Nota: domain atau subdomain mesti ditentukan tanpa protokol permintaan;

      contoh: "match_value": "dataforseo.com",

      "match_value": "/blog/post-*"

    • max_crawl_pages
      Jenis: integer | null

      had crawl halaman

      medan pilihan

      bilangan halaman hasil carian untuk di-crawl

      nilai maksimum: 100

      Nota: anda akan dicaj bagi setiap halaman yang di-crawl (10 hasil organik setiap halaman);

      ketahui lebih lanjut tentang harga di halaman Harga kami;

      Nota #2: parameter max_crawl_pages dan depth saling melengkapi;

      ketahui lebih lanjut di pusat bantuan kami

    • os
      Jenis: string | null

      sistem pengendalian peranti

      medan pilihan

      jika anda menentukan desktop dalam medan device, pilih daripada nilai berikut: windows, macos

      nilai lalai: windows

      jika anda menentukan mobile dalam medan device, pilih daripada nilai berikut: android, ios

      nilai lalai: android

    • people_also_ask_click_depth
      Jenis: integer | null

      klik pada elemen berkenaan

      medan pilihan

      tentukan kedalaman klik pada elemen people_also_ask untuk menerima item people_also_ask_element tambahan;

      Nota akaun anda akan dicaj tambahan $0.00015 untuk setiap klik tanpa mengira keutamaan tugas;

      jika elemen tiada atau kami melakukan lebih sedikit klik daripada yang anda tentukan, seluruh caj tambahan akan dikembalikan ke baki akaun anda

      nilai sah: dari 1 hingga 4

    • 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 sah:

      regular, 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.

    • remove_from_url
      Jenis: array string[] | null

      buang parameter tertentu daripada URL

      medan pilihan

      dengan medan ini, anda boleh menentukan sehingga 10 parameter untuk dibuang daripada URL dalam hasil

      contoh:

      "remove_from_url": ["srsltid"]

    • se_domain
      Jenis: string | null

      domain enjin carian

      medan pilihan

      kami memilih domain enjin carian yang berkaitan secara automatik mengikut lokasi dan bahasa yang anda tentukan

      namun begitu, anda boleh menetapkan domain enjin carian tersuai dalam medan ini

      contoh:

      google.co.uk, google.com.au, google.de, dsb.

    • search_param
      Jenis: string | null

      parameter tambahan pertanyaan carian

      medan pilihan

      lihat senarai parameter yang tersedia dan butiran tambahan di sini


      Nota: parameter enjin carian berikut tidak disokong dan akan dibatalkan secara automatik jika ditentukan: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
    • stop_crawl_on_match
      Jenis: array (object | null)[] | null

      tatasusunan sasaran untuk menghentikan crawl medan pilihan jika ditentukan, respons akan mengandungi hasil SERP sehingga dan termasuk match_value yang ditentukan; anda boleh menentukan sehingga 10 nilai sasaran dalam tatasusunan ini contoh: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] ketahui lebih lanjut tentang parameter ini di Pusat Bantuan kami - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Akaun anda akan dicaj bagi setiap SERP yang di-crawl melalui sasaran yang ditentukan

      • match_type
        Jenis: string | null

        jenis padanan sasaran medan wajib jika stop_crawl_on_match ditentukan; jenis padanan untuk match_value nilai yang mungkin: domain, with_subdomains, wildcard

      • match_value
        Jenis: string | null

        domain sasaran atau nilai wildcard medan wajib jika stop_crawl_on_match ditentukan; tentukan domain sasaran atau nilai wildcard; Nota: nama domain mesti ditentukan tanpa protokol permintaan; contoh: dataforseo.com

    • 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

    • target_search_mode
      Jenis: string | null

      mod padanan sasaran

      medan pilihan

      untuk mengaktifkan parameter ini, stop_crawl_on_match juga mesti diaktifkan

      menentukan cara crawl harus berhenti apabila berbilang sasaran ditentukan dalam stop_crawl_on_match

      nilai yang mungkin: all, any

      all – crawl berhenti hanya apabila semua sasaran yang ditentukan ditemui

      any – crawl berhenti apabila mana-mana sasaran tunggal ditemui

      nilai lalai: any

      ketahui lebih lanjut tentang parameter ini di Pusat Bantuan kami

    • url
      Jenis: string | null

      URL langsung bagi pertanyaan carian

      medan pilihan

      anda boleh menentukan URL langsung dan kami akan menghuraikannya kepada medan yang diperlukan. Ambil perhatian bahawa kaedah ini paling sukar diproses oleh API kami dan juga memerlukan anda menentukan bahasa dan lokasi yang tepat dalam URL. Dalam kebanyakan kes, kami tidak mengesyorkan menggunakan kaedah ini.

      contoh:

      https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS


      Nota: parameter enjin carian berikut tidak disokong dan akan dibatalkan secara automatik jika ditentukan dalam URL: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
Respons
  • 200
    Jenis: object | null · Response36Afe1097B20_SerpGoogleOrganicTaskPostResponseInfo
    • 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_SerpGoogleOrganicTaskPostTaskInfo
        • 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/organic/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/organic/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein"
  },
  {
    "language_name": "English",
    "location_name": "United States",
    "keyword": "albert einstein",
    "priority": 2,
    "tag": "some_string_123",
    "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
  },
  {
    "url": "https://www.google.co.uk/search?q=albert%20einstein&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS",
    "postback_data": "html",
    "postback_url": "https://your-server.com/postbackscript"
  }
]'

{
  "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 Organic SERP Tasks