v0.2.0-beta

OpenAPI 3.1.0

Tugas Pencarian Daftar Bisnis Langsung

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/business_data/business_listings/search/live

Tugas Pencarian Daftar Bisnis Langsung

Menelusuri indeks DataForSEO sendiri atas daftar bisnis lokal menurut categories, description, title, dan location_coordinate - tiga serangkai lintang, bujur, dan radius. Mengembalikan total_count, count, offset, offset_token, dan items, dengan penomoran halaman memakai token. Dibungkus dalam envelope DataForSEO: data ada di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Endpoint ini membaca indeks dan menjawab segera; semua yang lain di sini mengantrekan perayapan langsung ke sumbernya. Mulailah dari sini dan telusuri hanya bagian yang penting.

Referensi harga

Pengukuran: biaya respons yang dilaporkan.
Perkiraan referensi per permintaan: USD 0,2428.
Pengali referensi pelanggan: 1,0. Jangan menerapkannya lagi pada jumlah tagihan pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukan kredit Felo. Biaya akhir mengikuti catatan penagihan Felo.

Isi

application/json

Tipe: array (object | null)[]
- categories
  Tipe: array string[] | null
  
  kategori bisnis
  field opsional
  kategori yang Anda tentukan digunakan untuk mencari daftar bisnis;
  jika Anda tidak menggunakan field ini, kami akan mengembalikan daftar bisnis yang ditemukan di lokasi yang ditentukan;
  Anda dapat menentukan hingga 10 kategori
- description
  Tipe: string | null
  
  deskripsi elemen dalam SERP
  field opsional
  deskripsi entitas bisnis yang hasilnya dikumpulkan;
  dapat berisi hingga 200 karakter
- filters
  Tipe: array (object | null)[] | null
  
  array parameter pemfilteran hasil
  field opsional
  Anda dapat menambahkan beberapa filter sekaligus (maksimum 8 filter)
  Anda harus menyetel operator logika and, or di antara kondisi
  operator berikut didukung:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
  Anda dapat menggunakan operator % dengan like dan not_like untuk mencocokkan string apa pun dengan nol atau lebih karakter
  contoh:
  ["rating.value",">",3]
  Anda dapat memperoleh daftar filter yang tersedia dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/business_data/business_listings/available_filters
  Daftar lengkap filter yang tersedia dapat dilihat di sini.
  
  Objek kosong
- is_claimed
  Tipe: boolean | null
  
  menunjukkan apakah bisnis diverifikasi oleh pemiliknya di Google Maps
  field opsional
- limit
  Tipe: integer | null
  
  jumlah maksimum bisnis yang dikembalikan
  field opsional
  nilai default: 100
  nilai maksimum: 1000
- location_coordinate
  Tipe: string | null
  
  koordinat GPS suatu lokasi
  field opsional
  Parameter location_coordinate harus ditentukan dalam format "latitude,longitude,radius"
  jumlah maksimum digit desimal untuk "latitude" dan "longitude": 7
  nilai "radius" ditentukan dalam kilometer (km)
  nilai minimum untuk "radius": 1
  nilai maksimum untuk "radius": 100000
  contoh:
  53.476225,-2.243572,200
  pelajari lebih lanjut tentang cara menyetel parameter lokasi di API ini di Pusat Bantuan kami
- offset
  Tipe: integer | null
  
  offset dalam array hasil bisnis yang dikembalikan
  field opsional
  nilai default: 0
  jika Anda menentukan nilai 10, sepuluh entitas pertama dalam array hasil akan dilewati dan data akan disediakan untuk entitas berikutnya
  Catatan: kami menyarankan menggunakan parameter ini hanya saat mengambil hingga 10.000 hasil
  untuk mengambil lebih dari 10.000 hasil, gunakan offset_token sebagai gantinya
- offset_token
  Tipe: string | null
  
  token untuk permintaan berikutnya
  field opsional
  disediakan di field yang sama pada respons setiap permintaan;
  gunakan parameter ini untuk menghindari timeout saat mencoba memperoleh lebih dari 100.000 hasil dalam satu permintaan;
  dengan menentukan nilai offset_token unik dari array respons, Anda akan mendapatkan hasil berikutnya dari tugas awal;
  nilai offset_token unik untuk setiap tugas berikutnya
  Catatan: jika offset_token ditentukan dalam permintaan, semua parameter lain harus identik dengan permintaan sebelumnya
  pelajari lebih lanjut tentang parameter ini di Pusat Bantuan kami
