v0.2.0-beta

OpenAPI 3.1.0

Tugas Carian Penyenaraian Perniagaan Langsung

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

Tugas Carian Penyenaraian Perniagaan Langsung

Mencari dalam indeks DataForSEO sendiri bagi penyenaraian perniagaan tempatan mengikut categories, description, title dan location_coordinate - tiga serangkai latitud, longitud dan jejari. Memulangkan total_count, count, offset, offset_token dan items, dinomborkan halaman dengan token. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak masih memulangkan HTTP 200. Ini membaca indeks dan menjawab serta-merta; semua yang lain di sini memasukkan perangkakan langsung sumber ke baris gilir. Mulakan dengan ini dan telusuri hanya bahagian yang penting.

Rujukan harga

Pemeteran: kos respons yang dilaporkan.
Anggaran rujukan setiap permintaan: USD 0,2428.
Pengganda rujukan pelanggan: 1,0. Jangan gunakannya 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)[]
- categories
  Jenis: array string[] | null
  
  kategori perniagaan
  medan pilihan
  kategori yang anda tetapkan digunakan untuk mencari penyenaraian perniagaan;
  jika anda tidak menggunakan medan ini, kami akan memulangkan penyenaraian perniagaan yang ditemui di lokasi yang ditetapkan;
  anda boleh menetapkan sehingga 10 kategori
- description
  Jenis: string | null
  
  deskripsi elemen dalam SERP
  medan pilihan
  deskripsi entiti perniagaan yang hasilnya dikumpulkan;
  boleh mengandungi sehingga 200 aksara
- filters
  Jenis: array (object | null)[] | null
  
  tatasusunan parameter penapisan hasil
  medan pilihan
  anda boleh menambah beberapa penapis sekali gus (maksimum 8 penapis)
  anda harus menetapkan operator logik and, or antara syarat
  operator berikut disokong:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
  anda boleh menggunakan operator % dengan like dan not_like untuk memadankan mana-mana rentetan dengan sifar atau lebih aksara
  contoh:
  ["rating.value",">",3]
  anda boleh mendapatkan senarai penapis yang tersedia dengan membuat permintaan berasingan ke https://api.dataforseo.com/v3/business_data/business_listings/available_filters
  Senarai penuh penapis yang tersedia boleh dilihat di sini.
  
  Objek kosong
- is_claimed
  Jenis: boolean | null
  
  menunjukkan sama ada perniagaan disahkan oleh pemiliknya di Google Maps
  medan pilihan
- limit
  Jenis: integer | null
  
  bilangan maksimum perniagaan yang dipulangkan
  medan pilihan
  nilai lalai: 100
  nilai maksimum: 1000
- location_coordinate
  Jenis: string | null
  
  koordinat GPS sesuatu lokasi
  medan pilihan
  parameter location_coordinate harus ditentukan dalam format "latitude,longitude,radius"
  bilangan maksimum digit perpuluhan untuk "latitude" dan "longitude": 7
  nilai "radius" ditetapkan dalam kilometer (km)
  nilai minimum untuk "radius": 1
  nilai maksimum untuk "radius": 100000
  contoh:
  53.476225,-2.243572,200
  ketahui lebih lanjut tentang cara menetapkan parameter lokasi dalam API ini di Pusat Bantuan kami
- offset
  Jenis: integer | null
  
  offset dalam tatasusunan hasil perniagaan yang dipulangkan
  medan pilihan
  nilai lalai: 0
  jika anda menetapkan nilai 10, sepuluh entiti pertama dalam tatasusunan hasil akan dilangkau dan data akan disediakan untuk entiti seterusnya
  Nota: kami mengesyorkan menggunakan parameter ini hanya semasa mengambil sehingga 10,000 hasil
  untuk mengambil lebih daripada 10,000 hasil, gunakan offset_token sebagai ganti
