Felo API PlatformFelo API Platform
Alle endpoints van DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Historisch rangoverzicht

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

Historisch rangoverzicht

​

Het rangoverzicht van een domein zoals het op elk punt in de beschikbare historie was. Dit endpoint heeft geen limit-parameter, maar wordt per aanroep in plaats van per item afgerekend; stuur daarom de hele lijst in één keer. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code; een geweigerd verzoek retourneert nog steeds HTTP 200. Controleer eerst get_dataforseo_labs_google_available_history – het noemt de datums die bestaan, en een datum daarbuiten levert niets in plaats van een fout. De huidige momentopname is post_dataforseo_labs_google_domain_rank_overview_live.

Prijsreferentie

  • Afrekening: gerapporteerde responskosten.
  • Referentieschatting per verzoek: USD 0.1356.
  • 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)[]
    • correlate
      Type: boolean | null

      gegevens correleren met eerder verkregen datasets
      optioneel veld
      standaardwaarde: true
      als u deze parameter gebruikt, correleert ons systeem de gegevens die u nu verkrijgt met eerder verkregen datasets
      deze parameter is bedoeld om inconsistenties te beperken die kunnen ontstaan door wijzigingen in onze database
      we raden aan correlate altijd op true te zetten

    • date_from
      Type: string | null

      begindatum van de periode
      optioneel veld
      als u dit veld niet opgeeft, worden de gegevens voor de voorgaande 6 maanden geleverd
      minimaal mogelijke waarde: 2020-10-01
      datumnotatie: "yyyy-mm-dd"

    • date_to
      Type: string | null

      einddatum van de periode
      optioneel veld
      als u dit veld niet opgeeft, wordt standaard de datum van vandaag gebruikt
      datumnotatie: "yyyy-mm-dd"
      voorbeeld:
      "2021-04-01"

    • ignore_synonyms
      Type: boolean | null

      sterk vergelijkbare keywords negeren
      optioneel veld
      bij true worden alleen gegevens op basis van kernkeywords geretourneerd, gegevens voor alle sterk vergelijkbare keywords worden uitgesloten;
      standaardwaarde: false

    • include_clickstream_data
      Type: boolean | null

      gegevens uit clickstream-gebaseerde metrieken in het resultaat opnemen of uitsluiten
      optioneel veld
      als de parameter op true is ingesteld, ontvangt u de velden clickstream_etv, clickstream_gender_distribution en clickstream_age_distribution met clickstream-gegevens in de respons;
      standaardwaarde: false;

      Let op: historische clickstream-gegevens zijn beschikbaar vanaf 2024/05 (mei 2024);
      als deze parameter is ingeschakeld, wordt het dubbele tarief voor het verzoek in rekening gebracht;
      meer informatie over de berekening van clickstream-gebaseerde metrieken vindt u in dit Help Center-artikel

    • language_code
      Type: string | null

      taalcode
      verplicht veld als u language_name niet opgeeft
      Let op: u moet language_name of language_code opgeven
      de lijst met beschikbare locaties met language_code ontvangt u via een afzonderlijk verzoek aan
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      voorbeeld:
      en

    • language_name
      Type: string

      volledige naam van de taal
      verplicht veld als u language_code niet opgeeft
      Let op: u moet language_name of language_code opgeven
      de lijst met beschikbare locaties met language_name ontvangt u via een afzonderlijk verzoek aan
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      voorbeeld:
      English

    • location_code
      Type: integer

      locatiecode
      verplicht veld als u location_name niet opgeeft
      Let op: u moet location_name of location_code opgeven
      de lijst met beschikbare locaties met location_code ontvangt u via een afzonderlijk verzoek aan
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      voorbeeld:
      2840

    • location_name
      Type: string

      volledige naam van de locatie
      verplicht veld als u location_code niet opgeeft
      Let op: u moet location_name of location_code opgeven
      de lijst met beschikbare locaties met location_name ontvangt u via een afzonderlijk verzoek aan
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      voorbeeld:
      United Kingdom

    • 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
      verplicht veld
      de domeinnaam van de doelwebsite
      het domein geeft u op zonder https:// en www.

