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

Rangoverzicht per domein

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

Rangoverzicht per domein

​

De zoekvoetafdruk van een domein: aantallen organische en betaalde keywords, geschat verkeer en verkeerswaarde, per location_code. Retourneert se_type, target, total_count, items_count en items. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code; een geweigerd verzoek retourneert nog steeds HTTP 200. Voor dezelfde cijfers over tijd gebruik je post_dataforseo_labs_google_historical_rank_live; voor veel domeinen tegelijk post_dataforseo_labs_google_bulk_traffic_estimation_live.

Prijsreferentie

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

      sterk vergelijkbare keywords negeren
      optioneel veld
      bij true worden alle sterk vergelijkbare keywords uitgesloten van de ranking- en trafficberekeningen, de resultaten zijn gebaseerd op gegevens voor hoofdkeywords uit synoniemgroepen
      standaardwaarde: false

    • language_code
      Type: string | null

      taalcode
      optioneel veld
      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
      optioneel veld
      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

    • limit
      Type: integer | null

      het maximale aantal teruggegeven resultaten per domein
      optioneel veld
      standaardwaarde: 100
      maximale waarde: 1000

    • location_code
      Type: integer | null

      locatiecode
      optioneel veld
      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
      optioneel veld
      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

    • offset
      Type: integer | null

      offset in de resultatenarray van geretourneerde items
      optioneel veld
      standaardwaarde: 0
      als u de waarde 10 opgeeft, worden de eerste tien items in de resultatenarray overgeslagen en worden de gegevens voor de volgende items geleverd

    • 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_DataforseoLabsGoogleDomainRankOverviewLiveResponseInfo
    • 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_DataforseoLabsGoogleDomainRankOverviewLiveTaskInfo
        • 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 ranking- en verkeersgegevens

            • language_code
              Type: string | null

              taalcode in een POST-array

            • location_code
              Type: integer | null

              locatiecode in een POST-array

            • 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

            • se_type
              Type: string | null

              type zoekmachine

          • 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/domain_rank_overview/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/domain_rank_overview/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "language_name": "English",
    "location_code": 2840
  }
]'

{
  "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,
              "location_code": null,
              "language_code": null,
              "metrics": null
            }
          ]
        }
      ]
    }
  ]
}

Geslaagde bewerking

Domain Rank Overview