- offset_token
  Jenis: string | null
  
  token untuk permintaan berikutnya
  medan pilihan
  disediakan dalam medan yang sama pada respons setiap permintaan;
  gunakan parameter ini untuk mengelakkan tamat masa semasa cuba memperoleh lebih daripada 100,000 hasil dalam satu permintaan;
  dengan menentukan nilai offset_token unik daripada tatasusunan respons, anda akan memperoleh hasil berikutnya bagi tugas awal;
  nilai offset_token adalah unik bagi setiap tugas berikutnya
  Nota: jika offset_token ditentukan dalam permintaan, semua parameter lain mestilah sama dengan permintaan sebelumnya
  ketahui lebih lanjut tentang parameter ini di Pusat Bantuan kami
- order_by
  Jenis: array string[] | null
  
  peraturan isihan hasil
  medan pilihan
  anda boleh menggunakan nilai yang sama seperti dalam tatasusunan filters untuk mengisih hasil
  jenis isihan yang tersedia:
  asc - hasil akan diisih mengikut susunan menaik
  desc - hasil akan diisih mengikut susunan menurun
  anda harus menggunakan koma untuk menetapkan parameter isihan
  contoh:
  ["rating.value,desc"]ambil perhatian bahawa anda tidak boleh menetapkan lebih daripada tiga peraturan isihan dalam satu permintaan
  anda harus menggunakan koma untuk memisahkan beberapa peraturan isihan
  contoh:
  ["rating.value,desc","rating.votes_count,desc"]
- 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
- title
  Jenis: string | null
  
  tajuk elemen dalam SERP
  medan pilihan
  nama entiti perniagaan yang hasilnya dikumpulkan;
  boleh mengandungi sehingga 200 aksara

Respons

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

tatasusunan hasil

count
Jenis: integer | null Format: int64

jenis item
bilangan item dalam array items

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

jenis item yang ditemui
jenis hasil enjin carian yang ditemui dalam array items;
jenis item tersedia: business_listing

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

kategori perniagaan tambahan
kategori Google My Business tambahan yang menerangkan perkhidmatan yang disediakan oleh entiti perniagaan dengan lebih terperinci

address
Jenis: string | null

alamat entiti perniagaan

address_info
Jenis: object | null · Response36Afe1097B20_AddressInfo

objek yang mengandungi komponen alamat entiti perniagaan

address
Jenis: string | null

alamat jalan premis tempatan

borough
Jenis: string | null

unit pentadbiran atau daerah tempat premis tempatan berada

city
Jenis: string | null

nama bandar tempat premis tempatan berada

country_code
Jenis: string | null

kod negara ISO premis tempatan

region
Jenis: string | null

wilayah DMA tempat premis tempatan berada

zip
Jenis: string | null

kod ZIP premis tempatan

attributes
Jenis: object | null · Response36Afe1097B20_BusinessDataAttributesInfo

butiran perkhidmatan dalam bentuk semakan yang disemak pengguna;
butiran perkhidmatan entiti perniagaan yang dipaparkan dalam bentuk semakan dan berdasarkan maklum balas pengguna serta category perniagaan

available_attributes
Jenis: object | null

atribut tersedia
menunjukkan atribut yang boleh ditawarkan oleh entiti perniagaan

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

atribut tidak tersedia
menunjukkan atribut yang tidak boleh ditawarkan oleh entiti perniagaan

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

kategori perniagaan
kategori umum Google My Business yang paling menggambarkan perkhidmatan yang disediakan oleh entiti perniagaan

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

ID kategori global
ID kategori sejagat yang tidak berubah mengikut negara yang dipilih

check_url
Jenis: string | null

URL terus ke hasil enjin carian
anda boleh menggunakannya untuk memastikan bahawa kami memberikan hasil yang tepat

cid
Jenis: string | null

client id yang ditentukan Google
id unik satu premis tempatan
ketahui lebih lanjut tentang pengecam dalam artikel pusat bantuan ini

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

kenalan perniagaan yang tersedia
senarai kenalan untuk berinteraksi dengan perniagaan

source
Jenis: string | null

sumber data

type
Jenis: string | null

jenis elemen

value
Jenis: string | null

nilai penarafan

description
Jenis: string | null

penerangan elemen dalam SERP
penerangan entiti perniagaan yang hasilnya dikumpulkan

