v0.2.0-beta

OpenAPI 3.1.0

Pagina-intersectie

Felo API Support

MIT

Server

https://openapi.felo.ai

Clientbibliotheken

Shell Curl

DataForSEO

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

DataForSEO Operaties

post/v1/beta/dataforseo/backlinks/page_intersection/live

Pagina-intersectie

De pagina's die naar meerdere doel-URL's tegelijk linken, in plaats van de domeinen. ⚠️ targets is een object met posities als sleutel en verwacht volledige URL's, geen kale domeinen. Elke rij bevat page_intersection en een summary per doel. Het domeinniveau-equivalent is post_dataforseo_backlinks_domain_intersection_live, waarnaar je eerst moet grijpen.

Prijsreferentie

Afrekening: gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.033.
Referentiemultiplier voor klanten: 1.0. Niet opnieuw toepassen op een al afgerekend klantbedrag.

Alleen referentiemetadata, geen accountofferte en geen gegarandeerde prijs of bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.

Body

application/json

Type: array (object | null)[]
- backlinks_status_type
 Type: string | null
 
 bepaalt welke backlinks worden teruggegeven en geteld
 optioneel veld
 met dit veld kiest u welke backlinks worden teruggegeven en gebruikt voor geaggregeerde statistieken van uw targets;
 mogelijke waarden:
 all - alle backlinks worden teruggegeven en geteld;
 live - backlinks die bij de laatste controle zijn gevonden, worden teruggegeven en geteld;
 lost - verloren backlinks worden teruggegeven en geteld;
 
 standaardwaarde: live
- exclude_internal_backlinks
 Type: boolean | null
 
 geeft aan of interne backlinks van subdomeinen naar het target uit de resultaten worden uitgesloten
 optioneel veld
 bij true bevatten de resultaten geen gegevens over interne backlinks van subdomeinen van hetzelfde domein als target
 bij false worden interne links in het resultaat opgenomen
 standaardwaarde: true
- exclude_targets
 Type: array string[] | null
 
 domeinen, subdomeinen of webpagina's die u wilt uitsluiten
 optioneel veld
 u kunt maximaal 10 domeinen, subdomeinen of webpagina's opgeven
 als u deze array gebruikt, bevatten de resultaten de verwijzende pagina's die naar targets linken maar niet naar exclude_targets
 voorbeeld:
 "exclude_targets": [ "bbc.com", "https://www.apple.com/iphone/*", "https://dataforseo.com/apis/*"]
- filters
 Type: array (object | null)[] | null
 
 array met filterparameters voor resultaten
 optioneel veld
 u kunt meerdere filters tegelijk toevoegen (maximaal 8 filters)
 tussen de voorwaarden zet u een logische operator and of or
 de volgende operators worden ondersteund:
 regex, not_regex, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
 met de operator % in like en not_like kunt u elke tekenreeks van nul of meer tekens matchen
 voorbeeld:
 ["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%"]]]
 
 de volledige lijst met mogelijke filters vindt u hier.
 
 Leeg object
- include_indirect_links
 Type: boolean | null
 
 geeft aan of indirecte links naar de targets in de resultaten worden opgenomen
 optioneel veld
 bij true bevatten de resultaten gegevens over indirecte links die verwijzen naar een pagina die doorverwijst naar een doel of naar een canonieke pagina wijst
 bij false worden indirecte links genegeerd
 standaardwaarde: true
- include_subdomains
 Type: boolean | null
 
 geeft aan of de subdomeinen van de targets in de zoekopdracht worden opgenomen
 optioneel veld
 bij false worden subdomeinen genegeerd
 standaardwaarde: true
- internal_list_limit
 Type: integer | null
 
 maximaal aantal elementen in interne arrays
 optioneel veld
 met dit veld beperkt u het aantal elementen in de volgende arrays:
 attributes
 domain_from_platform_type
 
 standaardwaarde: 10
 maximale waarde: 1000
- intersection_mode
 Type: string | null
 
 geeft aan of backlinks moeten worden geïntersticeerd
 optioneel veld
 gebruik dit veld om resultaten voor de opgegeven URL's te doorsnijden of samen te voegen
 mogelijke waarden: all, partial
 all - resultaten zijn gebaseerd op alle backlinks;
 partial - resultaten zijn alleen gebaseerd op de overlappende backlinks;
 standaardwaarde: all
