v0.2.0-beta

OpenAPI 3.1.0

Sayfa kesişimi

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/backlinks/page_intersection/live

Sayfa kesişimi

Alan adları yerine aynı anda birkaç hedef URL'ye bağlantı veren sayfalar. ⚠️ targets bir konuma göre anahtarlanmış nesnedir ve çıplak alan adları değil tam URL'ler alır. Her satır page_intersection ve hedef başına bir summary taşır. Alan adı düzeyindeki eşdeğeri post_dataforseo_backlinks_domain_intersection_live olup ilk başvurulacak olan odur.

Fiyatlandırma referansı

Ölçümlendirme: bildirilen yanıt maliyeti.
Referans istek maliyeti tahmini: USD 0.033.
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)[]
- backlinks_status_type
 Tür: string | null
 
 hangi geri bağlantıların döndürüleceğini ve sayılacağını belirler
 isteğe bağlı alan
 bu alanı, targets hedefleriniz için toplu metriklerde hangi geri bağlantıların döndürüleceğini ve kullanılacağını seçmek için kullanabilirsiniz;
 olası değerler:
 all — tüm geri bağlantılar döndürülür ve sayılır;
 live — son kontrolde bulunan geri bağlantılar döndürülür ve sayılır;
 lost — kayıp geri bağlantılar döndürülür ve sayılır;
 
 varsayılan değer: live
- exclude_internal_backlinks
 Tür: boolean | null
 
 target hedefine alt alan adlarından gelen dahili geri bağlantıların sonuçlardan hariç tutulup tutulmayacağını belirtir
 isteğe bağlı alan
 true olarak ayarlanırsa sonuçlar, target ile aynı alan adının alt alan adlarından gelen dahili geri bağlantılara ilişkin verileri içermez
 false olarak ayarlanırsa dahili bağlantılar sonuca dahil edilir
 varsayılan değer: true
- exclude_targets
 Tür: array string[] | null
 
 hariç tutmak istediğiniz alan adları, alt alan adları veya web sayfaları
 isteğe bağlı alan
 en fazla 10 alan adı, alt alan adı veya web sayfası belirtebilirsiniz
 bu diziyi kullanırsanız sonuçlar targets hedeflerine bağlantı veren ancak exclude_targets hedeflerine bağlantı vermeyen yönlendiren sayfaları içerir
 örnek:
 "exclude_targets": [ "bbc.com", "https://www.apple.com/iphone/*", "https://dataforseo.com/apis/*"]
