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

Canlı Google News SERP

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

Canlı Google News SERP

​

Google'da bir anahtar kelime için haber sonuçlarını eşzamanlı olarak döndürür. keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count ve items döndürür. advanced varsayılan seçimdir; yalnızca sıralı liste önemliyse regular, yalnızca ayrıştırıcının neyi attığını görmek için html kullanın. 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.

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;

      varsayılan olarak parametre 1080 olarak ayarlanır;

      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;

      varsayılan olarak parametre 1 olarak ayarlanır;

      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;

      varsayılan olarak parametre 1920 olarak ayarlanır;

      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: true olarak ayarlanırsa görev başına ücret 2 ile çarpılı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: 200


      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;

      Belirtilen derinlik yanıttaki sonuç sayısından yüksekse fark otomatik olarak hesap bakiyenize iade edilir

      Maliyet, Fiyatlandırma sayfasında hesaplanabilir.

    • 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 karakterine çö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:', 'define:', 'filetype:', 'id:', 'inanchor:', 'info:', 'intext:', 'intitle:', 'inurl:', 'link:', 'related:', 'site:' gibi parametreler içeriyorsa görev başına ücret 5 ile çarpılır

      Not: ‘cache:’ parametresini içeren sorgular desteklenmez ve doğrulama hatası döndürü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/{{low_se_name}}/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/{{low_se_name}}/languages

      örnek:

      English

    • 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/{{low_se_name}}/locations

      örnek:

      2840

    • location_coordinate
      Tür: string

      bir konumun GPS koordinatları

      location_name veya location_code belirtmezseniz zorunlu alan

      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.9 (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/{{low_se_name}}/locations

      örnek:

      London,England,United Kingdom

    • max_crawl_pages
      Tür: integer | null

      sayfa tarama sınırı

      isteğe bağlı alan

      taranacak arama sonucu sayfası sayısı

      maksimum değer: 100

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

      bu API'nin yalnızca masaüstü için sonuç sağladığını unutmayın

      şu değerlerden birini seçin: windows, macos

      varsayılan değer: windows

    • 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

      mevcut parametrelerin listesini ve ek ayrıntıları burada bulabilirsiniz.

    • url
      Tür: string | null

      arama sorgusunun doğrudan URL'si

      isteğe bağlı alan

      doğrudan bir URL belirtebilirsiniz ve biz bunu gerekli alanlara ayırırız. Bu yöntemin API'miz için işlenmesi en zor yöntem olduğunu ve URL'de tam dil ile 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

Yanıtlar
  • 200
    Tür: object | null · Response36Afe1097B20_SerpGoogleNewsLiveAdvancedResponseInfo
    • 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_SerpGoogleNewsLiveAdvancedTaskInfo
        • 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: array (object | null)[] | null

          sonuç dizisi

          • check_url
            Tür: string | null

            arama motoru sonuçlarına doğrudan URL
            tam sonuçlar sağladığımızdan emin olmak için kullanabilirsiniz

          • datetime
            Tür: string | null

            sonucun alındığı tarih ve saat
            UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
            örnek:
            2019-11-15 12:57:46 +00:00

          • includes_non_news_search_results
            Tür: boolean | null

            yanıtın haber içeriğine ek olarak haber dışı arama sonuçları içerip içermediğini belirtir

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

            SERP'teki arama sonucu türleri
            SERP'te bulunan arama sonucu türlerini (items) içerir.
            olası öğe türleri:
            top_stories, news_search

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

            öğenin öğeleri

            • rank_absolute
              Tür: integer | null

              SERP'teki mutlak rank
              SERP'teki tüm öğeler arasındaki mutlak konum

            • rank_group
              Tür: integer | null

              SERP'teki grup sıralaması
              aynı type değerlerine sahip öğe grubundaki konum
              farklı type değerlerine sahip öğelerin konumları rank_group içinde yer almaz

            • rectangle
              Tür: object | null · Response36Afe1097B20_AiModeRectangleInfo

              dikdörtgen parametreleri
              sonuç snippet'inin SERP'teki kartezyen koordinatlarını ve piksel boyutlarını içerir
              POST isteğindeki calculate_rectangles true olarak ayarlanmamışsa null değerini alır

              • height
                Tür: number | null Biçim: double

                öğenin piksel cinsinden yüksekliği

              • width
                Tür: number | null Biçim: double

                öğenin piksel cinsinden genişliği

              • x
                Tür: number | null Biçim: double

                x ekseni koordinatı sonuç parçacığının sol üst köşesinin x ekseni koordinatı; başlangıç noktası ekranın sol üst köşesidir

              • y
                Tür: number | null Biçim: double

                y ekseni koordinatı sonuç parçacığının sol üst köşesinin y ekseni koordinatı; başlangıç noktası ekranın sol üst köşesidir

            • title
              Tür: string | null

              öğenin başlığı

            • type
              Tür: string | null

              öğe türü

            • xpath
              Tür: string | null

              öğenin XPath değeri

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

            items dizisinde döndürülen sonuç sayısı

          • keyword
            Tür: string | null

            POST dizisinde alınan anahtar kelime
            anahtar kelime, çözümlenmiş %## ile döndürülür ('+' artı karakteri boşluk karakterine çözümlenir)

          • language_code
            Tür: string | null

            POST dizisindeki dil kodu

          • location_code
            Tür: integer | null

            POST dizisindeki konum kodu

          • refinement_chips
            Tür: object | null · Response36Afe1097B20_RefinementChipsInfo

            arama iyileştirme çipleri

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

              öğenin bileşenleri

              • domain
                Tür: string | null

                SERP'teki alan adı

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

                daha fazla arama daraltma seçeneği

                • domain
                  Tür: string | null

                  SERP'teki alan adı

                • title
                  Tür: string | null

                  öğenin başlığı

                • type
                  Tür: string | null

                  öğe türü

                • url
                  Tür: string | null

                  daraltma parametreleri içeren arama URL'si

              • title
                Tür: string | null

                öğenin başlığı

              • type
                Tür: string | null

                öğe türü

              • url
                Tür: string | null

                daraltma parametreleri içeren arama URL'si

            • type
              Tür: string | null

              öğe türü

            • xpath
              Tür: string | null

              öğenin XPath değeri

          • se_domain
            Tür: string | null

            POST dizisindeki arama motoru alan adı

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

            SERP'teki toplam sonuç sayısı

          • spell
            Tür: object | null · Response36Afe1097B20_SpellInfo

            arama motorunun otomatik düzeltmesi
            arama motoru düzeltilmiş bir anahtar kelime için sonuç sunduysa, arama motorunun düzelttiği anahtar kelimeyi ve otomatik düzeltme türünü belirtiriz

            • keyword
              Tür: string | null

              arama motorunun otomatik düzeltmesi sonucunda elde edilen anahtar kelime sonuçlar düzeltilmiş anahtar kelime için sağlanır

            • type
              Tür: string | null

              otomatik düzeltme türü olası değerler: did_you_mean, showing_results_for, no_results_found_for, including_results_for not: Yahoo ve Yandex yalnızca şu otomatik düzeltme türünü destekler: including_results_for

          • type
            Tür: string | null

            öğe türü

        • 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/news/live/advanced
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/news/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "android"
  }
]'

{
  "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": [
        {
          "keyword": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "refinement_chips": {
            "type": null,
            "xpath": null,
            "items": [
              "[Max Depth Exceeded]"
            ]
          },
          "includes_non_news_search_results": null,
          "item_types": [
            null
          ],
          "se_results_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "xpath": null,
              "title": null,
              "rectangle": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Başarılı işlem

Live Google News SERP