Responsen
  • 200
    Type: object | null · Response36Afe1097B20_DataforseoLabsGoogleHistoricalRankOverviewLiveResponseInfo
    • 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_DataforseoLabsGoogleHistoricalRankOverviewLiveTaskInfo
        • 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 historische ranking- en verkeersgegevens

            • metrics
              Type: object | null

              rankinggegevens voor het opgegeven domein

              • propertyName
                Type: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
                • clickstream_age_distribution
                  Type: object | null

                  verdeling van op clickstream gebaseerde metrieken naar leeftijd
                  om resultaten voor dit veld op te halen, moet de parameter include_clickstream_data op true staan
                  lees meer over hoe de metriek wordt berekend in dit Help Center-artikel

                  • propertyName
                    Type: integer | null Formaat: int64

                    Signed 64-bit integers (long type).

                • clickstream_etv
                  Type: number | null Formaat: double

                  geschat verkeersvolume op basis van clickstreamgegevens
                  berekend als het product van de click-through-rate en de clickstream-zoekvolumewaarden van alle keywords waarop het domein rankt
                  om resultaten voor dit veld op te halen, moet de parameter include_clickstream_data op true staan
                  lees meer over hoe de metriek wordt berekend in dit Help Center-artikel

                • clickstream_gender_distribution
                  Type: object | null

                  verdeling van geschatte op clickstream gebaseerde metrieken naar geslacht
                  om resultaten voor dit veld op te halen, moet de parameter include_clickstream_data op true staan
                  lees meer over hoe de metriek wordt berekend in dit Help Center-artikel

                  • propertyName
                    Type: integer | null Formaat: int64

                    Signed 64-bit integers (long type).

                • count
                  Type: integer | null Formaat: int64

                  totaal aantal organische SERP's dat het domein of subdomein bevat

                • estimated_paid_traffic_cost
                  Type: number | null

                  geschatte kosten om organisch zoekverkeer om te zetten in betaald verkeer
                  geeft de geschatte maandelijkse kosten (USD) weer voor advertenties voor alle keywords in de categorie waarop het domein of subdomein rankt
                  de metriek wordt berekend als het product van de organische etv- en betaalde cpc-waarden en geeft de kosten aan om het geschatte maandelijkse organische verkeersvolume via PPC-advertenties in Google Zoeken te realiseren
                  lees meer over hoe de metriek wordt berekend in dit Help Center-artikel

                • etv
                  Type: number | null

                  geschat verkeersvolume
                  geschat organisch maandelijks verkeer naar het domein of subdomein
                  berekend als het product van CTR (click-through-rate) en zoekvolumewaarden van alle keywords in de categorie waarop het domein of subdomein rankt
                  lees meer over hoe de metriek wordt berekend in dit Help Center-artikel

                • is_down
                  Type: integer | null

                  rang gedaald
                  geeft aan hoeveel gerangschikte elementen van het opgegeven doel zijn gedaald

                • is_lost
                  Type: integer | null

                  verloren gerangschikte elementen
                  geeft aan hoeveel gerangschikte elementen van het opgegeven doel eerder in SERP's stonden, maar bij de laatste controle niet zijn gevonden

                • is_new
                  Type: integer | null

                  aantal nieuwe gerangschikte elementen
                  geeft aan hoeveel nieuwe gerangschikte elementen voor het opgegeven doel zijn gevonden

                • is_up
                  Type: integer | null

                  rang gestegen
                  geeft aan hoeveel gerangschikte elementen van het opgegeven doel zijn gestegen

                • pos_1
                  Type: integer | null

                  aantal organische SERP's waarin het domein of subdomein op #1 rankt

                • pos_11_20
                  Type: integer | null

                  aantal organische SERP's waarin het domein of subdomein op #11-20 rankt

                • pos_2_3
                  Type: integer | null

                  aantal organische SERP's waarin het domein of subdomein op #2-3 rankt

                • pos_21_30
                  Type: integer | null

                  aantal organische SERP's waarin het domein of subdomein op #21-30 rankt

                • pos_31_40
                  Type: integer | null

                  aantal organische SERP's waarin het domein of subdomein op #31-40 rankt

                • pos_4_10
                  Type: integer | null

                  aantal organische SERP's waarin het domein of subdomein op #4-10 rankt

                • pos_41_50
                  Type: integer | null

                  aantal organische SERP's waarin het domein of subdomein op #41-50 rankt

                • pos_51_60
                  Type: integer | null

                  aantal organische SERP's waarin het domein of subdomein op #51-60 rankt

                • pos_61_70
                  Type: integer | null

                  aantal organische SERP's waarin het domein of subdomein op #61-70 rankt

                • pos_71_80
                  Type: integer | null

                  aantal organische SERP's waarin het domein of subdomein op #71-80 rankt

                • pos_81_90
                  Type: integer | null

                  aantal organische SERP's waarin het domein of subdomein op #81-90 rankt

                • pos_91_100
                  Type: integer | null

                  aantal organische SERP's waarin het domein of subdomein op #91-100 rankt

            • month
              Type: integer | null

              maand waarvoor de gegevens worden geleverd

            • se_type
              Type: string | null

              type zoekmachine

            • year
              Type: integer | null

              jaar waarvoor de gegevens worden geleverd

          • items_count
            Type: integer | null Formaat: int64

            het aantal resultaten dat in de array items wordt geretourneerd

          • language_code
            Type: string | null

            taalcode in een POST-array

          • location_code
            Type: integer | null

            locatiecode in een POST-array

          • se_type
            Type: string | null

            type zoekmachine

          • target
            Type: string | null

            doeldomein in een POST-array

          • total_count
            Type: integer | null Formaat: int64

            totaal aantal resultaten in onze database dat relevant is voor uw 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
Request Example for post/v1/beta/dataforseo/dataforseo_labs/google/historical_rank_overview/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/historical_rank_overview/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "location_code": 2840,
    "language_code": "en",
    "date_from": "2021-01-01",
    "date_to": "2021-03-29"
  }
]'

{
  "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": [
        {
          "se_type": null,
          "target": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "year": null,
              "month": null,
              "metrics": null
            }
          ]
        }
      ]
    }
  ]
}

Geslaagde bewerking

Historical Rank Overview