v0.2.0-beta

OpenAPI 3.1.0

Membuat Tugas Google Jobs

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

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

Membuat Tugas Google Jobs

Mengantrekan daftar lowongan yang ditampilkan Google untuk kueri di Google, mengembalikan id tugas di tasks[0].id. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Pasangan live-nya menjawab segera dan lebih sederhana untuk satu kueri; antrekan bila batch akan melebihi satu panggilan alat.

Referensi harga

Metering: Biaya respons yang dilaporkan.
Estimasi referensi per permintaan: USD 0.02.
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)[]
- depth
  Tipe: integer | null
  
  kedalaman parsing
  
  field opsional
  
  jumlah hasil di SERP;
  
  nilai default: 10
  
  nilai maksimum: 200
  
  Akun Anda akan ditagih untuk setiap SERP yang berisi hingga 10 hasil;
  Menetapkan kedalaman di atas 10 dapat menyebabkan biaya tambahan jika mesin pencari mengembalikan lebih dari 10 hasil;
  
  Jika kedalaman yang ditentukan lebih tinggi daripada jumlah hasil dalam respons, selisihnya akan dikembalikan secara otomatis ke saldo akun Anda;
  
  Biaya dapat dihitung di halaman Harga.
- employment_type
  Tipe: array string[] | null
  
  jenis kontrak kerja
  
  field opsional
  
  jenis kontrak kerja yang hasil pencariannya akan dikembalikan;
  
  nilai yang mungkin:
  
  fulltime, partime, contractor, intern
- keyword
  Tipe: string
  
  kata kunci
  
  field wajib
  
  Anda dapat menentukan hingga 700 karakter di field keyword
  
  semua %## akan didekode (karakter ‘+’ juga akan didekode menjadi karakter spasi)
  
  jika Anda perlu menggunakan karakter “%” untuk keyword, tentukan sebagai “%25”;
  
  jika Anda perlu menggunakan karakter “+” untuk keyword, tentukan sebagai “%2B”;
  
  Catatan: kata kunci yang Anda tentukan harus menunjukkan jabatan;
  
  contoh: .net developer
  
  pelajari lebih lanjut tentang aturan dan batasan field keyword dan keywords di API DataForSEO dalam artikel Pusat Bantuan ini
- language_code
  Tipe: string
  
  kode bahasa mesin pencari
  
  field wajib jika Anda tidak menentukan language_name
  
  jika Anda menggunakan field ini, Anda tidak perlu menentukan language_name;
  
  Anda dapat menerima daftar bahasa mesin pencari yang tersedia beserta language_code dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/google/languages
  
  contoh:
  
  en
- language_name
  Tipe: string
  
  nama lengkap bahasa mesin pencari
  
  field wajib jika Anda tidak menentukan language_code
  
  jika Anda menggunakan field ini, Anda tidak perlu menentukan language_code;
  
  Anda dapat menerima daftar bahasa mesin pencari yang tersedia beserta language_name dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/google/languages
  
  contoh:
  
  English
- location_code
  Tipe: integer
  
  kode lokasi mesin pencari
  
  field wajib jika Anda tidak menentukan location_name;
  
  Anda dapat menerima daftar lokasi mesin pencari yang tersedia beserta location_code dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/google/jobs/locations
  
  contoh:
  
  2840
- location_name
  Tipe: string
  
  nama lengkap lokasi mesin pencari
  
  field wajib jika Anda tidak menentukan location_code
  
  jika Anda menggunakan field ini, Anda tidak perlu menentukan location_code;
  
  Anda dapat menerima daftar lokasi mesin pencari yang tersedia beserta location_name dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/serp/google/jobs/locations
  
  contoh:
  
  London,England,United Kingdom
- location_radius
  Tipe: string | null
  
  radius pencarian lokasi
  
  field opsional
  
  radius pencarian lokasi dalam kilometer;
  
  Catatan: untuk negara yang menggunakan sistem satuan imperial, Anda perlu mengonversi mil ke kilometer dengan mengalikan nilai dalam mil dengan 1.609;
  
  jika nilai tidak ditentukan, pencarian dilakukan di mana saja dalam lokasi yang ditentukan;
  
  nilai maksimum: 300
  
  nilai minimum: > 0
- pingback_url
  Tipe: string | null
  
  URL notifikasi tugas yang selesai
  
  field opsional
  
  setelah tugas selesai, kami akan memberi tahu Anda dengan permintaan GET yang dikirim ke URL yang Anda tentukan
  
  Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag yang dienkode URL. Kami akan menetapkan nilai yang diperlukan sebelum mengirim permintaan.
  
  contoh:
  
  http://your-server.com/pingscript?id=$id
  
  http://your-server.com/pingscript?id=$id&tag=$tag
  
  Catatan: karakter khusus di pingback_url akan dienkode URL;
  
  khususnya, karakter # akan dienkode menjadi %23
  
  pelajari lebih lanjut di Pusat Bantuan kami
- postback_data
  Tipe: string
  
  tipe data postback_url
  
  field wajib jika Anda menentukan postback_url
  
  sesuai dengan tipe data yang akan dikirim ke server Anda
  
  nilai yang mungkin:
  
  regular, advanced, html
- postback_url
  Tipe: string | null
  
  URL untuk mengirim hasil tugas
  
  field opsional
  
  setelah tugas selesai, kami akan mengirim permintaan POST dengan hasilnya yang dikompresi dalam format gzip ke postback_url yang Anda tentukan
  
  Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag yang di-urlencode. Kami akan menetapkan nilai yang diperlukan sebelum mengirim permintaan
  
  contoh:
  
  http://your-server.com/postbackscript?id=$id
  
  http://your-server.com/postbackscript?id=$id&tag=$tag
  
  Catatan: karakter khusus dalam postback_url akan di-urlencode;
  
  yaitu, karakter # akan dienkode menjadi %23
  
  pelajari selengkapnya di Pusat Bantuan kami
- priority
  Tipe: integer | null
  
  prioritas tugas
  
  field opsional
  
  dapat mengambil nilai berikut:
  
  1 – prioritas eksekusi normal (ditetapkan secara default);
  
  2 – prioritas eksekusi tinggi
  
  Anda akan dikenai biaya tambahan untuk tugas dengan prioritas eksekusi tinggi;
  Biaya dapat dihitung di halaman Harga
- 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

Respons

200
Tipe: object | null · Response36Afe1097B20_SerpGoogleJobsTaskPostResponseInfo
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_SerpGoogleJobsTaskPostTaskInfo
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: object | null

array hasil
dalam kasus ini, nilainya akan menjadi null

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

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

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/jobs/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": ".net developer"
  },
  {
    "language_name": "English",
    "location_name": "United States",
    "keyword": ".net developer",
    "tag": "some_string_123",
    "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
  }
]'

Tampilkan 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 berhasil

Membuat Tugas Google Jobs

AutentikasiRequired

DataForSEO

Membuat Tugas Google Jobs

Referensi harga