Canlı işletme kayıtları arama görevleri
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Canlı işletme kayıtları arama görevleri
DataForSEO'nun kendi yerel işletme kayıtları dizininde categories, description, title ve location_coordinate ile arama yapar – enlem, boylam ve yarıçaptan oluşan üçlü. total_count, count, offset, offset_token ve items döndürür; sayfalama token ile yapılır. Yanıt DataForSEO zarfı içinde gelir: veriler tasks[0].result, sonuç tasks[0].status_code içindedir; reddedilen bir istek yine de HTTP 200 döndürür. Bu, bir dizini okur ve hemen yanıtlar; buradaki diğer her şey kaynağın canlı kazınmasını kuyruğa alır. Buradan başlayın ve yalnızca gereken yerde derinleşin.
Fiyatlandırma referansı
- Ölçümlendirme: bildirilen yanıt maliyeti.
- Referans istek maliyeti tahmini: USD 0.2428.
- Referans müşteri çarpanı: 1.0. Kesinleşmiş müşteri tutarına yeniden uygulamayın.
Yalnızca referans üst verisidir — hesap teklifi, garantili fiyat veya harcama üst sınırı değildir. Kaynak kredileri Felo kredisi değildir. Nihai ücretler Felo faturalandırma kayıtlarını izler.
- Tür: array (object | null)[]
- categoriesTür: array string[] | null
işletme kategorileri
isteğe bağlı alan
belirttiğiniz kategoriler işletme kayıtlarını aramak için kullanılır;
bu alanı kullanmazsanız belirtilen konumda bulunan işletme kayıtlarını döndürürüz;
en fazla 10 kategori belirtebilirsiniz - descriptionTür: string | null
SERP'teki öğenin açıklaması
isteğe bağlı alan
sonuçların toplandığı işletmenin açıklaması;
en fazla 200 karakter içerebilir - filtersTür: array (object | null)[] | null
sonuç filtreleme parametreleri dizisi
isteğe bağlı alan
aynı anda birden fazla filtre ekleyebilirsiniz (en fazla 8 filtre)
koşullar arasındaand,ormantıksal operatörünü ayarlamalısınız
aşağıdaki operatörler desteklenir:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like,ilike,not_ilike,match,not_match
sıfır veya daha fazla karakterden oluşan herhangi bir dizeyi eşleştirmek için%operatörünülikevenot_likeile kullanabilirsiniz
örnek:["rating.value",">",3]
kullanılabilir filtrelerin listesinihttps://api.dataforseo.com/v3/business_data/business_listings/available_filtersadresine ayrı bir istek yaparak alabilirsiniz
Olası filtrelerin tam listesi burada mevcuttur.Boş nesne - isTür: boolean | null
_claimed işletmenin Google Maps'te sahibi tarafından doğrulanıp doğrulanmadığını belirtir
isteğe bağlı alan - limitTür: integer | null
döndürülen maksimum işletme sayısı
isteğe bağlı alan
varsayılan değer:100
maksimum değer:1000 - locationTür: string | null
_coordinate bir konumun GPS koordinatları
isteğe bağlı alanlocation_coordinateparametresi "latitude,longitude,radius" biçiminde belirtilmelidir
"latitude" ve "longitude" için maksimum ondalık basamak sayısı: 7
"radius" değeri kilometre (km) cinsinden belirtilir
"radius" için minimum değer:1
"radius" için maksimum değer:100000
örnek:53.476225,-2.243572,200
bu API'de konum parametrelerinin nasıl ayarlanacağı hakkında daha fazla bilgiyi Yardım Merkezimizde bulabilirsiniz - offsetTür: integer | null
döndürülen işletmelerin sonuç dizisindeki kaydırma değeri
isteğe bağlı alan
varsayılan değer:010değerini belirtirseniz sonuç dizisindeki ilk on varlık atlanır ve veriler sonraki varlıklar için sağlanır
Not: bu parametreyi yalnızca 10.000'e kadar sonuç alırken kullanmanızı öneririz
10.000'in üzerinde sonuç almak için bunun yerineoffset_tokenkullanın - offsetTür: string | null
_token sonraki istekler için token
isteğe bağlı alan
her isteğe verilen yanıtın aynı alanında sağlanır;
tek bir istekte 100.000'den fazla sonuç alırken zaman aşımını önlemek için bu parametreyi kullanın;
yanıt dizisindeki benzersizoffset_tokendeğerini belirterek başlangıç görevinin sonraki sonuçlarını alırsınız;offset_tokendeğerleri her sonraki görev için benzersizdir
Not: istekteoffset_tokenbelirtilirse diğer tüm parametreler önceki istekle aynı olmalıdır
bu parametre hakkında daha fazla bilgi için Yardım Merkezimize bakın - orderTür: array string[] | null
_by sonuç sıralama kuralları
isteğe bağlı alan
sonuçları sıralamak içinfiltersdizisindeki aynı değerleri kullanabilirsiniz
olası sıralama türleri:asc— sonuçlar artan düzende sıralanırdesc— sonuçlar azalan düzende sıralanır
bir sıralama parametresi ayarlamak için virgül kullanmalısınız
örnek:["rating.value,desc"]tek bir istekte en fazla üç sıralama kuralı ayarlayabileceğinizi unutmayın
birden fazla sıralama kuralını virgülle ayırmalısınız
örnek:["rating.value,desc","rating.votes_count,desc"] - tagTür: string | null
kullanıcı tanımlı görev tanımlayıcısı
isteğe bağlı alan
karakter sınırı 255
bu parametreyi görevi tanımlamak ve sonuçla eşleştirmek için kullanabilirsiniz
belirtilentagdeğerini yanıtındatanesnesinde bulacaksınız - titleTür: string | null
SERP'teki öğenin başlığı
isteğe bağlı alan
sonuçların toplandığı işletmenin adı;
en fazla 200 karakter içerebilir
- Tür: object | null · Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveResponseInfo200
- Tür: number | null Biçim: doublecost
toplam görev maliyeti, USD
- Tür: integer | nullstatus
_code genel durum kodu yanıt kodlarının tam listesini burada bulabilirsiniz
- Tür: string | nullstatus
_message genel bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz
- Tür: array (object | null)[] | nulltasks
görev dizisi
- Tür: object | null · Response36Afe1097B20_BusinessDataBusinessListingsSearchLiveTaskInfo
- costTür: number | null Biçim: double
toplam görev maliyeti, USD
- dataTür: object | null
POST isteğinde belirttiğiniz parametrelerin aynısını içerir
- propertyTür: object | null
Name
- idTür: string | null
görev tanımlayıcısı sistemimizde UUID biçiminde benzersiz görev tanımlayıcısı
- pathTür: array (string | null)[] | null
URL yolu
- resultTür: array (object | null)[] | null
sonuç dizisi
- countTür: integer | null Biçim: int64
öğe türleri
itemsdizisindeki öğe sayısı - itemsTür: array (object | null)[] | null
karşılaşılan öğe türleri
itemsdizisinde karşılaşılan arama motoru sonuç türleri;
olası öğe türleri:business_listing- additionalTür: array (string | null)[] | null
_categories ek işletme kategorileri
işletme tarafından sunulan hizmetleri daha ayrıntılı açıklayan ek Google My Business kategorileri - addressTür: string | null
işletmenin adresi
- addressTür: object | null · Response36Afe1097B20_AddressInfo
_info işletmenin adres bileşenlerini içeren nesne
- addressTür: string | null
yerel işletmenin açık adresi
- boroughTür: string | null
yerel işletmenin ait olduğu idari birim veya ilçe
- cityTür: string | null
yerel işletmenin bulunduğu şehrin adı
- countryTür: string | null
_code yerel işletmenin ISO ülke kodu
- regionTür: string | null
yerel işletmenin ait olduğu DMA bölgesi
- zipTür: string | null
yerel işletmenin posta kodu
- attributesTür: object | null · Response36Afe1097B20_BusinessDataAttributesInfo
hizmet ayrıntıları, kullanıcılar tarafından derecelendirilen kontroller biçiminde;
işletmenin hizmet ayrıntıları, kullanıcı geri bildirimlerine ve işletmenincategorydeğerine dayalı olarak kontrol biçiminde gösterilir- availableTür: object | null
_attributes kullanılabilir öznitelikler
bir işletmenin sunabileceği öznitelikleri belirtir- propertyTür: array (string | null)[] | null
Name
- unavailableTür: object | null
_attributes kullanılamayan öznitelikler
bir işletmenin sunamayacağı öznitelikleri belirtir- propertyTür: array (string | null)[] | null
Name
- categoryTür: string | null
işletme kategorisi
işletme tarafından sunulan hizmetleri en iyi tanımlayan genel Google My Business kategorisi - categoryTür: array (string | null)[] | null
_ids global kategori kimlikleri
seçilen ülkeye göre değişmeyen evrensel kategori kimlikleri - checkTür: string | null
_url arama motoru sonuçlarına doğrudan URL
doğru sonuçlar sunduğumuzdan emin olmak için kullanabilirsiniz - cidTür: string | null
- contactTür: array (object | null)[] | null
_info işletmenin kullanılabilir iletişim bilgileri
işletmeyle iletişim kurulacak kişilerin listesi- sourceTür: string | null
veri kaynağı
- typeTür: string | null
öğe türü
- valueTür: string | null
puanın değeri
- descriptionTür: string | null
SERP'teki öğenin açıklaması
sonuçların toplandığı işletmenin açıklaması - domainTür: string | null
işletmenin alan adı
- featureTür: string | null
_id - firstTür: string | null
_seen crawler'ımızın işletme kaydı öğesini ilk kez bulduğu tarih ve saat
UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
örnek:2023-03-11 10:04:11 +00:00 - hotelTür: integer | null
_rating - isTür: boolean | null
_claimed işletmenin Google Maps'te sahibi tarafından doğrulanıp doğrulanmadığını belirtir
- lastTür: string | null
_updated _time verilerin son güncellendiği tarih ve saat
UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
örnek:2023-01-26 09:03:15 +00:00 - latitudeTür: number | null
yerel işletmelerin google maps'teki enlem koordinatı
örnek:"latitude": 51.584091 - localTür: array (object | null)[] | null
_business _links işletmeyle kullanılabilir etkileşimler
işletmeyle doğrudan arama sonuçlarından etkileşim kurma seçeneklerinin listesi- typeTür: string | null
öğe türü
- logoTür: string | null
Google My Business profilinde görünen logonun URL'si
- longitudeTür: number | null
yerel işletmenin google maps'teki boylam koordinatı
örnek:"longitude": -0.31365919999999997 - mainTür: string | null
_image Google My Business profilinde yer alan ana görselin URL'si
- originalTür: string | null
_title öğenin özgün başlığı
Google tarafından çevrilmemiş özgün başlık - peopleTür: array (object | null)[] | null
_also _search ilgili işletmeler
- cidTür: string | null
- featureTür: string | null
_id - ratingTür: object | null · Response36Afe1097B20_RatingInfo
öğenin puanı
yorumlara dayalı popülerlik oranı; SERP'te gösterilir- ratingTür: integer | null
_max rating_type için maksimum değer
- ratingTür: string | null
_type puanlama türü burada şu öğeleri bulabilirsiniz: Max5, Percents, CustomMax
- valueTür: number | null Biçim: double
puanlamanın değeri
- votesTür: integer | null Biçim: int64
_count geri bildirim miktarı
- titleTür: string | null
SERP'teki öğenin başlığı
sonuçların toplandığı işletmenin adı
- phoneTür: string | null
işletmenin telefon numarası
- placeTür: string | null
_id benzersiz yer tanımlayıcısı
öğede gösterilen yerel işletmenin place id değeri
tanımlayıcı hakkında daha fazla bilgiyi bu yardım merkezi makalesinde bulabilirsiniz - placeTür: object | null
_topics müşteri yorumlarında geçen anahtar kelimeler
bir işletmenin müşteri yorumlarında geçen ürün/hizmetlerle ilgili en popüler anahtar kelimeleri ve her anahtar kelimenin geçtiği yorum sayısını içerir
örnek:
"place_topics": {
"egg roll": 48,
"birthday": 33
}- propertyTür: integer | null Biçim: int64
Name Signed 64-bit integers (long type).
- popularTür: object | null · Response36Afe1097B20_PopularTimes
_times yoğun saatler
işletmenin yoğun saatlerine ilişkin bilgiler- popularTür: object | null
_times _by _days yoğun saatler
yerel işletmenin haftanın her günündeki yoğun saatleri hakkında bilgiler- propertyTür: array (object | null)[] | null
Name pazar günü çalışma saatleri
- popularTür: integer | null
_index popülerlik endeksi 0 ile 100 arasında ölçülen, zamana bağlı göreli popülerlik endeksi; yüksek değer, günün daha yoğun bir saatine karşılık gelir
- timeTür: object | null · Response36Afe1097B20_TimeInfo
24 saat biçimindeki saat
- hourTür: integer | null
24 saat biçimindeki saat
- minuteTür: integer | null
dakika
- priceTür: string | null
_level mekân fiyat düzeyi
şu değerleri alabilir:inexpensive,moderate,expensive,very_expensive
fiyat düzeyi bilgisi yoksa değernullolur - ratingTür: object | null · Response36Afe1097B20_RatingInfo
öğenin puanı
yorumlara dayalı popülerlik oranı; SERP'te gösterilir- ratingTür: number | null Biçim: double
_max rating_type için maksimum değer
- ratingTür: string | null
_type puanlama türü burada şu öğeleri bulabilirsiniz: Max5, Percents, CustomMax
- valueTür: number | null Biçim: double
puanlamanın değeri
- votesTür: integer | null Biçim: int64
_count geri bildirim miktarı
- ratingTür: object | null
_distribution işletmenin puan dağılımı
nesne, kullanıcıların yorumlarına göre 1 ile 5 yıldız arasındaki puanların sayısını gösterir- propertyTür: integer | null Biçim: Int64
Name
- servicesTür: array (object | null)[] | null
- categoryTür: string | null
işletme kategorisi
işletme tarafından sunulan hizmetleri en iyi tanımlayan genel Google My Business kategorisi - priceTür: object | null · Response36Afe1097B20_PriceInfo
- currencyTür: string | null
listelenen fiyatın para birimi fiyata uygulanan para biriminin ISO kodu
- currentTür: number | null Biçim: double
güncel fiyat sonuçta yer alan ürün veya hizmetin güncel fiyatını belirtir
- displayedTür: string | null
_price sonuçtaki fiyat dizesi sonuçta sağlanan ham fiyat dizesi
- isTür: boolean | null
_price _range fiyat aralık olarak sağlanır fiyatın aralık olarak sağlanıp sağlanmadığını belirtir
- maxTür: number | null Biçim: double
_value maksimum fiyat sonuçta belirtilen ürün veya hizmetin maksimum fiyatı
- regularTür: number | null Biçim: double
normal fiyat indirim uygulanmamış ürün veya hizmetin normal fiyatını belirtir
- snippetTür: string | null
işletme hakkında ek bilgiler
- titleTür: string | null
SERP'teki öğenin başlığı
sonuçların toplandığı işletmenin adı
- snippetTür: string | null
işletme hakkında ek bilgiler
- titleTür: string | null
SERP'teki öğenin başlığı
sonuçların toplandığı işletmenin adı - totalTür: integer | null Biçim: int64
_photos Google My Business profilinde yer alan toplam görsel sayısı
- typeTür: string | null
öğe türü
- urlTür: string | null
işletmenin mutlak URL'si
- workTür: object | null · Response36Afe1097B20_BusinessWorkHoursInfo
_time çalışma saati ayrıntıları
işletmenin çalışma saatlerine ilişkin bilgiler- workTür: object | null · Response36Afe1097B20_WorkHours
_hours çalışma saatleri
yerel işletmenin çalışma saatlerine ilişkin bilgiler- currentTür: string | null
_status işletmenin mevcut durumu
işletmenin açık mı kapalı mı olduğunu belirtir - timetableTür: object | null
çalışma saatleri çizelgesi
- propertyTür: array (object | null)[] | null
Name pazar günü çalışma saatleri
- closeTür: object | null · Response36Afe1097B20_TimeInfo
kapanış saati
- hourTür: integer | null
24 saat biçimindeki saat
- minuteTür: integer | null
dakika
- openTür: object | null · Response36Afe1097B20_TimeInfo
açılış saati
- hourTür: integer | null
24 saat biçimindeki saat
- minuteTür: integer | null
dakika
- offsetTür: integer | null Biçim: int64
Signed 64-bit integers (long type).
- offsetTür: string | null
_token - totalTür: integer | null Biçim: int64
_count veritabanımızda isteğinizle ilgili toplam sonuç sayısı
- resultTür: integer | null Biçim: int64
_count result dizisindeki öğe sayısı
- statusTür: integer | null
_code görevin durum kodu DataForSEO tarafından oluşturulur; şu aralıkta olabilir: 10000-60000 yanıt kodlarının tam listesini burada bulabilirsiniz
- statusTür: string | null
_message görevin bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz
- timeTür: string | null
yürütme süresi, saniye
- Tür: integer | null Biçim: int64tasks
_count tasks dizisindeki görev sayısı
- Tür: integer | null Biçim: int64tasks
_error tasks dizisinde hata ile dönen görev sayısı
- Tür: string | nulltime
toplam yürütme süresi, saniye
- Tür: string | nullversion
API'nin geçerli sürümü
application/json - 400
İstek işlenemedi. İstek parametrelerini kontrol edin.
- 401
Geçerli bir Felo API anahtarı gerekir.
- 402
Faturalandırma koşulu karşılanmadığı için istek devam edemiyor.
- 403
Hesabın bu işlemi gerçekleştirme izni yok.
- 429
İstek veya harcama sınırına ulaşıldı.
- 502
Hizmet isteği tamamlayamadı.
- 503
API veya faturalandırma hizmeti geçici olarak kullanılamıyor.
- 504
İstek işlenirken hizmet zaman aşımına uğradı.
- default
Hata yanıtı; upstream sağlayıcıdan doğrudan aktarılan yanıtlar sağlayıcı biçimlerini kullanabilir
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]"
]
}
]
}
]
}
]
}