Tác vụ tìm kiếm danh sách doanh nghiệp trực tiếp
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Tác vụ tìm kiếm danh sách doanh nghiệp trực tiếp
Tìm kiếm trong chỉ mục riêng của DataForSEO về danh sách doanh nghiệp địa phương theo categories, description, title và location_coordinate - bộ ba vĩ độ, kinh độ và bán kính. Trả về total_count, count, offset, offset_token và items, phân trang bằng token. Được bọc trong envelope của DataForSEO: dữ liệu nằm trong tasks[0].result, kết quả trong tasks[0].status_code - yêu cầu bị từ chối vẫn trả về HTTP 200. Endpoint này đọc chỉ mục và trả lời ngay; mọi thứ khác ở đây đều xếp hàng một lần crawl trực tiếp nguồn. Bắt đầu với cái này và chỉ đi sâu khi cần.
Tham chiếu giá
- Cách tính: chi phí phản hồi được báo cáo.
- Ước tính tham chiếu mỗi yêu cầu: 0,2428 USD.
- Hệ số tham chiếu cho khách hàng: 1,0. Không áp dụng lại hệ số này cho số tiền khách hàng đã quyết toán.
Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.
- Kiểu: array (object | null)[]
- categoriesKiểu: array string[] | null
danh mục doanh nghiệp
trường tùy chọn
các danh mục bạn chỉ định được dùng để tìm danh sách doanh nghiệp;
nếu bạn không dùng trường này, chúng tôi sẽ trả về danh sách doanh nghiệp tìm thấy tại vị trí đã chỉ định;
bạn có thể chỉ định tối đa 10 danh mục - descriptionKiểu: string | null
mô tả của phần tử trong SERP
trường tùy chọn
mô tả của thực thể doanh nghiệp mà kết quả được thu thập;
có thể chứa tối đa 200 ký tự - filtersKiểu: array (object | null)[] | null
mảng tham số lọc kết quả
trường tùy chọn
bạn có thể thêm nhiều bộ lọc cùng lúc (tối đa 8 bộ lọc)
bạn nên đặt toán tử logicand,orgiữa các điều kiện
các toán tử sau được hỗ trợ:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like,ilike,not_ilike,match,not_match
bạn có thể dùng toán tử%vớilikevànot_likeđể khớp mọi chuỗi có 0 hoặc nhiều ký tự
ví dụ:["rating.value",">",3]
bạn có thể nhận danh sách bộ lọc khả dụng bằng cách gửi một yêu cầu riêng đếnhttps://api.dataforseo.com/v3/business_data/business_listings/available_filters
Danh sách đầy đủ các bộ lọc khả dụng có tại đây.Đối tượng rỗng - isKiểu: boolean | null
_claimed cho biết doanh nghiệp có được chủ sở hữu xác minh trên Google Maps hay không
trường tùy chọn - limitKiểu: integer | null
số doanh nghiệp trả về tối đa
trường tùy chọn
giá trị mặc định:100
giá trị tối đa:1000 - locationKiểu: string | null
_coordinate tọa độ GPS của một vị trí
trường tùy chọn
tham sốlocation_coordinatephải được chỉ định ở định dạng "latitude,longitude,radius"
số chữ số thập phân tối đa cho "latitude" và "longitude": 7
giá trị của "radius" được chỉ định bằng kilômét (km)
giá trị tối thiểu cho "radius":1
giá trị tối đa cho "radius":100000
ví dụ:53.476225,-2.243572,200
tìm hiểu thêm về cách đặt tham số vị trí trong API này trên Trung tâm trợ giúp của chúng tôi - offsetKiểu: integer | null
độ lệch trong mảng kết quả của các doanh nghiệp trả về
trường tùy chọn
giá trị mặc định:0
nếu bạn chỉ định giá trị10, mười thực thể đầu tiên trong mảng kết quả sẽ bị bỏ qua và dữ liệu sẽ được cung cấp cho các thực thể tiếp theo
Lưu ý: chúng tôi khuyên chỉ dùng tham số này khi lấy tối đa 10.000 kết quả
để lấy hơn 10.000 kết quả, hãy dùngoffset_tokenthay thế - offsetKiểu: string | null
_token token cho các yêu cầu tiếp theo
trường tùy chọn
được cung cấp trong trường tương tự của phản hồi cho mỗi yêu cầu;
dùng tham số này để tránh hết thời gian chờ khi cố lấy hơn 100,000 kết quả trong một yêu cầu;
bằng cách chỉ định giá trịoffset_tokenduy nhất từ mảng phản hồi, bạn sẽ nhận được các kết quả tiếp theo của tác vụ ban đầu;
giá trịoffset_tokenlà duy nhất cho mỗi tác vụ tiếp theo
Lưu ý: nếuoffset_tokenđược chỉ định trong yêu cầu, mọi tham số khác phải giống với yêu cầu trước
tìm hiểu thêm về tham số này trên Trung tâm trợ giúp của chúng tôi - orderKiểu: array string[] | null
_by quy tắc sắp xếp kết quả
trường tùy chọn
bạn có thể dùng các giá trị giống như trong mảngfiltersđể sắp xếp kết quả
các kiểu sắp xếp khả dụng:asc- kết quả sẽ được sắp xếp theo thứ tự tăng dầndesc- kết quả sẽ được sắp xếp theo thứ tự giảm dần
bạn nên dùng dấu phẩy để thiết lập tham số sắp xếp
ví dụ:["rating.value,desc"]lưu ý rằng bạn không thể đặt quá ba quy tắc sắp xếp trong một yêu cầu
bạn nên dùng dấu phẩy để phân tách nhiều quy tắc sắp xếp
ví dụ:["rating.value,desc","rating.votes_count,desc"] - tagKiểu: string | null
mã định danh tác vụ do người dùng xác định
trường tùy chọn
giới hạn ký tự là 255
bạn có thể dùng tham số này để nhận diện tác vụ và khớp với kết quả
bạn sẽ thấy giá trịtagđã chỉ định trong đối tượngdatacủa phản hồi - titleKiểu: string | null
tiêu đề của phần tử trong SERP
trường tùy chọn
tên của thực thể doanh nghiệp mà kết quả được thu thập;
có thể chứa tối đa 200 ký tự
- Kiểu: object | null · Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResponseInfo200
- Kiểu: number | null Định dạng: doublecost
tổng chi phí tác vụ, USD
- Kiểu: integer | nullstatus
_code mã trạng thái chung; bạn có thể tìm danh sách đầy đủ các mã phản hồi tại đây
- Kiểu: string | nullstatus
_message thông điệp thông tin chung; bạn có thể tìm danh sách đầy đủ các thông điệp thông tin chung tại đây
- Kiểu: array (object | null)[] | nulltasks
mảng tác vụ
- Kiểu: object | null · Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveTaskInfo
- costKiểu: number | null Định dạng: double
tổng chi phí tác vụ, USD
- dataKiểu: object | null
chứa các tham số giống như bạn đã chỉ định trong yêu cầu POST
- propertyKiểu: object | null
Name
- idKiểu: string | null
mã định danh tác vụ; mã định danh tác vụ duy nhất trong hệ thống của chúng tôi ở định dạng UUID
- pathKiểu: array (string | null)[] | null
Đường dẫn URL
- resultKiểu: array (object | null)[] | null
mảng kết quả
- countKiểu: integer | null Định dạng: int64
các loại mục
số lượng mục trong mảngitems - itemsKiểu: array (object | null)[] | null
các loại mục gặp phải
các loại kết quả tìm kiếm gặp phải trong mảngitems;
các loại mục khả dụng:business_listing- additionalKiểu: array (string | null)[] | null
_categories danh mục doanh nghiệp bổ sung
các danh mục Google My Business bổ sung mô tả dịch vụ do thực thể doanh nghiệp cung cấp chi tiết hơn - addressKiểu: string | null
địa chỉ của thực thể doanh nghiệp
- addressKiểu: object | null · Response36Afe1097B20_AddressInfo
_info đối tượng chứa các thành phần địa chỉ của thực thể doanh nghiệp
- addressKiểu: string | null
địa chỉ đường phố của cơ sở địa phương
- boroughKiểu: string | null
đơn vị hành chính hoặc quận mà cơ sở địa phương trực thuộc
- cityKiểu: string | null
tên thành phố nơi cơ sở địa phương tọa lạc
- countryKiểu: string | null
_code mã quốc gia ISO của cơ sở địa phương
- regionKiểu: string | null
vùng DMA mà cơ sở địa phương trực thuộc
- zipKiểu: string | null
mã ZIP của cơ sở địa phương
- attributesKiểu: object | null · Response36Afe1097B20_BusinessDataAttributesInfo
chi tiết dịch vụ dưới dạng các mục kiểm tra do người dùng đánh giá;
chi tiết dịch vụ của một thực thể doanh nghiệp được hiển thị dưới dạng các mục kiểm tra và dựa trên phản hồi của người dùng cùngcategorycủa doanh nghiệp- availableKiểu: object | null
_attributes thuộc tính khả dụng
cho biết các thuộc tính mà thực thể doanh nghiệp có thể cung cấp- propertyKiểu: array (string | null)[] | null
Name
- unavailableKiểu: object | null
_attributes thuộc tính không khả dụng
cho biết các thuộc tính mà thực thể doanh nghiệp không thể cung cấp- propertyKiểu: array (string | null)[] | null
Name
- categoryKiểu: string | null
danh mục doanh nghiệp
danh mục chung trên Google My Business mô tả rõ nhất dịch vụ do thực thể doanh nghiệp cung cấp - categoryKiểu: array (string | null)[] | null
_ids ID danh mục toàn cầu
ID danh mục phổ quát không thay đổi theo quốc gia được chọn - checkKiểu: string | null
_url URL trực tiếp đến kết quả công cụ tìm kiếm
bạn có thể dùng URL này để đảm bảo chúng tôi đã cung cấp kết quả chính xác - cidKiểu: string | null
- contactKiểu: array (object | null)[] | null
_info các liên hệ khả dụng của doanh nghiệp
danh sách liên hệ để tương tác với doanh nghiệp- sourceKiểu: string | null
nguồn dữ liệu
- typeKiểu: string | null
loại phần tử
- valueKiểu: string | null
giá trị của xếp hạng
- descriptionKiểu: string | null
mô tả của phần tử trong SERP
mô tả của thực thể doanh nghiệp mà kết quả được thu thập cho - domainKiểu: string | null
tên miền của thực thể doanh nghiệp
- featureKiểu: string | null
_id - firstKiểu: string | null
_seen ngày và giờ crawler của chúng tôi phát hiện phần tử danh sách doanh nghiệp lần đầu tiên
ở định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ví dụ:2023-03-11 10:04:11 +00:00 - hotelKiểu: integer | null
_rating - isKiểu: boolean | null
_claimed cho biết thực thể có được chủ sở hữu xác minh trên Google Maps hay không
- lastKiểu: string | null
_updated _time ngày và giờ dữ liệu được cập nhật lần cuối
ở định dạng UTC: “yyyy-mm-dd hh-mm-ss +00:00”
ví dụ:2023-01-26 09:03:15 +00:00 - latitudeKiểu: number | null
tọa độ vĩ độ của các cơ sở địa phương trên Google Maps
ví dụ:"latitude": 51.584091 - localKiểu: array (object | null)[] | null
_business _links các tương tác có sẵn với doanh nghiệp
danh sách các tùy chọn để tương tác với doanh nghiệp trực tiếp từ kết quả tìm kiếm- typeKiểu: string | null
loại phần tử
- logoKiểu: string | null
URL của logo xuất hiện trong hồ sơ Google My Business
- longitudeKiểu: number | null
tọa độ kinh độ của cơ sở địa phương trên Google Maps
ví dụ:"longitude": -0.31365919999999997 - mainKiểu: string | null
_image URL của hình ảnh chính trong hồ sơ Google My Business
- originalKiểu: string | null
_title tiêu đề gốc của phần tử
tiêu đề gốc không được Google dịch - peopleKiểu: array (object | null)[] | null
_also _search các thực thể doanh nghiệp liên quan
- cidKiểu: string | null
- featureKiểu: string | null
_id - ratingKiểu: object | null · Response36Afe1097B20_RatingInfo
xếp hạng của phần tử
mức độ phổ biến dựa trên đánh giá và được hiển thị trong SERP- ratingKiểu: integer | null
_max giá trị tối đa cho một rating_type
- ratingKiểu: string | null
_type loại xếp hạng tại đây bạn có thể tìm thấy các phần tử sau: Max5, Percents, CustomMax
- valueKiểu: number | null Định dạng: double
giá trị của xếp hạng
- votesKiểu: integer | null Định dạng: int64
_count số lượng phản hồi
- titleKiểu: string | null
tiêu đề của phần tử trong SERP
tên của thực thể doanh nghiệp mà kết quả được thu thập
- phoneKiểu: string | null
số điện thoại của thực thể doanh nghiệp
- placeKiểu: string | null
_id mã định danh địa điểm duy nhất
place id của cơ sở địa phương xuất hiện trong phần tử
tìm hiểu thêm về mã định danh trong bài viết trung tâm trợ giúp này - placeKiểu: object | null
_topics từ khóa được nhắc đến trong đánh giá của khách hàng
chứa các từ khóa phổ biến nhất liên quan đến sản phẩm/dịch vụ được nhắc trong đánh giá của khách hàng về một thực thể doanh nghiệp và số lượng đánh giá nhắc đến từng từ khóa
ví dụ:
"place_topics": {
"egg roll": 48,
"birthday": 33
}- propertyKiểu: integer | null Định dạng: int64
Name Signed 64-bit integers (long type).
- popularKiểu: object | null · Response36Afe1097B20_PopularTimes
_times giờ cao điểm
thông tin về các khung giờ đông khách của thực thể doanh nghiệp- popularKiểu: object | null
_times _by _days giờ cao điểm
thông tin về các giờ bận rộn của cơ sở địa phương trong từng ngày của tuần- propertyKiểu: array (object | null)[] | null
Name giờ làm việc vào Chủ nhật
- popularKiểu: integer | null
_index chỉ số phổ biến chỉ số phổ biến theo thời gian tương đối, đo từ 0 đến 100; giá trị cao hơn tương ứng với thời điểm bận rộn hơn trong ngày
- timeKiểu: object | null · Response36Afe1097B20_TimeInfo
giờ theo định dạng 24 giờ
- hourKiểu: integer | null
giờ theo định dạng 24 giờ
- minuteKiểu: integer | null
phút
- priceKiểu: string | null
_level mức giá của cơ sở
có thể nhận các giá trị:inexpensive,moderate,expensive,very_expensive
nếu không có thông tin mức giá, giá trị sẽ lànull - ratingKiểu: object | null · Response36Afe1097B20_RatingInfo
xếp hạng của phần tử
mức độ phổ biến dựa trên đánh giá và được hiển thị trong SERP- ratingKiểu: number | null Định dạng: double
_max giá trị tối đa cho một rating_type
- ratingKiểu: string | null
_type loại xếp hạng tại đây bạn có thể tìm thấy các phần tử sau: Max5, Percents, CustomMax
- valueKiểu: number | null Định dạng: double
giá trị của xếp hạng
- votesKiểu: integer | null Định dạng: int64
_count số lượng phản hồi
- ratingKiểu: object | null
_distribution phân bố xếp hạng của thực thể doanh nghiệp
đối tượng hiển thị số xếp hạng từ 1 sao đến 5 sao theo đánh giá của người dùng- propertyKiểu: integer | null Định dạng: Int64
Name
- servicesKiểu: array (object | null)[] | null
- categoryKiểu: string | null
danh mục doanh nghiệp
danh mục chung trên Google My Business mô tả rõ nhất dịch vụ do thực thể doanh nghiệp cung cấp - priceKiểu: object | null · Response36Afe1097B20_PriceInfo
- currencyKiểu: string | null
loại tiền của giá được niêm yết mã ISO của loại tiền áp dụng cho giá
- currentKiểu: number | null Định dạng: double
giá hiện tại cho biết giá hiện tại của sản phẩm hoặc dịch vụ trong kết quả
- displayedKiểu: string | null
_price chuỗi giá trong kết quả chuỗi giá thô như được cung cấp trong kết quả
- isKiểu: boolean | null
_price _range giá được cung cấp dưới dạng khoảng cho biết giá có được cung cấp dưới dạng khoảng hay không
- maxKiểu: number | null Định dạng: double
_value giá tối đa giá tối đa của sản phẩm hoặc dịch vụ như được nêu trong kết quả
- regularKiểu: number | null Định dạng: double
giá thường giá thường của sản phẩm hoặc dịch vụ khi không áp dụng giảm giá
- snippetKiểu: string | null
thông tin bổ sung về thực thể doanh nghiệp
- titleKiểu: string | null
tiêu đề của phần tử trong SERP
tên của thực thể doanh nghiệp mà kết quả được thu thập
- snippetKiểu: string | null
thông tin bổ sung về thực thể doanh nghiệp
- titleKiểu: string | null
tiêu đề của phần tử trong SERP
tên của thực thể doanh nghiệp mà kết quả được thu thập - totalKiểu: integer | null Định dạng: int64
_photos tổng số hình ảnh trong hồ sơ Google My Business
- typeKiểu: string | null
loại phần tử
- urlKiểu: string | null
url tuyệt đối của thực thể doanh nghiệp
- workKiểu: object | null · Response36Afe1097B20_BusinessWorkHoursInfo
_time chi tiết giờ làm việc
thông tin về giờ hoạt động của thực thể doanh nghiệp- workKiểu: object | null · Response36Afe1097B20_WorkHours
_hours giờ mở cửa
thông tin về giờ làm việc của cơ sở địa phương- currentKiểu: string | null
_status trạng thái hiện tại của cơ sở
cho biết cơ sở đang mở hay đã đóng - timetableKiểu: object | null
thời gian biểu giờ làm việc
- propertyKiểu: array (object | null)[] | null
Name giờ làm việc vào Chủ nhật
- closeKiểu: object | null · Response36Afe1097B20_TimeInfo
giờ đóng cửa
- hourKiểu: integer | null
giờ theo định dạng 24 giờ
- minuteKiểu: integer | null
phút
- openKiểu: object | null · Response36Afe1097B20_TimeInfo
giờ mở cửa
- hourKiểu: integer | null
giờ theo định dạng 24 giờ
- minuteKiểu: integer | null
phút
- offsetKiểu: integer | null Định dạng: int64
Signed 64-bit integers (long type).
- offsetKiểu: string | null
_token - totalKiểu: integer | null Định dạng: int64
_count tổng số kết quả trong cơ sở dữ liệu của chúng tôi liên quan đến yêu cầu của bạn
- resultKiểu: integer | null Định dạng: int64
_count số phần tử trong mảng kết quả
- statusKiểu: integer | null
_code mã trạng thái của tác vụ do DataForSEO tạo; có thể nằm trong khoảng sau: 10000-60000; bạn có thể tìm danh sách đầy đủ các mã phản hồi tại đây
- statusKiểu: string | null
_message thông điệp thông tin của tác vụ; bạn có thể tìm danh sách đầy đủ các thông điệp thông tin chung tại đây
- timeKiểu: string | null
thời gian thực thi, giây
- Kiểu: integer | null Định dạng: int64tasks
_count số lượng tác vụ trong mảng tasks
- Kiểu: integer | null Định dạng: int64tasks
_error số lượng tác vụ trong mảng tasks được trả về kèm lỗi
- Kiểu: string | nulltime
tổng thời gian thực thi, giây
- Kiểu: string | nullversion
phiên bản hiện tại của API
application/json - 400
Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.
- 401
Cần có khóa API Felo hợp lệ.
- 402
Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.
- 403
Tài khoản không được phép thực hiện thao tác này.
- 429
Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.
- 502
Dịch vụ không thể hoàn tất yêu cầu.
- 503
API hoặc dịch vụ thanh toán tạm thời không khả dụng.
- 504
Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.
- default
Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp
application/json
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
}
]'
{
"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]"
]
}
]
}
]
}
]
}