- limit
 Type: integer | null
 
 het maximale aantal teruggegeven backlinks
 optioneel veld
 
 standaardwaarde: 100
 maximale waarde: 1000
- offset
 Type: integer | null
 
 offset in de resultatenarray van de teruggegeven backlinks
 optioneel veld
 
 standaardwaarde: 0
 bij de waarde 10 worden de eerste tien backlinks in de resultatenarray overgeslagen en worden de gegevens voor de volgende backlinks geleverd
- order_by
 Type: array string[] | null
 
 sorteerregels voor resultaten
 optioneel veld
 u kunt dezelfde waarden als in de array filters gebruiken om de resultaten te sorteren
 mogelijke sorteertypen:
 asc - resultaten worden oplopend gesorteerd
 desc - resultaten worden aflopend gesorteerd
 sorteertype en -richting scheidt u met een komma
 voorbeeld:
 ["rank,desc"]
 let op: u kunt per verzoek maximaal drie sorteerregels instellen
 meerdere sorteerregels scheidt u met een komma
 voorbeeld:
 ["domain_from_rank,desc","page_from_rank,asc"]
- rank_scale
 Type: string | null
 
 bepaalt de schaal die wordt gebruikt voor het berekenen en weergeven van de waarden rank, domain_from_rank en page_from_rank
 optioneel veld
 
 met deze parameter kiest u of rangwaarden op een schaal van 0–100 of 0–1000 worden weergegeven
 
 mogelijke waarden:
 one_hundred — rangwaarden worden weergegeven op een schaal van 0–100
 one_thousand — rangwaarden worden weergegeven op een schaal van 0–1000
 
 standaardwaarde: one_thousand
 
 lees meer over hoe deze parameter werkt en hoe rangmeters worden berekend in dit Help Center-artikel
- tag
 Type: string | null
 
 door gebruiker gedefinieerde taak-ID
 optioneel veld
 de tekenslimiet is 255
 je kunt deze parameter gebruiken om de taak te identificeren en aan het resultaat te koppelen
 de opgegeven waarde tag vind je in het data-object van de respons