domain
Jenis: string | null

domain entiti perniagaan

feature_id
Jenis: string | null

pengecam unik elemen dalam SERP
ketahui lebih lanjut tentang pengecam dalam artikel pusat bantuan ini

first_seen
Jenis: string | null

tarikh dan masa perayap kami menemui elemen penyenaraian perniagaan buat kali pertama
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2023-03-11 10:04:11 +00:00

hotel_rating
Jenis: integer | null

penarafan kelas hotel
penarafan kelas berkisar antara 1-5 bintang, ketahui lebih lanjut
jika tiada maklumat penarafan kelas hotel, nilainya ialah null

is_claimed
Jenis: boolean | null

menunjukkan sama ada entiti disahkan oleh pemiliknya di Google Maps

last_updated_time
Jenis: string | null

tarikh dan masa data terakhir dikemas kini
dalam format UTC: “yyyy-mm-dd hh-mm-ss +00:00”
contoh:
2023-01-26 09:03:15 +00:00

latitude
Jenis: number | null

koordinat latitud perniagaan tempatan dalam Google Maps
contoh:
"latitude": 51.584091

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

interaksi yang tersedia dengan perniagaan
senarai pilihan untuk berinteraksi dengan perniagaan terus daripada hasil carian

type
Jenis: string | null

jenis elemen

logo
Jenis: string | null

URL logo yang dipaparkan dalam profil Google My Business

longitude
Jenis: number | null

koordinat longitud perniagaan tempatan dalam Google Maps
contoh:
"longitude": -0.31365919999999997

main_image
Jenis: string | null

URL imej utama yang dipaparkan pada profil Google My Business

original_title
Jenis: string | null

tajuk asal elemen
tajuk asal tidak diterjemahkan oleh Google

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

entiti perniagaan berkaitan

cid
Jenis: string | null

client id yang ditentukan Google
id unik satu premis tempatan
ketahui lebih lanjut tentang pengecam dalam artikel pusat bantuan ini

feature_id
Jenis: string | null

pengecam unik elemen dalam SERP
ketahui lebih lanjut tentang pengecam dalam artikel pusat bantuan ini

rating
Jenis: object | null · Response36Afe1097B20_RatingInfo

penilaian elemen
kadar populariti berdasarkan ulasan dan dipaparkan dalam SERP

rating_max
Jenis: integer | null

nilai maksimum untuk rating_type

rating_type
Jenis: string | null

jenis penilaian di sini anda boleh menemui elemen berikut: Max5, Percents, CustomMax

value
Jenis: number | null Format: double

nilai penilaian

votes_count
Jenis: integer | null Format: int64

jumlah maklum balas

title
Jenis: string | null

tajuk elemen dalam SERP
nama entiti perniagaan yang hasilnya dikumpulkan

phone
Jenis: string | null

nombor telefon entiti perniagaan

place_id
Jenis: string | null

pengecam tempat unik
place id bagi premis tempatan yang dipaparkan dalam elemen
ketahui lebih lanjut tentang pengecam ini dalam artikel pusat bantuan ini

place_topics
Jenis: object | null

kata kunci yang disebut dalam ulasan pelanggan
mengandungi kata kunci paling popular berkaitan produk/perkhidmatan yang disebut dalam ulasan pelanggan sesuatu entiti perniagaan dan bilangan ulasan yang menyebut setiap kata kunci
contoh:"place_topics": { "egg roll": 48, "birthday": 33 }

propertyName
Jenis: integer | null Format: int64

Signed 64-bit integers (long type).

popular_times
Jenis: object | null · Response36Afe1097B20_PopularTimes

waktu popular
maklumat berkaitan waktu sibuk entiti perniagaan

popular_times_by_days
Jenis: object | null

waktu sibuk
maklumat tentang waktu sibuk premis tempatan pada setiap hari dalam seminggu

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

waktu bekerja pada hari Ahad

popular_index
Jenis: integer | null

indeks populariti indeks populariti relatif berasaskan masa yang diukur dari 0 hingga 100; nilai yang lebih tinggi sepadan dengan waktu yang lebih sibuk dalam sehari

