Felo API PlatformFelo API Platform
Všechny endpointy DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Hromadné pořadí

Server:https://openapi.felo.ai
Klientské knihovny

DataForSEO

​

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

Hromadné pořadí

​

Pořadí až tisíce targets v jednom volání – jeden řádek s target a rank. ⚠️ Hromadná rodina přijímá targets jako prosté pole, na rozdíl od průnikových endpointů, které je klíčují podle pozice. Vše, co je známo o jednom cíli, poskytne post_dataforseo_backlinks_summary_live. Tento endpoint nepřijímá parametr limitu, takže jedinou pákou je volat jej méně často.

Referenční ceny

  • Účtování: vykázaná cena odpovědi.
  • Referenční odhad ceny požadavku: USD 0.025.
  • Referenční multiplikátor zákazníka: 1.0. Znovu jej neaplikujte na již zúčtovanou částku zákazníka.

Pouze referenční metadata — nikoli nabídka pro účet, garantovaná cena ani limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.

Tělo
application/json
  • Typ: array (object | null)[]
    • rank_scale
      Typ: string | null

      určuje škálu používanou pro výpočet a zobrazení hodnot rank, domain_from_rank a page_from_rank
      volitelné pole

      tento parametr můžete použít k volbě, zda se hodnoty rank zobrazují na škále 0–100, nebo 0–1000

      možné hodnoty:
      one_hundred — hodnoty rank se zobrazují na škále 0–100
      one_thousand — hodnoty rank se zobrazují na škále 0–1000

      výchozí hodnota: one_thousand

      více o fungování tohoto parametru a výpočtu metrik hodnocení najdete v tomto článku nápovědy

    • tag
      Typ: string | null

      uživatelem definovaný identifikátor úlohy
      volitelné pole
      limit znaků je 255
      tento parametr můžete použít k identifikaci úlohy a jejímu spárování s výsledkem
      zadanou hodnotu tag najdete v objektu data odpovědi

    • targets
      Typ: array string[]

      domény, subdomény nebo webové stránky, pro které se má načíst rank
      povinné pole
      můžete zadat až 1000 domén, subdomén nebo webových stránek
      doménu nebo subdoménu je nutné zadat bez https:// a www.
      stránku je nutné zadat jako absolutní URL (včetně http:// nebo https://)
      příklad:
      "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>]

Odpovědi
  • 200
    Typ: object | null · Response36Afe1097B20_BacklinksBulkRanksLiveResponseInfo
    • cost
      Typ: number | null Formát: double

      celkové náklady na úlohy, USD

    • status_code
      Typ: integer | null

      obecný kód stavu úplný seznam kódů odpovědí najdete zde

    • status_message
      Typ: string | null

      obecná informační zpráva úplný seznam obecných informačních zpráv najdete zde

    • tasks
      Typ: array (object | null)[] | null

      pole úloh

      • Typ: object | null · Response36Afe1097B20_BacklinksBulkRanksLiveTaskInfo
        • cost
          Typ: number | null Formát: double

          celkové náklady na úlohy, USD

        • data
          Typ: object | null

          obsahuje stejné parametry, které jste zadali v požadavku POST

          • propertyName
            Typ: object | null
        • id
          Typ: string | null

          identifikátor úlohy jedinečný identifikátor úlohy v našem systému ve formátu UUID

        • path
          Typ: array (string | null)[] | null

          cesta URL

        • result
          Typ: array (object | null)[] | null

          pole výsledků

          • items
            Typ: array (object | null)[] | null

            obsahuje relevantní data o zpětných odkazech a odkazujících doménách

            • rank
              Typ: integer | null

              rank target
              hodnoty představují data v reálném čase k datu požadavku
              rank se počítá metodou hodnocení uzlů v propojené databázi – principem použitým v původním algoritmu Google PageRank
              více o metrice a jejím výpočtu najdete v tomto článku nápovědy

            • target
              Typ: string | null

              doména, subdoména nebo webová stránka z pole POST

          • items_count
            Typ: integer | null Formát: int64

            počet výsledků vrácených v poli items

        • result_count
          Typ: integer | null Formát: int64

          počet prvků v poli result

        • status_code
          Typ: integer | null

          stavový kód úlohy vygenerovaný DataForSEO; může být v následujícím rozsahu: 10000-60000 úplný seznam kódů odpovědí najdete zde

        • status_message
          Typ: string | null

          informační zpráva úlohy úplný seznam obecných informačních zpráv najdete zde

        • time
          Typ: string | null

          doba provedení, sekundy

    • tasks_count
      Typ: integer | null Formát: int64

      počet úloh v poli tasks

    • tasks_error
      Typ: integer | null Formát: int64

      počet úloh v poli tasks vrácených s chybou

    • time
      Typ: string | null

      celková doba provádění, sekundy

    • version
      Typ: string | null

      aktuální verze API

    application/json
  • 400

    Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.

  • 401

    Je vyžadován platný API klíč Felo.

  • 402

    V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.

  • 403

    Účet nemá oprávnění tuto operaci provést.

  • 429

    Byl dosažen limit požadavků nebo útraty.

  • 502

    Služba nemohla požadavek dokončit.

  • 503

    API nebo fakturační služba je dočasně nedostupná.

  • 504

    Při zpracování požadavku vypršel časový limit služby.

  • default

    Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele

    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