v0.2.0-beta

OpenAPI 3.1.0

Backlinktijdreeks

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/timeseries_summary/live

Backlinktijdreeks

De kernbacklinkstatistieken van één target in de tijd, gegroepeerd op group_range (dag, week, maand). Retourneert date_from, date_to, group_range en één item per periode. Voor winst en verlies in plaats van totalen gebruik je post_dataforseo_backlinks_timeseries_new_lost_live. Dit endpoint heeft geen limit-parameter, dus de enige knop is het minder vaak aanroepen.

Prijsreferentie

Afrekening: gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.0273.
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)[]
- date_from
  Type: string | null
  
  begindatum van de periode
  optioneel veld
  dit veld bepaalt de datum die als drempel voor samenvattingsgegevens wordt gebruikt;
  
  minimale waarde: 2019-01-30
  de maximale waarde mag niet later zijn dan de datum in date_to
  datumnotatie: "yyyy-mm-dd"
  voorbeeld:
  "2021-01-01"
- date_to
  Type: string | null
  
  einddatum van de periode
  optioneel veld
  als u dit veld niet opgeeft, wordt standaard de datum van vandaag gebruikt
  de minimale waarde mag niet eerder zijn dan de datum in date_from
  maximale waarde: de datum van vandaag
  datumnotatie: "yyyy-mm-dd"
  voorbeeld:
  "2021-01-15"
- group_range
  Type: string | null
  
  tijdsbereik waarmee de resultaten worden gegroepeerd
  optioneel veld
  standaardwaarde: month
  mogelijke waarden: day, week, month, year
  
  let op: voor day retourneren we items voor alle datums tussen en inclusief date_from en date_to;
  voor week/month/year retourneren we items voor volledige weken/maanden/jaren, waarbij elk item de laatste dag van de week/maand/het jaar aangeeft
  
  als u bijvoorbeeld opgeeft:
  "group_range": "month", "date_from": "2022-03-23", "date_to": "2022-05-13"
  retourneren we items tussen 2022-03-01 en 2022-05-31, namelijk drie items voor de volgende datums: 2022-03-31, 2022-04-30, 2022-05-31
  
  als er geen gegevens zijn voor een bepaalde day/week/month/year, retourneren we 0
- include_subdomains
  Type: boolean | null
  
  geeft aan of de subdomeinen van het target in de zoekopdracht worden opgenomen
  optioneel veld
  bij false worden subdomeinen genegeerd
  standaardwaarde: true
- 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
- target
  Type: string
  
  domein waarvoor gegevens worden opgehaald
  verplicht veld
  een domein geeft u op zonder https:// en www.
  voorbeeld:
  "forbes.com"

Responsen

200
Type: object | null · Response36Afe1097B20_BacklinksTimeseriesSummaryLiveResponseInfo
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_BacklinksTimeseriesSummaryLiveTaskInfo
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

date_from
Type: string | null

startdatum van de periode
in UTC-formaat: “yyyy-mm-dd”
voorbeeld:
2019-01-01

date_to
Type: string | null

einddatum van de periode
in UTC-formaat: "yyyy-mm-dd"
voorbeeld:
"2019-01-15"

group_range
Type: string | null

group_range uit een POST-array

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

bevat relevante samenvattingsgegevens

backlinks
Type: integer | null Formaat: int64

aantal backlinks voor de opgegeven date

backlinks_nofollow
Type: integer | null Formaat: int64

aantal nofollow-backlinks voor de opgegeven date

date
Type: string | null

datum en tijd waarop de gegevens voor het doel zijn opgeslagen
in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2019-11-15 12:57:46 +00:00

rank
Type: integer | null

target-rang voor de opgegeven date
lees meer over deze metriek en hoe deze wordt berekend in dit Help Center-artikel

referring_domains
Type: integer | null Formaat: int64

aantal verwijzende domeinen voor de opgegeven date
verwijzende domeinen omvatten subdomeinen, die voor deze metriek als afzonderlijke domeinen worden geteld

referring_domains_nofollow
Type: integer | null Formaat: int64

aantal domeinen dat minstens één nofollow-link naar het target voor de opgegeven date laat wijzen

referring_ips
Type: integer | null Formaat: int64

aantal verwijzende IP-adressen voor de opgegeven date
aantal IP-adressen dat naar deze pagina verwijst

referring_main_domains
Type: integer | null Formaat: int64

aantal verwijzende hoofddomeinen voor de opgegeven date

referring_main_domains_nofollow
Type: integer | null Formaat: int64

aantal hoofddomeinen dat minstens één nofollow-link naar het target voor de opgegeven date laat wijzen

referring_pages
Type: integer | null Formaat: int64

aantal pagina's dat naar target voor de opgegeven date verwijst

referring_pages_nofollow
Type: integer | null Formaat: int64

aantal verwijzende pagina's dat minstens één nofollow-link naar het target voor de opgegeven date laat wijzen

referring_subnets
Type: integer | null Formaat: int64

aantal verwijzende subnetten voor de opgegeven date

type
Type: string | null

elementtype

items_count
Type: integer | null Formaat: int64

het aantal resultaten dat in de array items wordt geretourneerd

target
Type: string | null

target uit een POST-array

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/timeseries_summary/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/timeseries_summary/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "date_from": "2021-12-01",
    "date_to": "2022-02-01",
    "group_range": "month"
  }
]'

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": [
        {
          "target": null,
          "date_from": null,
          "date_to": null,
          "group_range": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "date": null,
              "rank": null,
              "backlinks": null,
              "backlinks_nofollow": null,
              "referring_pages": null,
              "referring_pages_nofollow": null,
              "referring_domains": null,
              "referring_domains_nofollow": null,
              "referring_main_domains": null,
              "referring_main_domains_nofollow": null,
              "referring_ips": null,
              "referring_subnets": null
            }
          ]
        }
      ]
    }
  ]
}

Geslaagde bewerking

Backlinktijdreeks

AuthenticatieRequired

DataForSEO

Backlinktijdreeks

Prijsreferentie