v0.2.0-beta

OpenAPI 3.1.0

Google Autocomplete görevlerini oluşturma

Felo API Support

MIT

Sunucu

https://openapi.felo.ai

İstemci Kitaplıkları

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO İşlemler

post/v1/beta/dataforseo/serp/google/autocomplete/task_post

Google Autocomplete görevlerini oluşturma

Google'da bir sorgu yazılırken Google'ın sunduğu önerileri 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.

Gövde

application/json

Tür: array (object | null)[]
- client
  Tür: string | null
  
  otomatik tamamlama için arama istemcisi
  
  isteğe bağlı alan
  
  otomatik tamamlama sonuçları arama istemcisine göre farklılık gösterebilir;
  
  olası değerler:
  
  chrome — Google araması Google Chrome tarayıcısında açıldığında kullanılır;
  
  chrome-omni — Chrome'daki adres çubuğunda kullanılır;
  
  gws-wiz — Google arama ana sayfasında kullanılır;
  
  gws-wiz-serp — Google arama motoru sonuç sayfasında kullanılır;
  
  safari — Google araması Safari tarayıcısında açıldığında kullanılır;
  
  firefox — Google araması Firefox tarayıcısında açıldığında kullanılır;
  
  psy-ab — Google araması Google Chrome tarayıcısında açıldığında kullanılabilir;
  
  toolbar — XML döndürür;
  
  youtube — JSONP döndürür;
  
  gws-wiz-local — Google yerel aramada kullanılır;
  
  img — Google görsel aramada kullanılır;
  
  products-cc — Google alışveriş aramasında kullanılır
- cursor_pointer
  Tür: integer | null
  
  arama çubuğu imleç konumu
  
  isteğe bağlı alan
  
  imlecin arama çubuğundaki anahtar kelime içindeki yatay sayısal konumu;
  
  imlecin konumunu değiştirerek aynı tohum anahtar kelime için farklı otomatik tamamlama önerileri elde edersiniz;
  
  minimum değer: 0
  
  varsayılan değer: belirtilen keyword ifadesinin son karakterinin numarası
  
  örnek:
  
  |which query are s - "cursor_pointer": 0
  
  which query is s| - "cursor_pointer": 16
  
  which que|ry is s - "cursor_pointer": 9
- keyword
  Tür: string
  
  anahtar kelime
  
  zorunlu alan
  
  keyword alanına en fazla 700 karakter girebilirsiniz
  
  tüm %## dizileri çözümlenir (“+” karakteri boşluk karakterine çözümlenir)
  
  keyword için “%” karakteri kullanmanız gerekiyorsa “%25” olarak belirtin;
  
  keyword için “+” karakteri kullanmanız gerekiyorsa “%2B” olarak belirtin;
  
  DataForSEO API'lerinde keyword ve keywords alanlarının kural ve sınırlamaları hakkında daha fazla bilgi için bu Yardım Merkezi makalesine bakın
- language_code
  Tür: string
  
  arama motoru dil kodu
  
  language_name belirtmezseniz zorunlu alan
  
  bu alanı kullanırsanız language_name belirtmeniz gerekmez;
  
  arama motorunun mevcut dillerinin listesini language_code değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/serp/google/languages
  
  örnek:
  
  en
- language_name
  Tür: string
  
  arama motoru dilinin tam adı
  
  language_code belirtmezseniz zorunlu alan
  
  bu alanı kullanırsanız language_code belirtmeniz gerekmez;
  
  arama motorunun mevcut dillerinin listesini language_name değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/serp/google/languages
  
  örnek:
  
  English
- location_code
  Tür: integer
  
  arama motoru konum kodu
  
  location_name belirtmezseniz zorunlu alan;
  
  arama motorlarının mevcut konumlarının listesini location_code değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/serp/google/locations
  
  örnek:
  
  2840
- location_name
  Tür: string
  
  arama motoru konumunun tam adı
  
  location_code belirtmezseniz zorunlu alan
  
  bu alanı kullanırsanız location_code belirtmeniz gerekmez;
  
  arama motorunun mevcut konumlarının listesini location_name değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/serp/google/autocomplete/locations
  
  örnek:
  
  London,England,United Kingdom