- order_by
  Tipe: array string[] | null
  
  aturan pengurutan hasil
  field opsional
  Anda dapat menggunakan nilai yang sama seperti dalam array filters untuk mengurutkan hasil
  jenis pengurutan yang tersedia:
  asc - hasil akan diurutkan dalam urutan menaik
  desc - hasil akan diurutkan dalam urutan menurun
  Anda harus menggunakan koma untuk menyetel parameter pengurutan
  contoh:
  ["rating.value,desc"]perhatikan bahwa Anda tidak dapat menyetel lebih dari tiga aturan pengurutan dalam satu permintaan
  Anda harus menggunakan koma untuk memisahkan beberapa aturan pengurutan
  contoh:
  ["rating.value,desc","rating.votes_count,desc"]
- 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
- title
  Tipe: string | null
  
  judul elemen dalam SERP
  field opsional
  nama entitas bisnis yang hasilnya dikumpulkan;
  dapat berisi hingga 200 karakter

Respons

200
Tipe: object | null · Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResponseInfo
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_BusinessDataBusinessListingsSearchLiveTaskInfo
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: array (object | null)[] | null

array hasil

count
Tipe: integer | null Format: int64

jenis item
jumlah item dalam array items

items
Tipe: array (object | null)[] | null

jenis item yang ditemui
jenis hasil mesin pencari yang ditemui dalam array items;
jenis item yang tersedia: business_listing

additional_categories
Tipe: array (string | null)[] | null

kategori bisnis tambahan
kategori Google My Business tambahan yang menjelaskan layanan yang disediakan entitas bisnis secara lebih rinci

address
Tipe: string | null

alamat entitas bisnis

address_info
Tipe: object | null · Response36Afe1097B20_AddressInfo

objek yang berisi komponen alamat entitas bisnis

address
Tipe: string | null

alamat jalan tempat usaha lokal

borough
Tipe: string | null

unit administratif atau distrik tempat usaha lokal berada

city
Tipe: string | null

nama kota tempat usaha lokal berada

country_code
Tipe: string | null

kode negara ISO tempat usaha lokal

region
Tipe: string | null

wilayah DMA tempat usaha lokal berada

zip
Tipe: string | null

kode ZIP tempat usaha lokal

attributes
Tipe: object | null · Response36Afe1097B20_BusinessDataAttributesInfo

detail layanan dalam bentuk pemeriksaan yang ditinjau pengguna;
detail layanan entitas bisnis yang ditampilkan dalam bentuk pemeriksaan dan berdasarkan umpan balik pengguna serta category bisnis

available_attributes
Tipe: object | null

atribut yang tersedia
menunjukkan atribut yang dapat ditawarkan entitas bisnis

propertyName
Tipe: array (string | null)[] | null
unavailable_attributes
Tipe: object | null

atribut yang tidak tersedia
menunjukkan atribut yang tidak dapat ditawarkan entitas bisnis

propertyName
Tipe: array (string | null)[] | null
category
Tipe: string | null

kategori bisnis
kategori umum Google My Business yang paling menggambarkan layanan yang disediakan entitas bisnis

category_ids
Tipe: array (string | null)[] | null

ID kategori global
ID kategori universal yang tidak berubah berdasarkan negara yang dipilih

check_url
Tipe: string | null

URL langsung ke hasil mesin pencari
Anda dapat menggunakannya untuk memastikan kami memberikan hasil yang akurat

cid
Tipe: string | null

client id yang ditentukan Google
id unik satu tempat usaha lokal
pelajari lebih lanjut tentang pengidentifikasi di artikel pusat bantuan ini

contact_info
Tipe: array (object | null)[] | null

kontak bisnis yang tersedia
daftar kontak untuk berinteraksi dengan bisnis

source
Tipe: string | null

sumber data

type
Tipe: string | null

jenis elemen

value
Tipe: string | null

nilai peringkat

description
Tipe: string | null

deskripsi elemen dalam SERP
deskripsi entitas bisnis yang hasilnya dikumpulkan

domain
Tipe: string | null

domain entitas bisnis

feature_id
Tipe: string | null

pengenal unik elemen dalam SERP
pelajari lebih lanjut tentang pengenal di artikel pusat bantuan ini

first_seen
Tipe: string | null

tanggal dan waktu saat perayap kami pertama kali menemukan elemen daftar bisnis
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2023-03-11 10:04:11 +00:00

hotel_rating
Tipe: integer | null

rating kelas hotel
rating kelas berkisar antara 1-5 bintang, pelajari lebih lanjut
jika tidak ada informasi rating kelas hotel, nilainya adalah null

is_claimed
Tipe: boolean | null

menunjukkan apakah entitas diverifikasi oleh pemiliknya di Google Maps

last_updated_time
Tipe: string | null

tanggal dan waktu data terakhir diperbarui
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2023-01-26 09:03:15 +00:00

