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

Historische verkeersschatting in bulk

Server:https://openapi.felo.ai
Clientbibliotheken

DataForSEO

​

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

Historische verkeersschatting in bulk

​

Geschat organisch verkeer voor veel domeinen op elk punt in de beschikbare historie – de tijdreeks achter post_dataforseo_labs_google_bulk_traffic_estimation_live. 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. ⚠️ De responsgrootte vermenigvuldigt domeinen met datums; houd beide lijsten kort. Beschikbare datums komen uit get_dataforseo_labs_google_available_history.

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)[]
    • date_from
      Type: string | null

      begindatum van de periode
      optioneel veld
      als u dit veld niet opgeeft, worden de gegevens voor de voorgaande 12 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 kernkeywords geretourneerd, alle sterk vergelijkbare keywords worden uitgesloten;
      standaardwaarde: false

    • item_types
      Type: array string[] | null

      resultaten per itemtype weergeven
      optioneel veld
      geeft het type zoekresultaten aan dat in de respons is opgenomen;
      Let op: als de array item_types itemtypen bevat die afwijken van organic, worden de resultaten geordend op het eerste itemtype in de array;
      mogelijke waarden:
      ["organic", "paid", "featured_snippet", "local_pack"]
      standaardwaarde:
      ["organic", "paid"]

    • language_code
      Type: string | null

      taalcode
      als u dit veld gebruikt, hoeft u language_name niet op te geven
      de lijst met beschikbare talen met language_code ontvangt u via een afzonderlijk verzoek aan
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      laat dit veld weg om resultaten voor alle beschikbare talen te krijgen
      voorbeeld:
      en

    • language_name
      Type: string | null

      volledige naam van de taal
      als u dit veld gebruikt, hoeft u language_code niet op te geven
      de lijst met beschikbare talen met language_name ontvangt u via een afzonderlijk verzoek aan
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      laat dit veld weg om resultaten voor alle beschikbare talen te krijgen
      voorbeeld:
      English

    • location_code
      Type: integer | null

      locatiecode
      als u dit veld gebruikt, hoeft u location_name niet op te geven
      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
      laat dit veld weg om resultaten voor alle beschikbare locaties te krijgen
      voorbeeld:
      2840

    • location_name
      Type: string | null

      volledige naam van de locatie
      als u dit veld gebruikt, hoeft u location_code niet op te geven
      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
      laat dit veld weg om resultaten voor alle beschikbare locaties te krijgen
      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

    • targets
      Type: array string[]

      doeldomeinen en subdomeinen
      verplicht veld
      in dit veld kunt u domeinen en subdomeinen opgeven;
      domeinen en subdomeinen geeft u op zonder https:// en www.;
      u kunt maximaal 1000 domeinen of subdomeinen opgeven

Responsen
  • 200
    Type: object | null · Response36Afe1097B20_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveResponseInfo
    • 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_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveTaskInfo
        • 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

            array van items met relevante gegevens voor verkeersschatting

            • metrics
              Type: object | null · Response36Afe1097B20_HistoricalMetricsBundleInfo

              verkeersgegevens voor het opgegeven domein

              • featured_snippet
                Type: array (object | null)[] | null

                verkeersgegevens uit de featured snippet-resultaten in de Google SERP

                • count
                  Type: integer | null Formaat: int64

                  totaal aantal organische SERP's dat het domein bevat

                • etv
                  Type: number | null

                  geschat verkeersvolume
                  geschat organisch maandelijks verkeer naar het domein
                  berekend als het product van CTR (klikfrequentie) en zoekvolume van alle keywords waarop het domein rankt
                  meer informatie over hoe de metriek wordt berekend vind je in dit artikel in het helpcentrum

                • month
                  Type: integer | null

                  maand waarvoor de gegevens worden geleverd

                • year
                  Type: integer | null

                  jaar waarvoor de gegevens worden geleverd

              • local_pack
                Type: array (object | null)[] | null

                verkeersgegevens uit de local pack-resultaten in SERP

                • count
                  Type: integer | null Formaat: int64

                  totaal aantal organische SERP's dat het domein bevat

                • etv
                  Type: number | null

                  geschat verkeersvolume
                  geschat organisch maandelijks verkeer naar het domein
                  berekend als het product van CTR (klikfrequentie) en zoekvolume van alle keywords waarop het domein rankt
                  meer informatie over hoe de metriek wordt berekend vind je in dit artikel in het helpcentrum

                • month
                  Type: integer | null

                  maand waarvoor de gegevens worden geleverd

                • year
                  Type: integer | null

                  jaar waarvoor de gegevens worden geleverd

              • organic
                Type: array (object | null)[] | null

                verkeersgegevens uit organisch zoeken

                • count
                  Type: integer | null Formaat: int64

                  totaal aantal organische SERP's dat het domein bevat

                • etv
                  Type: number | null

                  geschat verkeersvolume
                  geschat organisch maandelijks verkeer naar het domein
                  berekend als het product van CTR (klikfrequentie) en zoekvolume van alle keywords waarop het domein rankt
                  meer informatie over hoe de metriek wordt berekend vind je in dit artikel in het helpcentrum

                • month
                  Type: integer | null

                  maand waarvoor de gegevens worden geleverd

                • year
                  Type: integer | null

                  jaar waarvoor de gegevens worden geleverd

              • paid
                Type: array (object | null)[] | null

                verkeersgegevens uit betaald zoeken

                • count
                  Type: integer | null Formaat: int64

                  totaal aantal organische SERP's dat het domein bevat

                • etv
                  Type: number | null

                  geschat verkeersvolume
                  geschat organisch maandelijks verkeer naar het domein
                  berekend als het product van CTR (klikfrequentie) en zoekvolume van alle keywords waarop het domein rankt
                  meer informatie over hoe de metriek wordt berekend vind je in dit artikel in het helpcentrum

                • month
                  Type: integer | null

                  maand waarvoor de gegevens worden geleverd

                • year
                  Type: integer | null

                  jaar waarvoor de gegevens worden geleverd

            • se_type
              Type: string | null

              type zoekmachine

            • target
              Type: string | null

              doeldomein in een POST-array

          • 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
            als er geen gegevens zijn, is de waarde null

          • location_code
            Type: integer | null

            locatiecode in een POST-array
            als er geen gegevens zijn, is de waarde null

          • se_type
            Type: string | null

            type zoekmachine

          • 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_bulk_traffic_estimation/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/historical_bulk_traffic_estimation/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": [
      "dataforseo.com",
      "cnn.com",
      "forbes.com"
    ],
    "location_code": 2840,
    "language_code": "en",
    "date_from": "2021-01-01",
    "date_to": "2021-03-29",
    "item_types": [
      "organic",
      "paid"
    ]
  }
]'
{
  "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,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "target": null,
              "metrics": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}
Historical Bulk Traffic Estimation