- filters
 Tü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ında and, or mantı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ü like ve not_like ile kullanabilirsiniz
 örnek:
 ["1.rank",">","80"]
 
 [["2.page_from_rank",">","55"], "and", ["1.original","=","true"]]
 
 [["1.first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["1.acnhor","like","%seo%"],"or",["1.text_pre","not_like","%seo%"]]]
 
 Olası filtrelerin tam listesi burada mevcuttur.
 
 Boş nesne
- include_indirect_links
 Tür: boolean | null
 
 targets hedeflerine giden dolaylı bağlantıların sonuçlara dahil edilip edilmeyeceğini belirtir
 isteğe bağlı alan
 true olarak ayarlanırsa sonuçlar, hedefe yönlendiren veya kurallı bir sayfaya işaret eden bir sayfaya giden dolaylı bağlantılara ilişkin verileri içerir
 false olarak ayarlanırsa dolaylı bağlantılar yok sayılır
 varsayılan değer: true
- include_subdomains
 Tür: boolean | null
 
 targets hedeflerinin alt alan adlarının aramaya dahil edilip edilmeyeceğini belirtir
 isteğe bağlı alan
 false olarak ayarlanırsa alt alan adları yok sayılır
 varsayılan değer: true
- internal_list_limit
 Tür: integer | null
 
 dahili dizilerdeki maksimum öğe sayısı
 isteğe bağlı alan
 bu alanı aşağıdaki dizilerdeki öğe sayısını sınırlamak için kullanabilirsiniz:
 attributes
 domain_from_platform_type
 
 varsayılan değer: 10
 maksimum değer: 1000
- intersection_mode
 Tür: string | null
 
 geri bağlantıların kesiştirilip kesiştirilmeyeceğini belirtir
 isteğe bağlı alan
 bu alanı belirtilen URL'ler için sonuçları kesiştirmek veya birleştirmek için kullanın
 olası değerler: all, partial
 all — sonuçlar tüm geri bağlantılara dayanır;
 partial — sonuçlar yalnızca kesişen geri bağlantılara dayanır;
 varsayılan değer: all
- limit
 Tür: integer | null
 
 döndürülen maksimum geri bağlantı sayısı
 isteğe bağlı alan
 
 varsayılan değer: 100
 maksimum değer: 1000
- offset
 Tür: integer | null
 
 döndürülen geri bağlantıların sonuç dizisindeki kaydırma değeri
 isteğe bağlı alan
 
 varsayılan değer: 0
 10 değerini belirtirseniz sonuç dizisindeki ilk on geri bağlantı atlanır ve veriler sonraki geri bağlantılar için sağlanır
- order_by
 Tür: array string[] | null
 
 sonuç sıralama kuralları
 isteğe bağlı alan
 sonuçları sıralamak için filters dizisindeki aynı değerleri kullanabilirsiniz
 olası sıralama türleri:
 asc — sonuçlar artan düzende sıralanır
 desc — sonuçlar azalan düzende sıralanır
 bir sıralama türü ayarlamak için virgül kullanmalısınız
 örnek:
 ["rank,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:
 ["domain_from_rank,desc","page_from_rank,asc"]
- rank_scale
 Tür: string | null
 
 rank, domain_from_rank ve page_from_rank değerlerinin hesaplanmasında ve görüntülenmesinde kullanılan ölçeği tanımlar
 isteğe bağlı alan
 
 bu parametreyi, rank değerlerinin 0–100 mü yoksa 0–1000 ölçeğinde mi sunulacağını seçmek için kullanabilirsiniz
 
 olası değerler:
 one_hundred — rank değerleri 0–100 ölçeğinde gösterilir
 one_thousand — rank değerleri 0–1000 ölçeğinde gösterilir
 
 varsayılan değer: one_thousand
 
 bu parametrenin nasıl çalıştığı ve sıralama metriklerinin nasıl hesaplandığı hakkında daha fazla bilgiyi bu Yardım Merkezi makalesinde bulabilirsiniz
- 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
 belirtilen tag değerini yanıtın data nesnesinde bulacaksınız
- targets
 Tür: object | null
 
 bağlantıların alınacağı alan adları, alt alan adları veya web sayfaları
 zorunlu alan
 en fazla 20 alan adı, alt alan adı veya web sayfası belirtebilirsiniz
 alan adı veya alt alan adı https:// ve www. olmadan belirtilmelidir
 sayfa, mutlak URL olarak (http:// veya https:// dahil) belirtilmelidir
 örnek:
 "targets": { "1": "http://planet.postgresql.org/", "2": "http://gborg.postgresql.org/" }
 
 propertyName
 Tür: string | null

Yanıtlar

200
Tür: object | null · Response36Afe1097B20_BacklinksPageIntersectionLiveResponseInfo
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_BacklinksPageIntersectionLiveTaskInfo
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

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

ilgili geri bağlantı ve yönlendiren alan adı verilerini içerir

page_intersection
Tür: object | null

POST dizisinde belirtilen ilgili hedeflere bağlantı veren sayfalara ilişkin verileri içerir
veriler, targets nesnesinde belirtilen sayfalara karşılık gelen ayrı nesneler halinde sunulur

propertyName
Tür: array (object | null)[] | null
alt
Tür: string | null

görselin alternatif metni
geri bağlantı type değeri image değilse bu alan null olur

anchor
Tür: string | null

geri bağlantının bağlantı metni

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

yönlendiren bağlantıların bağlantı nitelikleri
örnek:
nofollow

backlink_spam_score
Tür: integer | null

geri bağlantının spam puanı
metriğin nasıl hesaplandığı hakkında daha fazla bilgi için bu yardım merkezi sayfasına bakın

dofollow
Tür: boolean | null

geri bağlantının dofollow olup olmadığını belirtir
false ise geri bağlantı nofollow'dur

domain_from
Tür: string | null

hedef alan adına veya web sayfasına yönlendiren alan adı

domain_from_country
Tür: string | null

yönlendiren alan adının ISO ülke kodu

domain_from_ip
Tür: string | null

yönlendiren alan adının IP adresi

domain_from_is_ip
Tür: boolean | null

alan adının IP olup olmadığını belirtir
true ise alan adı bir IP adresi olarak çalışır ve alan adı yoktur

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

yönlendiren alan adının platform türleri

olası değerler: cms, blogs, ecommerce, message-boards, wikis, news, organization

domain_from_rank
Tür: integer | null

yönlendiren alan adının alan adı rank değeri
crawler'ımızın geri bağlantıyı son gördüğü anda alan adının rank değerini belirtir;
domain_from_rank, bağlantılı bir veritabanındaki düğüm sıralama yöntemine göre hesaplanır — orijinal Google PageRank algoritmasında kullanılan ilke budur
metrik ve hesaplanması hakkında daha fazla bilgi için bu yardım merkezi makalesine bakın

domain_to
Tür: string | null

geri bağlantının işaret ettiği alan adı

first_seen
Tür: string | null

crawler'ımızın geri bağlantıyı ilk kez bulduğu tarih ve saat
UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
örnek:
2019-11-15 12:57:46 +00:00

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

bu alan adından gelen toplam geri bağlantı sayısını belirtir
örneğin mode one_per_domain olarak ayarlanmışsa bu alan, bu alan adından gelen toplam geri bağlantı sayısını gösterir

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

dolaylı bağlantı yolu
url_to adresine götüren bir URL veya URL dizisini belirtir

status_code
Tür: integer | null

genel durum kodu
yanıt kodlarının tam listesini burada bulabilirsiniz
Not: ilgili istisna veya hata durumlarını işlemek için gerekli bir sistem tasarlamanızı kesinlikle öneririz

type
Tür: string | null

öğe türü

url
Tür: string | null

dolaylı bağlantı URL'si

is_broken
Tür: boolean | null

geri bağlantının kırık olup olmadığını belirtir
true ise geri bağlantı 4xx veya 5xx durum koduyla yanıt veren bir sayfaya işaret eder

is_indirect_link
Tür: boolean | null

geri bağlantının dolaylı bağlantı olup olmadığını belirtir
true ise geri bağlantı, url_to adresine yönlendiren veya kanonik bir sayfaya işaret eden bir sayfaya yönelen dolaylı bağlantıdır

is_lost
Tür: boolean | null

geri bağlantının kaldırılıp kaldırılmadığını belirtir
true ise geri bağlantı veya sayfanın tamamı kaldırılmıştır

is_new
Tür: boolean | null

geri bağlantının yeni olup olmadığını belirtir
true ise geri bağlantı, crawler'ımızın sayfayı son ziyaretinde bulunmuştur

item_type
Tür: string | null

bağlantı türü
olası değerler:
anchor, image, link, meta, canonical, alternate, redirect

last_seen
Tür: string | null

crawler'ımızın geri bağlantıyı ziyaret ettiği en son tarih
UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
örnek:
2019-11-15 12:57:46 +00:00

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

yönlendiren sayfada bulunan aynı geri bağlantı sayısı

original
Tür: boolean | null

crawler'ımız sayfayı ilk ziyaret ettiğinde geri bağlantının yönlendiren sayfada bulunup bulunmadığını belirtir

page_from_encoding
Tür: string | null

yönlendiren sayfanın karakter kodlaması
örnek:
utf-8

page_from_external_links
Tür: integer | null

yönlendiren sayfada bulunan harici bağlantı sayısı

page_from_internal_links
Tür: integer | null

yönlendiren sayfada bulunan dahili bağlantı sayısı

page_from_language
Tür: string | null

yönlendiren sayfanın dili
ISO 639-1 biçiminde
örnek:
en

page_from_rank
Tür: integer | null

yönlendiren sayfanın rank değeri
page_from_rank, bağlantılı bir veritabanındaki düğüm sıralama yöntemine göre hesaplanır — orijinal Google PageRank algoritmasında kullanılan ilke budur
metrik ve hesaplanması hakkında daha fazla bilgi için bu yardım merkezi makalesine bakın

page_from_size
Tür: integer | null

yönlendiren sayfanın boyutu, bayt cinsinden
örnek:
63357

page_from_status_code
Tür: integer | null

yönlendiren sayfanın döndürdüğü HTTP durum kodu
örnek:
200

page_from_title
Tür: string | null

yönlendiren sayfanın başlığı

prev_seen
Tür: string | null

crawler'ımızın geri bağlantıyı ziyaret ettiği en son tarihten önceki tarih
UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
örnek:
2019-11-15 12:57:46 +00:00

rank
Tür: integer | null

geri bağlantı rank değeri
rank, bağlantılı bir veritabanındaki düğüm sıralama yöntemine göre hesaplanır — orijinal Google PageRank algoritmasında kullanılan ilke budur
metrik ve hesaplanması hakkında daha fazla bilgi için bu yardım merkezi makalesine bakın

semantic_location
Tür: string | null

geri bağlantının bulunduğu HTML anlamsal öğesini belirtir
anlamsal öğelerin tam listesine buradan ulaşabilirsiniz
örnekler:
article, section, summary

text_post
Tür: string | null

bağlantı metninden sonraki snippet

text_pre
Tür: string | null

bağlantı metninden önceki metin snippet'i

tld_from
Tür: string | null

yönlendiren URL'nin üst düzey alan adı

type
Tür: string | null

öğe türü

url_from
Tür: string | null

geri bağlantının bulunduğu sayfanın URL'si

url_from_https
Tür: boolean | null

yönlendiren URL'nin HTTPS ile korunup korunmadığını belirtir
true ise yönlendiren URL HTTPS ile korunur

url_to
Tür: string | null

geri bağlantının işaret ettiği URL

url_to_https
Tür: boolean | null

geri bağlantının işaret ettiği URL'nin HTTPS ile korunup korunmadığını belirtir
true ise URL HTTPS ile korunur

url_to_redirect_target
Tür: string | null

yönlendirmenin hedef URL'si
yönlendirmenin işaret ettiği hedef sayfa

url_to_spam_score
Tür: integer | null

işaret edilen sayfanın spam puanı
değer null ise crawler'ımız bağlantının işaret ettiği web sayfasını henüz ziyaret etmemiştir
metriğin nasıl hesaplandığı hakkında daha fazla bilgi için bu yardım merkezi sayfasına bakın

url_to_status_code
Tür: integer | null

işaret edilen sayfanın durum kodu
değer null ise crawler'ımız bağlantının işaret ettiği web sayfasını henüz ziyaret etmemiştir
örnek:
200

summary
Tür: object | null · Response36Afe1097B20_IntersectionSummaryInfo

sayfa kesişimleri özetini içerir

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

toplam kesişim sayısı

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

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

targets
Tür: object | null

POST dizisindeki targets

propertyName
Tür: string | null
total_count
Tür: integer | null Biçim: int64

istekle ilgili toplam sonuç sayısı

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/backlinks/page_intersection/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/page_intersection/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": {
      "1": "football.com",
      "2": "fifa.com"
    },
    "exclude_targets": [
      "skysports.com"
    ],
    "limit": 5,
    "order_by": [
      "1.rank,desc"
    ],
    "filters": [
      [
        "2.domain_from_rank",
        ">",
        400
      ],
      "and",
      [
        "1.dofollow",
        "=",
        true
      ]
    ]
  }
]'

Ş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": [
        {
          "targets": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "page_intersection": null,
              "summary": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Başarılı işlem

Sayfa kesişimi

Kimlik doğrulamaRequired

DataForSEO

Sayfa kesişimi

Fiyatlandırma referansı