latitude
Tipe: number | null

koordinat lintang usaha lokal di Google Maps
misalnya:
"latitude": 51.584091

local_business_links
Tipe: array (object | null)[] | null

interaksi yang tersedia dengan bisnis
daftar opsi untuk berinteraksi dengan bisnis langsung dari hasil pencarian

type
Tipe: string | null

jenis elemen

logo
Tipe: string | null

URL logo yang ditampilkan dalam profil Google My Business

longitude
Tipe: number | null

koordinat bujur usaha lokal di Google Maps
misalnya:
"longitude": -0.31365919999999997

main_image
Tipe: string | null

URL gambar utama yang ditampilkan di profil Google My Business

original_title
Tipe: string | null

judul asli elemen
judul asli tidak diterjemahkan oleh Google

people_also_search
Tipe: array (object | null)[] | null

entitas bisnis terkait

cid
Tipe: string | null

client id yang ditentukan Google
id unik satu tempat usaha lokal
pelajari lebih lanjut tentang pengidentifikasi di artikel pusat bantuan ini

feature_id
Tipe: string | null

pengenal unik elemen dalam SERP
pelajari lebih lanjut tentang pengenal di artikel pusat bantuan ini

rating
Tipe: object | null · Response36Afe1097B20_RatingInfo

peringkat elemen
tingkat popularitas berdasarkan ulasan dan ditampilkan di SERP

rating_max
Tipe: integer | null

nilai maksimum untuk rating_type

rating_type
Tipe: string | null

jenis penilaian di sini Anda dapat menemukan elemen berikut: Max5, Percents, CustomMax

value
Tipe: number | null Format: double

nilai penilaian

votes_count
Tipe: integer | null Format: int64

jumlah umpan balik

title
Tipe: string | null

judul elemen di SERP
nama entitas bisnis yang hasilnya dikumpulkan

phone
Tipe: string | null

nomor telepon entitas bisnis

place_id
Tipe: string | null

pengenal tempat unik
place id dari usaha lokal yang ditampilkan dalam elemen
pelajari lebih lanjut tentang pengenal ini di artikel pusat bantuan ini

place_topics
Tipe: object | null

kata kunci yang disebut dalam ulasan pelanggan
berisi kata kunci paling populer terkait produk/layanan yang disebut dalam ulasan pelanggan suatu entitas bisnis dan jumlah ulasan yang menyebut setiap kata kunci
contoh:"place_topics": { "egg roll": 48, "birthday": 33 }

propertyName
Tipe: integer | null Format: int64

Signed 64-bit integers (long type).

popular_times
Tipe: object | null · Response36Afe1097B20_PopularTimes

waktu populer
informasi terkait jam sibuk entitas bisnis

popular_times_by_days
Tipe: object | null

jam sibuk
informasi tentang jam sibuk tempat usaha lokal pada setiap hari dalam seminggu

propertyName
Tipe: array (object | null)[] | null

jam kerja pada hari Minggu

popular_index
Tipe: integer | null

indeks popularitas indeks popularitas relatif berbasis waktu yang diukur dari 0 hingga 100; nilai yang lebih tinggi menunjukkan waktu yang lebih sibuk dalam sehari

time
Tipe: object | null · Response36Afe1097B20_TimeInfo

jam dalam format 24 jam

hour
Tipe: integer | null

jam dalam format 24 jam

minute
Tipe: integer | null

menit

price_level
Tipe: string | null

tingkat harga properti
dapat mengambil nilai: inexpensive, moderate, expensive, very_expensive
jika tidak ada informasi tingkat harga, nilainya adalah null

rating
Tipe: object | null · Response36Afe1097B20_RatingInfo

peringkat elemen
tingkat popularitas berdasarkan ulasan dan ditampilkan di SERP

rating_max
Tipe: number | null Format: double

nilai maksimum untuk rating_type

rating_type
Tipe: string | null

jenis penilaian di sini Anda dapat menemukan elemen berikut: Max5, Percents, CustomMax

value
Tipe: number | null Format: double

nilai penilaian

votes_count
Tipe: integer | null Format: int64

jumlah umpan balik

rating_distribution
Tipe: object | null

distribusi peringkat entitas bisnis
objek menampilkan jumlah peringkat bintang 1 hingga 5, sebagaimana diulas pengguna

propertyName
Tipe: integer | null Format: Int64
services
Tipe: array (object | null)[] | null
category
Tipe: string | null

kategori bisnis
kategori umum Google My Business yang paling menggambarkan layanan yang disediakan entitas bisnis

price
Tipe: object | null · Response36Afe1097B20_PriceInfo
currency
Tipe: string | null

