v0.2.0-beta

OpenAPI 3.1.0

Menetapkan Tugas Google Autocomplete

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

post/v1/beta/dataforseo/serp/google/autocomplete/task_post

Menetapkan Tugas Google Autocomplete

Memasukkan cadangan yang ditawarkan Google semasa pertanyaan ditaip 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)[]
- client
  Jenis: string | null
  
  klien carian untuk autolengkap
  
  medan pilihan
  
  hasil autolengkap mungkin berbeza bergantung pada klien carian;
  
  nilai yang mungkin:
  
  chrome — digunakan apabila google search dibuka dalam google chrome;
  
  chrome-omni — digunakan dalam bar alamat dalam chrome;
  
  gws-wiz — digunakan pada halaman utama google search;
  
  gws-wiz-serp — digunakan pada halaman hasil enjin carian google;
  
  safari — digunakan apabila google search dibuka dalam pelayar safari;
  
  firefox — digunakan apabila google search dibuka dalam pelayar firefox;
  
  psy-ab — mungkin digunakan apabila google search dibuka dalam pelayar google chrome;
  
  toolbar — mengembalikan XML;
  
  youtube — mengembalikan JSONP;
  
  gws-wiz-local — digunakan dalam google local;
  
  img — digunakan dalam carian imej google;
  
  products-cc — digunakan dalam carian google shopping
- cursor_pointer
  Jenis: integer | null
  
  penuding kursor bar carian
  
  medan pilihan
  
  kedudukan nombor mendatar penuding kursor dalam kata kunci pada bar carian;
  
  dengan mengubah kedudukan penuding kursor, anda akan memperoleh cadangan autolengkap yang berbeza untuk kata kunci asas yang sama;
  
  nilai minimum: 0
  
  nilai lalai: nombor aksara terakhir bagi keyword yang ditentukan
  
  contoh:
  
  |which query are s - "cursor_pointer": 0
  
  which query is s| - "cursor_pointer": 16
  
  which que|ry is s - "cursor_pointer": 9
- keyword
  Jenis: string
  
  kata kunci
  
  medan wajib
  
  anda boleh menentukan sehingga 700 aksara dalam medan keyword
  
  semua %## akan dinyahkod (aksara ‘+’ juga akan dinyahkod menjadi aksara ruang)
  
  jika anda perlu menggunakan aksara “%” untuk keyword, nyatakan sebagai “%25”;
  
  jika anda perlu menggunakan aksara “+” untuk keyword, nyatakan sebagai “%2B”;
  
  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 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;
  
  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/autocomplete/locations
  
  contoh:
  
  London,England,United Kingdom
- 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
- 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_SerpGoogleAutocompleteTaskPostResponseInfo
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_SerpGoogleAutocompleteTaskPostTaskInfo
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

post/v1/beta/dataforseo/serp/google/autocomplete/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/autocomplete/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",
    "cursor_pointer": 6
  }
]'

Tunjukkan Skema

{
  "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

Menetapkan Tugas Google Autocomplete

PengesahanRequired

DataForSEO

Menetapkan Tugas Google Autocomplete

Rujukan harga