- pingback_url
  Tür: string | null
  
  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 $id değişkeni, ‘$tag’ dizesini ise URL kodlu $tag değişkeni olarak kullanabilirsiniz. İsteği göndermeden önce gerekli değerleri ayarlayacağız.
  
  örnek:
  
  http://your-server.com/pingscript?id=$id
  
  http://your-server.com/pingscript?id=$id&tag=$tag
  
  Not: pingback_url içindeki özel karakterler URL kodlanacaktır;
  
  ör. # karakteri %23 olarak kodlanır
  
  daha fazla bilgi için Yardım Merkezimize bakın
- postback_data
  Tür: string
  
  postback_url veri türü
  
  postback_url belirtirseniz zorunlu alan
  
  sunucunuza gönderilecek veri türüne karşılık gelir
  
  olası değerler:
  
  advanced
- postback_url
  Tür: string | null
  
  görev sonuçlarını göndermek için URL
  
  isteğe bağlı alan
  
  görev tamamlandığında sonuçlarını gzip biçiminde sıkıştırarak belirttiğiniz postback_url adresine POST isteğiyle göndereceğiz
  
  ‘$id’ dizesini $id değişkeni, ‘$tag’ dizesini ise URL kodlu $tag değişkeni olarak kullanabilirsiniz. İsteği göndermeden önce gerekli değerleri ayarlayacağız.
  
  örnek:
  
  http://your-server.com/postbackscript?id=$id
  
  http://your-server.com/postbackscript?id=$id&tag=$tag
  
  Not: postback_url içindeki özel karakterler URL kodlanır;
  
  yani, # karakteri %23 olarak kodlanır
  
  daha fazla bilgi için Yardım Merkezimize bakın
- priority
  Tü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.
- tag
  Tü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 tag değerini yanıtın data nesnesinde bulacaksınız

Yanıtlar

200
Tür: object | null · Response36Afe1097B20_SerpGoogleAutocompleteTaskPostResponseInfo
cost
Tür: number | null Biçim: double

toplam görev maliyeti, USD

status_code
Tür: integer | null

genel durum kodu yanıt kodlarının tam listesini burada bulabilirsiniz

status_message
Tür: string | null

genel bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

tasks
Tür: array (object | null)[] | null

görev dizisi

Tür: object | null · Response36Afe1097B20_SerpGoogleAutocompleteTaskPostTaskInfo
cost
Tür: number | null Biçim: double

toplam görev maliyeti, USD

data
Tür: object | null

POST isteğinde belirttiğiniz parametrelerin aynısını içerir

propertyName
Tür: object | null
id
Tür: string | null

görev tanımlayıcısı sistemimizde UUID biçiminde benzersiz görev tanımlayıcısı

path
Tür: array (string | null)[] | null

URL yolu

result
Tür: object | null

sonuç dizisi
bu durumda değer null olur

result_count
Tür: integer | null Biçim: int64

result dizisindeki öğe sayısı

status_code
Tür: integer | null

görevin durum kodu DataForSEO tarafından oluşturulur; şu aralıkta olabilir: 10000-60000 yanıt kodlarının tam listesini burada bulabilirsiniz

status_message
Tür: string | null

görevin bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

time
Tür: string | null

yürütme süresi, saniye

tasks_count
Tür: integer | null Biçim: int64

tasks dizisindeki görev sayısı

tasks_error
Tür: integer | null Biçim: int64

tasks dizisinde hata ile dönen görev sayısı

time
Tür: string | null

toplam yürütme süresi, saniye

version
Tür: string | null

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

post/v1/beta/dataforseo/serp/google/autocomplete/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/autocomplete/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein",
    "cursor_pointer": 6
  }
]'

Şemayı göster

{
  "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
    }
  ]
}

Başarılı işlem

Google Autocomplete görevlerini oluşturma

Kimlik doğrulamaRequired

DataForSEO

Google Autocomplete görevlerini oluşturma

Fiyatlandırma referansı