mata uang dari harga yang terdaftar kode ISO mata uang yang diterapkan pada harga

current
Tipe: number | null Format: double

harga saat ini menunjukkan harga saat ini dari produk atau layanan yang ditampilkan dalam hasil

displayed_price
Tipe: string | null

string harga dalam hasil string harga mentah seperti yang diberikan dalam hasil

is_price_range
Tipe: boolean | null

harga diberikan sebagai rentang menunjukkan apakah harga diberikan dalam rentang

max_value
Tipe: number | null Format: double

harga maksimum harga maksimum produk atau layanan seperti yang ditunjukkan dalam hasil

regular
Tipe: number | null Format: double

harga reguler menunjukkan harga reguler produk atau layanan tanpa diskon

snippet
Tipe: string | null

informasi tambahan tentang entitas bisnis

title
Tipe: string | null

judul elemen di SERP
nama entitas bisnis yang hasilnya dikumpulkan

snippet
Tipe: string | null

informasi tambahan tentang entitas bisnis

title
Tipe: string | null

judul elemen di SERP
nama entitas bisnis yang hasilnya dikumpulkan

total_photos
Tipe: integer | null Format: int64

jumlah total gambar yang ditampilkan di profil Google My Business

type
Tipe: string | null

jenis elemen

url
Tipe: string | null

url absolut entitas bisnis

work_time
Tipe: object | null · Response36Afe1097B20_BusinessWorkHoursInfo

detail waktu kerja
informasi terkait jam operasional entitas bisnis

work_hours
Tipe: object | null · Response36Afe1097B20_WorkHours

jam buka
informasi tentang jam kerja usaha lokal

current_status
Tipe: string | null

status tempat usaha saat ini
menunjukkan apakah tempat usaha sedang buka atau tutup

timetable
Tipe: object | null

jadwal jam kerja

propertyName
Tipe: array (object | null)[] | null

jam kerja pada hari Minggu

close
Tipe: object | null · Response36Afe1097B20_TimeInfo

waktu tutup

hour
Tipe: integer | null

jam dalam format 24 jam

minute
Tipe: integer | null

menit

open
Tipe: object | null · Response36Afe1097B20_TimeInfo

waktu buka

hour
Tipe: integer | null

jam dalam format 24 jam

minute
Tipe: integer | null

menit

offset
Tipe: integer | null Format: int64

Signed 64-bit integers (long type).

offset_token
Tipe: string | null
total_count
Tipe: integer | null Format: int64

jumlah total hasil di basis data kami yang relevan dengan permintaan Anda

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/business_data/business_listings/search/live

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/business_listings/search/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "categories": [
      "pizza_restaurant"
    ],
    "description": "pizza",
    "title": "pizza",
    "is_claimed": true,
    "location_coordinate": "53.476225,-2.243572,10",
    "order_by": [
      "rating.value,desc"
    ],
    "filters": [
      [
        "rating.value",
        ">",
        3
      ]
    ],
    "limit": 3
  }
]'

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": [
        {
          "total_count": null,
          "count": null,
          "offset": null,
          "offset_token": null,
          "items": [
            {
              "type": null,
              "title": null,
              "original_title": null,
              "description": null,
              "category": null,
              "category_ids": [
                "[Max Depth Exceeded]"
              ],
              "additional_categories": [
                "[Max Depth Exceeded]"
              ],
              "cid": null,
              "feature_id": null,
              "address": null,
              "address_info": "[Max Depth Exceeded]",
              "place_id": null,
              "phone": null,
              "url": null,
              "domain": null,
              "logo": null,
              "main_image": null,
              "total_photos": null,
              "snippet": null,
              "latitude": null,
              "longitude": null,
              "is_claimed": null,
              "attributes": "[Max Depth Exceeded]",
              "place_topics": null,
              "rating": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "rating_type": "[Max Depth Exceeded]",
                "value": "[Max Depth Exceeded]",
                "votes_count": "[Max Depth Exceeded]",
                "rating_max": "[Max Depth Exceeded]"
              },
              "hotel_rating": null,
              "price_level": null,
              "rating_distribution": null,
              "people_also_search": [
                "[Max Depth Exceeded]"
              ],
              "work_time": "[Max Depth Exceeded]",
              "popular_times": "[Max Depth Exceeded]",
              "local_business_links": [
                "[Max Depth Exceeded]"
              ],
              "contact_info": [
                "[Max Depth Exceeded]"
              ],
              "check_url": null,
              "last_updated_time": null,
              "first_seen": null,
              "services": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Operasi berhasil

Tugas Pencarian Daftar Bisnis Langsung

AutentikasiRequired

DataForSEO

Tugas Pencarian Daftar Bisnis Langsung

Referensi harga