Felo API PlatformFelo API Platform
Alle endpoints van DataForSEO
v0.2.0-beta
OpenAPI 3.1.0
Server:https://openapi.felo.ai
Clientbibliotheken

DataForSEO

​

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

Bulk: rangen

​

De rang van tot duizend targets in één aanroep: één rij met target en rank. ⚠️ De bulkfamilie verwacht targets als een gewone array, anders dan de intersection-endpoints, die hun doelen op positie adresseren. Voor alles wat over één doel bekend is, gebruik je post_dataforseo_backlinks_summary_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.025.
  • 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)[]
    • 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: array string[]

      domeinen, subdomeinen of webpagina's waarvoor rank wordt opgehaald
      verplicht veld
      u kunt maximaal 1000 domeinen, subdomeinen of webpagina's opgeven
      het domein of subdomein geeft u op zonder https:// en www.
      de pagina geeft u op als absolute URL (inclusief http:// of https://)
      voorbeeld:
      "targets": [<br> "forbes.com",<br> "cnn.com",<br> "bbc.com",<br> "yelp.com",<br> "https://www.apple.com/iphone/",<br> "https://ahrefs.com/blog/",<br> "ibm.com",<br> "https://variety.com/",<br> "https://stackoverflow.com/",<br> "www.trustpilot.com"<br>]

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

            • rank
              Type: integer | null

              rang van het target
              de waarden zijn realtimegegevens voor de datum van het verzoek
              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

            • target
              Type: string | null

              domein, subdomein of webpagina uit een POST-array

          • items_count
            Type: integer | null Formaat: int64

            het aantal resultaten dat in de array items wordt geretourneerd

        • 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/backlinks/bulk_ranks/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/bulk_ranks/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": [
      "forbes.com",
      "cnn.com",
      "bbc.com",
      "yelp.com",
      "https://www.apple.com/iphone/",
      "https://ahrefs.com/blog/",
      "ibm.com",
      "https://variety.com/",
      "https://stackoverflow.com/",
      "www.trustpilot.com"
    ]
  }
]'
{
  "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": [
        {
          "items_count": null,
          "items": [
            {
              "target": null,
              "rank": null
            }
          ]
        }
      ]
    }
  ]
}
Bulk Ranks