- targets
 Type: object | null
 
 domeinen, subdomeinen of webpagina's waarvoor links worden opgehaald
 verplicht veld
 u kunt maximaal 20 domeinen, subdomeinen of webpagina's opgeven
 een domein of subdomein geeft u op zonder https:// en www.
 een pagina geeft u op als absolute URL (inclusief http:// of https://)
 voorbeeld:
 "targets": { "1": "http://planet.postgresql.org/", "2": "http://gborg.postgresql.org/" }
 
 propertyName
 Type: string | null

Responsen

200
Type: object | null · Response36Afe1097B20_BacklinksPageIntersectionLiveResponseInfo
cost
Type: number | null Formaat: double

Totale kosten van taken, USD

status_code
Type: integer | null

algemene statuscode de volledige lijst met responscodes vindt u hier

status_message
Type: string | null

algemeen informatief bericht de volledige lijst met algemene informatieve berichten vindt u hier

tasks
Type: array (object | null)[] | null

array van taken

Type: object | null · Response36Afe1097B20_BacklinksPageIntersectionLiveTaskInfo
cost
Type: number | null Formaat: double

Totale kosten van taken, USD

data
Type: object | null

Bevat dezelfde parameters die je in het POST-verzoek hebt opgegeven

propertyName
Type: object | null
id
Type: string | null

taak-id eenduidige taak-id in ons systeem in UUID-indeling

path
Type: array (string | null)[] | null

URL-pad

result
Type: array (object | null)[] | null

array van resultaten

items
Type: array (object | null)[] | null

bevat relevante gegevens over backlinks en verwijzende domeinen

page_intersection
Type: object | null

bevat gegevens over pagina's die linken naar de bijbehorende doelen die in de POST-array zijn opgegeven
de gegevens worden geleverd in afzonderlijke objecten die overeenkomen met de pagina's die in het object targets zijn opgegeven

propertyName
Type: array (object | null)[] | null
alt
Type: string | null

alternatieve tekst van de afbeelding
dit veld is null als het type van de backlink niet image is

anchor
Type: string | null

ankertekst van de backlink

attributes
Type: array (string | null)[] | null

linkattributen van de verwijzende links
voorbeeld:
nofollow

backlink_spam_score
Type: integer | null

spamscore van de backlink
lees meer over hoe deze metriek wordt berekend op deze Help Center-pagina

dofollow
Type: boolean | null

geeft aan of de backlink dofollow is
als false, is de backlink nofollow

domain_from
Type: string | null

domein dat verwijst naar het doeldomein of de doelwebpagina

domain_from_country
Type: string | null

ISO-landcode van het verwijzende domein

domain_from_ip
Type: string | null

IP-adres van het verwijzende domein

domain_from_is_ip
Type: boolean | null

geeft aan of het domein een IP is
als true, fungeert het domein als IP-adres en heeft het geen domeinnaam

domain_from_platform_type
Type: array (string | null)[] | null

platformtypen van het verwijzende domein

mogelijke waarden: cms, blogs, ecommerce, message-boards, wikis, news, organization

domain_from_rank
Type: integer | null

domeinrang van het verwijzende domein
geeft de rang van het domein aan op het moment dat onze crawler de backlink voor het laatst zag;
domain_from_rank wordt berekend met de methode voor noderanking in een gekoppelde database – een principe uit het oorspronkelijke Google PageRank-algoritme
lees meer over deze metriek en hoe deze wordt berekend in dit Help Center-artikel

domain_to
Type: string | null

domein waarnaar de backlink verwijst

first_seen
Type: string | null

datum en tijd waarop onze crawler de backlink voor het eerst heeft gevonden
in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2019-11-15 12:57:46 +00:00

group_count
Type: integer | null Formaat: int64

geeft het totale aantal backlinks van dit domein aan
als mode bijvoorbeeld op one_per_domain is ingesteld, geeft dit veld het totale aantal backlinks aan dat van dit domein afkomstig is

indirect_link_path
Type: array (object | null)[] | null

pad van de indirecte link
geeft een URL of een reeks URL's aan die naar url_to leiden

status_code
Type: integer | null

algemene statuscode
de volledige lijst met responscodes vindt u hier
Let op: we raden sterk aan een geschikt systeem te ontwerpen voor het afhandelen van gerelateerde uitzonderings- en foutsituaties

type
Type: string | null

elementtype

url
Type: string | null

URL van de indirecte link

is_broken
Type: boolean | null

geeft aan of de backlink kapot is
als true, verwijst de backlink naar een pagina die met statuscode 4xx of 5xx antwoordt

is_indirect_link
Type: boolean | null

geeft aan of de backlink een indirecte link is
als true, is de backlink een indirecte link die verwijst naar een pagina die doorverwijst naar url_to of naar een canonieke pagina verwijst

is_lost
Type: boolean | null

geeft aan of de backlink is verwijderd
als true, zijn de backlink of de hele pagina verwijderd

is_new
Type: boolean | null

geeft aan of de backlink nieuw is
als true, is de backlink gevonden op de pagina tijdens het laatste bezoek van onze crawler

item_type
Type: string | null

linktype
mogelijke waarden:
anchor, image, link, meta, canonical, alternate, redirect

last_seen
Type: string | null

meest recente datum waarop onze crawler de backlink heeft bezocht
in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2019-11-15 12:57:46 +00:00

links_count
Type: integer | null Formaat: int64

aantal identieke backlinks op de verwijzende pagina

original
Type: boolean | null

geeft aan of de backlink aanwezig was op de verwijzende pagina bij het eerste bezoek van onze crawler

page_from_encoding
Type: string | null

tekencodering van de verwijzende pagina
voorbeeld:
utf-8

page_from_external_links
Type: integer | null

aantal externe links op de verwijzende pagina

page_from_internal_links
Type: integer | null

aantal interne links op de verwijzende pagina

page_from_language
Type: string | null

taal van de verwijzende pagina
in ISO 639-1-formaat
voorbeeld:
en

page_from_rank
Type: integer | null

paginarrang van de verwijzende pagina
page_from_rank wordt berekend met de methode voor noderanking in een gekoppelde database – een principe uit het oorspronkelijke Google PageRank-algoritme
lees meer over deze metriek en hoe deze wordt berekend in dit Help Center-artikel

page_from_size
Type: integer | null

grootte van de verwijzende pagina, in bytes
voorbeeld:
63357

page_from_status_code
Type: integer | null

HTTP-statuscode geretourneerd door de verwijzende pagina
voorbeeld:
200

page_from_title
Type: string | null

titel van de verwijzende pagina

prev_seen
Type: string | null

vóór de meest recente datum waarop onze crawler de backlink heeft bezocht
in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2019-11-15 12:57:46 +00:00

rank
Type: integer | null

backlinkrang
rank wordt berekend met de methode voor noderanking in een gekoppelde database – een principe uit het oorspronkelijke Google PageRank-algoritme
lees meer over deze metriek en hoe deze wordt berekend in dit Help Center-artikel

semantic_location
Type: string | null

geeft het semantische HTML-element aan waarin de backlink is gevonden
de volledige lijst met semantische elementen vindt u hier
voorbeelden:
article, section, summary

text_post
Type: string | null

snippet na de ankertekst

text_pre
Type: string | null

tekstsnippet vóór de ankertekst

tld_from
Type: string | null

topleveldomein van de verwijzende URL

type
Type: string | null

elementtype

url_from
Type: string | null

URL van de pagina waarop de backlink is gevonden

url_from_https
Type: boolean | null

geeft aan of de verwijzende URL met HTTPS is beveiligd
als true, is de verwijzende URL met HTTPS beveiligd

url_to
Type: string | null

URL waarnaar de backlink verwijst

url_to_https
Type: boolean | null

geeft aan of de URL waarnaar de backlink verwijst met HTTPS is beveiligd
als true, is de URL met HTTPS beveiligd

url_to_redirect_target
Type: string | null

doel-URL van de redirect
doelpagina waarnaar de redirect verwijst

url_to_spam_score
Type: integer | null

spamscore van de pagina waarnaar wordt verwezen
als de waarde null is, heeft onze crawler de webpagina waarnaar de link verwijst nog niet bezocht
lees meer over hoe deze metriek wordt berekend op deze Help Center-pagina

url_to_status_code
Type: integer | null

statuscode van de pagina waarnaar wordt verwezen
als de waarde null is, heeft onze crawler de webpagina waarnaar de link verwijst nog niet bezocht
voorbeeld:
200

summary
Type: object | null · Response36Afe1097B20_IntersectionSummaryInfo

bevat de samenvatting van de pagina-intersecties

intersections_count
Type: integer | null Formaat: int64

totaal aantal overlappingen

items_count
Type: integer | null Formaat: int64

het aantal resultaten dat in de array items wordt geretourneerd

targets
Type: object | null

targets uit een POST-array

propertyName
Type: string | null
total_count
Type: integer | null Formaat: int64

totaal aantal resultaten dat relevant is voor het verzoek

result_count
Type: integer | null Formaat: int64

Aantal elementen in de result-array

status_code
Type: integer | null

statuscode van de taak gegenereerd door DataForSEO, kan binnen het volgende bereik liggen: 10000-60000 de volledige lijst met responscodes vindt u hier

status_message
Type: string | null

informatief bericht van de taak de volledige lijst met algemene informatieve berichten vindt u hier

time
Type: string | null

Uitvoeringstijd in seconden

tasks_count
Type: integer | null Formaat: int64

Het aantal taken in de tasks-array

tasks_error
Type: integer | null Formaat: int64

Het aantal taken in de tasks-array dat met een fout is geretourneerd

time
Type: string | null

totale uitvoeringstijd, seconden

version
Type: string | null

De huidige versie van de API
application/json
400

Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.
401

Een geldige Felo-API-sleutel is vereist.
402

Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.
403

Het account mag deze bewerking niet uitvoeren.
429

Een verzoek- of bestedingslimiet is bereikt.
502

De dienst kon het verzoek niet voltooien.
503

De API of factureringsdienst is tijdelijk niet beschikbaar.
504

Er is een time-out opgetreden bij het verwerken van het verzoek.
default

Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken

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
      ]
    ]
  }
]'

Schema tonen

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

Geslaagde bewerking

Pagina-intersectie

AuthenticatieRequired

DataForSEO

Pagina-intersectie

Prijsreferentie