Felo API PlatformFelo API Platform
Tüm DataForSEO endpoint'leri
v0.2.0-beta
OpenAPI 3.1.0

Google Organik SERP Görevlerini Ayarlama

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

Google Organik SERP Görevlerini Ayarlama

​

Google'da bir anahtar kelime için sıralı 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ını aşacaksa 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)[]
    • browser_screen_height
      Tür: integer | null

      tarayıcı ekran yüksekliği

      isteğe bağlı alan

      belirli bir cihaz için piksel sıralaması hesaplamak üzere özel bir tarayıcı ekran yüksekliği ayarlayabilirsiniz;

      şu aralıkta belirtilebilir: 240-9999;

      varsayılan olarak parametre şu şekilde ayarlanır:

      desktop için 1080;

      android üzerinde mobile için 640;

      iOS üzerinde mobile için 812;

      Not: bu parametreyi kullanmak için calculate_rectangles değerini true olarak ayarlayın

    • browser_screen_resolution_ratio
      Tür: integer | null

      tarayıcı ekran çözünürlük oranı

      isteğe bağlı alan

      belirli bir cihaz için piksel sıralaması hesaplamak üzere özel bir tarayıcı ekran çözünürlük oranı ayarlayabilirsiniz;

      şu aralıkta belirtilebilir: 0.5-3;

      varsayılan olarak parametre şu şekilde ayarlanır:

      desktop için 1;

      android üzerinde mobile için 3;

      iOS üzerinde mobile için 3;

      Not: bu parametreyi kullanmak için calculate_rectangles değerini true olarak ayarlayın

    • browser_screen_width
      Tür: integer | null Biçim: int64

      tarayıcı ekran genişliği

      isteğe bağlı alan

      belirli bir cihaz için piksel sıralaması hesaplamak üzere özel bir tarayıcı ekran genişliği ayarlayabilirsiniz;

      şu aralıkta belirtilebilir: 240-9999;

      varsayılan olarak parametre şu şekilde ayarlanır:

      desktop için 1920;

      android üzerinde mobile için 360;

      iOS üzerinde mobile için 375;

      Not: bu parametreyi kullanmak için calculate_rectangles değerini true olarak ayarlayın

    • calculate_rectangles
      Tür: boolean | null

      gelişmiş sonuçlardaki SERP öğeleri için piksel sıralaması hesapla

      isteğe bağlı alan

      piksel sıralaması, sonuç snippet'i ile ekranın sol üst köşesi arasındaki mesafeyi ifade eder;

      Daha fazla bilgi için Yardım Merkezini ziyaret edin>>

      varsayılan olarak parametre false olarak ayarlanır

      Not: bu parametreyi kullanmak için ek olarak $0.0006 ücret alınır

    • depth
      Tür: integer | null

      ayrıştırma derinliği

      isteğe bağlı alan

      SERP'teki sonuç sayısı

      varsayılan değer: 10

      maksimum değer: 700


      Hesabınız 10 sonuca kadar içeren her SERP için faturalandırılır;

      10'un üzerinde derinlik ayarlamak arama motoru 10'dan fazla sonuç döndürürse ek ücretlere yol açabilir;

      Maliyet, Fiyatlandırma sayfasında hesaplanabilir.

    • device
      Tü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, mobile

      varsayılan değer: desktop

    • expand_ai_overview
      Tür: boolean | null

      ai overview'ı genişlet

      isteğe bağlı alan

      ai_overview öğesini genişletmek için true olarak ayarlayın;

      varsayılan değer: false;

      Not: bu parametre yalnızca HTML görev sonuçları için geçerlidir

    • find_targets_in
      Tür: array string[] | null

      hedefler için kontrol edilecek SERP öğe türleri

      isteğe bağlı alan

      bu parametreyi etkinleştirmek için stop_crawl_on_match da etkinleştirilmelidir

      hangi SERP öğe türlerinin hedef eşleşmeleri için kontrol edileceğini belirtir

      belirtilmezse url ve domain alanlarına sahip tüm birinci düzey öğeler hedefler için kontrol edilir

      olası değerler: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter

      Not: ignore_targets_in ile aynı öğe türlerini içeremez

      örnek:

      "find_targets_in": ["organic", "featured_snippet"]

      bu parametre hakkında daha fazla bilgiyi Yardım Merkezimizde bulabilirsiniz

    • group_organic_results
      Tür: boolean | null

      ilgili sonuçları görüntüle

      isteğe bağlı alan

      true olarak ayarlanırsa yanıttaki related_result öğesi üst organik sonucunun snippet'i olarak sağlanır;

      false olarak ayarlanırsa related_result öğesi ayrı bir organik sonuç olarak sağlanır;

      varsayılan değer: true

    • ignore_targets_in
      Tür: array string[] | null

      hedef aramasından hariç tutulacak SERP öğe türleri

      isteğe bağlı alan

      bu parametreyi etkinleştirmek için stop_crawl_on_match da etkinleştirilmelidir

      hedef eşleşmeleri aranırken hangi SERP öğe türlerinin hariç tutulacağını belirtir

      olası değerler: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter

      Not: find_targets_in ile aynı öğe türlerini içeremez

      örnek:

      "ignore_targets_in": ["paid", "images"]

      bu parametre hakkında daha fazla bilgiyi Yardım Merkezimizde bulabilirsiniz

    • keyword
      Tür: string

      anahtar kelime

      zorunlu alan

      keyword alanında en fazla 700 karakter belirtebilirsiniz

      tüm %## kodları çözülür (‘+’ karakteri boşluk karakteri olarak çözümlenir)

      keyword için “%” karakterini kullanmanız gerekiyorsa “%25” olarak belirtin;

      keyword için “+” karakterini kullanmanız gerekiyorsa “%2B” olarak belirtin;

      bu alan ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘cache:’, ‘define:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘site:’, görev başına ücret 5 ile çarpılır

      DataForSEO API'lerinde keyword ve keywords alanlarının kural ve sınırlamaları hakkında daha fazla bilgi için 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

    • load_async_ai_overview
      Tür: boolean | null

      asenkron ai overview yükle

      isteğe bağlı alan

      asenkron olarak yüklenseler bile SERP'lerde ai_overview öğeleri almak için true olarak ayarlayın;

      false olarak ayarlanırsa ai_overview öğelerini yalnızca önbellekten alırsınız;

      varsayılan değer: false

      Not: bu parametreyi kullanmak için ek olarak $0.0006 ücret alınır;

      öğe yoksa veya "asynchronous_ai_overview": false içeriyorsa tüm ek ücretler hesap bakiyenize iade edilir

    • location_code
      Tür: integer

      arama motoru konum kodu

      location_name veya location_coordinate belirtmezseniz zorunlu alan

      bu alanı kullanırsanız location_name veya location_coordinate belirtmeniz gerekmez

      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_coordinate
      Tür: string

      bir konumun GPS koordinatları

      belirtmezseniz zorunlu alan location_name veya location_code

      bu alanı kullanırsanız location_name veya location_code belirtmeniz gerekmez

      location_coordinate parametresi "latitude,longitude,radius" biçiminde belirtilmelidir

      "latitude" ve "longitude" için maksimum ondalık basamak sayısı: 7

      "radius" için minimum değer: 199 (mm)

      "radius" için maksimum değer: 199999 (mm)

      örnek:

      53.476225,-2.243572,200

    • location_name
      Tür: string

      arama motoru konumunun tam adı

      location_code veya location_coordinate belirtmezseniz zorunlu alan

      bu alanı kullanırsanız location_code veya location_coordinate 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/locations

      örnek:

      London,England,United Kingdom

    • match_type
      Tür: string

      hedef eşleşme türü

      stop_crawl_on_match belirtilirse zorunlu alan

      match_value için eşleşme türü

      olası değerler:

      domain – belirli alan adı veya alt alan adı

      with_subdomains – ana alan adı ve alt alan adları

      wildcard – joker deseni

    • match_value
      Tür: string

      hedef alan adı, alt alan adı veya joker değeri

      stop_crawl_on_match belirtilirse zorunlu alan

      hedef alan adı, alt alan adı veya joker değeri belirtin;

      Not: alan adı veya alt alan adı istek protokolü olmadan belirtilmelidir;

      örnek: "match_value": "dataforseo.com",

      "match_value": "/blog/post-*"

    • max_crawl_pages
      Tür: integer | null

      sayfa tarama limiti

      isteğe bağlı alan

      taranacak arama sonuçları sayfası sayısı

      maksimum değer: 100

      Not: taranan her sayfa için ücret alınır (sayfa başına 10 organik sonuç);

      fiyatlandırma hakkında daha fazla bilgi için Fiyatlandırma sayfasına bakın;

      Not#2: max_crawl_pages ve depth parametreleri birbirini tamamlar;

      daha fazla bilgi için yardım merkezimize bakın

    • os
      Tür: string | null

      cihaz işletim sistemi

      isteğe bağlı alan

      desktop değerini device alanında belirtirseniz şu değerlerden birini seçin: windows, macos

      varsayılan değer: windows

      mobile değerini device alanında belirtirseniz şu değerlerden birini seçin: android, ios

      varsayılan değer: android

    • people_also_ask_click_depth
      Tür: integer | null

      ilgili öğeye yapılan tıklamalar

      isteğe bağlı alan

      ek people_also_ask_element öğeleri almak için people_also_ask öğesindeki tıklama derinliğini belirtin;

      Not: görev önceliğinden bağımsız olarak her tıklama için hesabınızdan $0.00015 ek ücret alınır;

      öğe yoksa veya belirttiğinizden daha az tıklama yaparsak tüm ek ücretler hesap bakiyenize iade edilir

      olası değerler: 1 ile 4 arası

    • 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:

      regular, advanced, html

    • 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.

    • remove_from_url
      Tür: array string[] | null

      URL'lerden belirli parametreleri kaldır

      isteğe bağlı alan

      bu alanı kullanarak sonuçtaki URL'lerden kaldırılacak en fazla 10 parametre belirtebilirsiniz

      örnek:

      "remove_from_url": ["srsltid"]

    • se_domain
      Tür: string | null

      arama motoru alan adı

      isteğe bağlı alan

      ilgili arama motoru alan adını belirttiğiniz konum ve dile göre otomatik olarak seçeriz

      ancak bu alanda özel bir arama motoru alan adı ayarlayabilirsiniz

      örnek:

      google.co.uk, google.com.au, google.de vb.

    • search_param
      Tür: string | null

      arama sorgusunun ek parametreleri

      isteğe bağlı alan

      kullanılabilir parametrelerin listesini ve ek ayrıntıları burada bulabilirsiniz


      Not: aşağıdaki arama motoru parametreleri desteklenmez ve belirtilirse otomatik olarak kaldırılır: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
    • stop_crawl_on_match
      Tür: array (object | null)[] | null

      taramayı durduracak hedef dizisi isteğe bağlı alan belirtilirse yanıt, belirtilen match_value dahil olmak üzere bu değere kadar SERP sonuçlarını içerir; bu dizide en fazla 10 hedef değer belirtebilirsiniz örnek: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] bu parametre hakkında daha fazla bilgi için Yardım Merkezimize bakın — https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Hesabınız, belirtilen hedefler üzerinden taranan her SERP için faturalandırılır

      • match_type
        Tür: string | null

        hedef eşleme türü stop_crawl_on_match belirtilirse zorunlu alan; match_value için eşleme türü olası değerler: domain, with_subdomains, wildcard

      • match_value
        Tür: string | null

        hedef alan adı veya joker değeri stop_crawl_on_match belirtilirse zorunlu alan; bir hedef alan adı veya joker değeri belirtin; Not: alan adı istek protokolü olmadan belirtilmelidir; örnek: dataforseo.com

    • 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

    • target_search_mode
      Tür: string | null

      hedef eşleme modu

      isteğe bağlı alan

      bu parametreyi etkinleştirmek için stop_crawl_on_match de etkinleştirilmelidir

      stop_crawl_on_match içinde birden fazla hedef belirtildiğinde taramanın nasıl duracağını tanımlar

      olası değerler: all, any

      all – tarama yalnızca belirtilen tüm hedefler bulunduğunda durur

      any – tarama herhangi bir tek hedef bulunduğunda durur

      varsayılan değer: any

      bu parametre hakkında daha fazla bilgi için Yardım Merkezimize bakın

    • url
      Tür: string | null

      arama sorgusunun doğrudan URL'si

      isteğe bağlı alan

      doğrudan bir URL belirtebilirsiniz, biz de onu gerekli alanlara ayrıştırırız. Bu yöntemin API'miz için işlenmesi en zor yöntem olduğunu ve URL'de tam dil ve konum belirtmenizi gerektirdiğini unutmayın. Çoğu durumda bu yöntemi önermeyiz.

      örnek:

      https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS


      Not: aşağıdaki arama motoru parametreleri desteklenmez ve URL'de belirtilirse otomatik olarak kaldırılır: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
Yanıtlar
  • 200
    Tür: object | null · Response36Afe1097B20_SerpGoogleOrganicTaskPostResponseInfo
    • 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_SerpGoogleOrganicTaskPostTaskInfo
        • 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
Request Example for post/v1/beta/dataforseo/serp/google/organic/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/organic/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"
  },
  {
    "language_name": "English",
    "location_name": "United States",
    "keyword": "albert einstein",
    "priority": 2,
    "tag": "some_string_123",
    "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
  },
  {
    "url": "https://www.google.co.uk/search?q=albert%20einstein&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS",
    "postback_data": "html",
    "postback_url": "https://your-server.com/postbackscript"
  }
]'

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

Setting Google Organic SERP Tasks