time
Jenis: object | null · Response36Afe1097B20_TimeInfo

jam dalam format 24 jam

hour
Jenis: integer | null

jam dalam format 24 jam

minute
Jenis: integer | null

minit

price_level
Jenis: string | null

tahap harga hartanah
boleh mengambil nilai: inexpensive, moderate, expensive, very_expensive
jika tiada maklumat tahap harga, nilainya ialah null

rating
Jenis: object | null · Response36Afe1097B20_RatingInfo

penilaian elemen
kadar populariti berdasarkan ulasan dan dipaparkan dalam SERP

rating_max
Jenis: number | null Format: double

nilai maksimum untuk rating_type

rating_type
Jenis: string | null

jenis penilaian di sini anda boleh menemui elemen berikut: Max5, Percents, CustomMax

value
Jenis: number | null Format: double

nilai penilaian

votes_count
Jenis: integer | null Format: int64

jumlah maklum balas

rating_distribution
Jenis: object | null

taburan penilaian entiti perniagaan
objek memaparkan bilangan penilaian 1 bintang hingga 5 bintang, seperti yang diulas oleh pengguna

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

kategori perniagaan
kategori umum Google My Business yang paling menggambarkan perkhidmatan yang disediakan oleh entiti perniagaan

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

mata wang bagi harga yang disenaraikan kod ISO mata wang yang digunakan pada harga

current
Jenis: number | null Format: double

harga semasa menunjukkan harga semasa produk atau perkhidmatan yang dipaparkan dalam hasil

displayed_price
Jenis: string | null

rentetan harga dalam hasil rentetan harga mentah seperti yang diberikan dalam hasil

is_price_range
Jenis: boolean | null

harga diberikan sebagai julat menunjukkan sama ada harga diberikan dalam julat

max_value
Jenis: number | null Format: double

harga maksimum harga maksimum produk atau perkhidmatan seperti yang dinyatakan dalam hasil

regular
Jenis: number | null Format: double

harga biasa menunjukkan harga biasa produk atau perkhidmatan tanpa diskaun

snippet
Jenis: string | null

maklumat tambahan tentang entiti perniagaan

title
Jenis: string | null

tajuk elemen dalam SERP
nama entiti perniagaan yang hasilnya dikumpulkan

snippet
Jenis: string | null

maklumat tambahan tentang entiti perniagaan

title
Jenis: string | null

tajuk elemen dalam SERP
nama entiti perniagaan yang hasilnya dikumpulkan

total_photos
Jenis: integer | null Format: int64

jumlah imej yang dipaparkan pada profil Google My Business

type
Jenis: string | null

jenis elemen

url
Jenis: string | null

url mutlak entiti perniagaan

work_time
Jenis: object | null · Response36Afe1097B20_BusinessWorkHoursInfo

butiran waktu kerja
maklumat berkaitan waktu operasi entiti perniagaan

work_hours
Jenis: object | null · Response36Afe1097B20_WorkHours

waktu operasi
maklumat tentang waktu perniagaan perniagaan tempatan

current_status
Jenis: string | null

status semasa perniagaan
menunjukkan sama ada perniagaan dibuka atau ditutup

timetable
Jenis: object | null

jadual waktu bekerja

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

waktu bekerja pada hari Ahad

close
Jenis: object | null · Response36Afe1097B20_TimeInfo

waktu tutup

hour
Jenis: integer | null

jam dalam format 24 jam

minute
Jenis: integer | null

minit

open
Jenis: object | null · Response36Afe1097B20_TimeInfo

waktu buka

hour
Jenis: integer | null

jam dalam format 24 jam

minute
Jenis: integer | null

minit

offset
Jenis: integer | null Format: int64

Signed 64-bit integers (long type).

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

jumlah hasil dalam pangkalan data kami yang berkaitan dengan permintaan anda

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/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
  }
]'

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": [
        {
          "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 berjaya

Tugas Carian Penyenaraian Perniagaan Langsung

PengesahanRequired

DataForSEO

Tugas Carian Penyenaraian Perniagaan Langsung

Rujukan harga