Google Local Finder SERP görevlerini oluşturma
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google Local Finder SERP görevlerini oluşturma
Bir sorgu açıkça yerel olduğunda Google'ın gösterdiği genişletilmiş yerel sonuçları kuyruğa alır ve tasks[0].id içinde bir görev id değeri döndürür. DataForSEO zarfına sarılıdır: veriler tasks[0].result içinde, sonuç tasks[0].status_code içinde — reddedilen bir istek yine de HTTP 200 döndürür. Canlı eşi hemen yanıt verir ve tek bir sorgu için daha basittir; toplu iş bir araç çağrısından uzun sürecekse kuyruğa alın.
Fiyatlandırma referansı
- Ölçümlendirme: bildirilen yanıt maliyeti.
- Referans istek tahmini: USD 0.02.
- 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)[]
- depthTür: integer | null
ayrıştırma derinliği
isteğe bağlı alan
SERP'teki sonuç sayısı
varsayılan değer:
10maksimum değer:
350
Hesabınızdan 10 sonuca kadar içeren her SERP için ücret alınır;
10 üzerinde derinlik ayarlamak, arama motoru 10'dan fazla sonuç döndürürse ek ücretlere yol açabilir;belirtilen derinlik yanıttaki sonuç sayısından yüksekse fark otomatik olarak hesap bakiyenize iade edilir
maliyet Fiyatlandırma sayfasında hesaplanabilir. - deviceTür: string | null
cihaz türü
isteğe bağlı alan
belirli bir cihaz türü için sonuç döndür
şu değerleri alabilir:
desktop,mobilevarsayılan değer:
desktop - keywordTür: string
anahtar kelime
zorunlu alan
keywordalanında en fazla 700 karakter belirtebilirsiniztüm %## kodları çözülür (‘+’ karakteri boşluk karakteri olarak çözülür)
keywordiçin “%” karakterini kullanmanız gerekiyorsa “%25” olarak belirtin;keywordiçin “+” karakterini kullanmanız gerekiyorsa “%2B” olarak belirtin
DataForSEO API'lerinde
keywordvekeywordsalanlarının kural ve sınırlamaları hakkında daha fazla bilgi için Yardım Merkezi makalesine bakın - languageTür: string
_code arama motoru dil kodu
language_namebelirtmezseniz zorunlu alanbu alanı kullanırsanız
language_namebelirtmeniz gerekmezarama motorunun mevcut dillerinin listesini
language_codedeğerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesörnek:
en - languageTür: string
_name arama motoru dilinin tam adı
language_codebelirtmezseniz zorunlu alanbu alanı kullanırsanız
language_codebelirtmeniz gerekmezarama motorunun mevcut dillerinin listesini
language_namedeğerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:https://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesörnek:
English - locationTür: integer
_code arama motoru konum kodu
location_nameveyalocation_coordinatebelirtmezseniz zorunlu alanbu alanı kullanırsanız
location_nameveyalocation_coordinatebelirtmeniz gerekmezarama motorlarının mevcut konumlarının listesini
location_codedeğerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:https://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsörnek:
2840 - locationTür: string
_coordinate bir konumun GPS koordinatları
location_nameveyalocation_codebelirtmezseniz zorunlu alanbu alanı kullanırsanız
location_nameveyalocation_codebelirtmeniz gerekmezlocation_coordinateparametresi "latitude,longitude,zoom" biçiminde belirtilmelidir"zoom" belirtilmezse varsayılan değer olarak 9z uygulanır
"latitude" ve "longitude" için maksimum ondalık basamak sayısı: 7
"zoom" için minimum değer: 4z
"zoom" için maksimum değer: 18z
örnek:
52.6178549,-155.352142,18z - locationTür: string
_name arama motoru konumunun tam adı
location_codeveyalocation_coordinatebelirtmezseniz zorunlu alanbu alanı kullanırsanız
location_codeveyalocation_coordinatebelirtmeniz gerekmezarama motorunun mevcut konumlarının listesini
location_namedeğerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:https://api.dataforseo.com/v3/serp/{{low_se_name}}/locationsörnek:
London,England,United Kingdom - minTür: number | null Biçim: double
_rating sonuçları minimum puana göre filtrele
isteğe bağlı alan
desktopiçin olası değerler:3.5,4,4.5;mobileiçin olası değerler:2,2.5,3,3.5,4,4.5 - osTür: string | null
cihaz işletim sistemi
isteğe bağlı alan
desktopdeğerinidevicealanında belirtirseniz şu değerlerden birini seçin:windows,macosvarsayılan değer:
windowsmobiledeğerinidevicealanında belirtirseniz şu değerlerden birini seçin:android,iosvarsayılan değer:
android - pingbackTür: string | null
_url tamamlanan görevin bildirim URL'si
isteğe bağlı alan
görev tamamlandığında belirttiğiniz URL'ye gönderilen GET isteğiyle sizi bilgilendireceğiz
‘$id’ dizesini
$iddeğişkeni, ‘$tag’ dizesini ise URL kodlu$tagdeğişkeni olarak kullanabilirsiniz. İsteği göndermeden önce gerekli değerleri ayarlayacağız.örnek:
http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagNot:
pingback_urliçindeki özel karakterler URL kodlanacaktır;ör.
#karakteri%23olarak kodlanır
daha fazla bilgi için Yardım Merkezimize bakın
- postbackTür: string
_data postback_url veri türü
postback_urlbelirtirseniz zorunlu alangörevi ayarlamak için kullandığınız işleve karşılık gelir
olası değerler:
advanced,html - postbackTür: string | null
_url görev sonuçlarını göndermek için URL
isteğe bağlı alan
görev tamamlandığında sonuçlarını
gzipbiçiminde sıkıştırarak belirttiğinizpostback_urladresine POST isteğiyle göndereceğiz‘$id’ dizesini
$iddeğişkeni, ‘$tag’ dizesini ise URL kodlu$tagdeğişkeni olarak kullanabilirsiniz. İsteği göndermeden önce gerekli değerleri ayarlayacağız.örnek:
http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tagNot:
postback_urliçindeki özel karakterler URL kodlanır;yani,
#karakteri%23olarak kodlanır
daha fazla bilgi için Yardım Merkezimize bakın
- priorityTür: integer | null
görev önceliği
isteğe bağlı alan
şu değerleri alabilir:
1 – normal yürütme önceliği (varsayılan olarak ayarlanır)
2 – yüksek yürütme önceliği
Yüksek yürütme önceliğine sahip görevler için ek ücret alınır.Maliyet Fiyatlandırma sayfasında hesaplanabilir.
- 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
belirttiğiniz
tagdeğerini yanıtındatanesnesinde bulacaksınız - timeTür: string | null
_filter sonuçları açık saatlere göre filtrele
isteğe bağlı alan
bu alanı kullanarak sonuçlardaki yerleri ziyaretçilere açık oldukları saate göre filtreleyebilirsiniz
Google'ın bu filtreyle eşleşmeyen sonuçlar da sağlayabileceğini unutmayın
olası değerler:
"open_now","24_hours","$day_value","$day_value;$time_value";$day_valueyerine şu değerlerden birini kullanın:"monday","tuesday","wednesday","thursday","friday","saturday","sunday";$time_valueyerine şu değerlerden birini kullanın:"00","01","02","03","04","05","06","07","08","09","10","11","12","13","14","15","16","17","18","19","20","21","22","23"örnek:
"tuesday;18"
- Tür: object | null · Response36Afe1097B20_SerpGoogleLocalFinderTaskPostResponseInfo200
- 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_SerpGoogleLocalFinderTaskPostTaskInfo
- 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: object | null
sonuç dizisi
bu durumda değernullolur - 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/serp/google/local_finder/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "local nail services",
"min_rating": 4.5,
"time_filter": "monday"
}
]'
{
"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
}
]
}