Felo API PlatformFelo API Platform
Semua endpoint DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Kedudukan Pukal

Pelayan:https://openapi.felo.ai
Pustaka Klien

DataForSEO

​

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

Kedudukan Pukal

​

Kedudukan sehingga seribu targets dalam satu panggilan - satu baris target dan rank. ⚠️ Keluarga pukal menerima targets sebagai array biasa, berbeza daripada endpoint persilangan yang mengunci mengikut kedudukan. Untuk semua yang diketahui tentang satu sasaran, gunakan post_dataforseo_backlinks_summary_live. Endpoint ini tidak mengambil parameter had, jadi satu-satunya tuas ialah memanggilnya dengan lebih jarang.

Rujukan harga

  • Pemeteran: kos respons yang dilaporkan.
  • Anggaran rujukan setiap permintaan: USD 0,025.
  • Pengganda rujukan pelanggan: 1,0. Jangan gunakannya semula pada amaun pelanggan yang telah diselesaikan.

Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.

Badan
application/json
  • Jenis: array (object | null)[]
    • rank_scale
      Jenis: string | null

      menentukan skala yang digunakan untuk mengira dan memaparkan nilai rank, domain_from_rank dan page_from_rank
      medan pilihan

      anda boleh menggunakan parameter ini untuk memilih sama ada nilai rank dipaparkan pada skala 0–100 atau 0–1000

      nilai tersedia:
      one_hundred — nilai rank dipaparkan pada skala 0–100
      one_thousand — nilai rank dipaparkan pada skala 0–1000

      nilai lalai: one_thousand

      ketahui lebih lanjut tentang cara parameter ini berfungsi dan cara metrik kedudukan dikira dalam artikel Pusat Bantuan ini

    • tag
      Jenis: string | null

      pengecam tugas yang ditentukan pengguna
      medan pilihan
      had aksara ialah 255
      anda boleh menggunakan parameter ini untuk mengenal pasti tugas dan memadankannya dengan hasil
      anda akan menemui nilai tag yang ditentukan dalam objek data respons

    • targets
      Jenis: array string[]

      domain, subdomain atau halaman web untuk mendapatkan rank
      medan wajib
      anda boleh menetapkan sehingga 1000 domain, subdomain atau halaman web
      domain atau subdomain harus ditentukan tanpa https:// dan www.
      halaman harus ditentukan dengan URL mutlak (termasuk http:// atau https://)
      contoh:
      "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>]

Respons
  • 200
    Jenis: object | null · Response36Afe1097B20_BacklinksBulkRanksLiveResponseInfo
    • cost
      Jenis: number | null Format: double

      jumlah kos tugas, USD

    • status_code
      Jenis: integer | null

      kod status umum; anda boleh menemui senarai penuh kod respons di sini

    • status_message
      Jenis: string | null

      mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini

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

      tatasusunan tugas

      • Jenis: object | null · Response36Afe1097B20_BacklinksBulkRanksLiveTaskInfo
        • cost
          Jenis: number | null Format: double

          jumlah kos tugas, USD

        • data
          Jenis: object | null

          mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST

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

          pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID

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

          Laluan URL

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

          tatasusunan hasil

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

            mengandungi data pautan balik dan domain perujuk yang berkaitan

            • rank
              Jenis: integer | null

              kedudukan target
              nilai mewakili data masa nyata bagi tarikh permintaan
              rank dikira berdasarkan kaedah kedudukan nod dalam pangkalan data berpaut - prinsip yang digunakan dalam algoritma Google PageRank asal
              ketahui lebih lanjut tentang metrik dan cara pengiraannya dalam artikel Pusat Bantuan ini

            • target
              Jenis: string | null

              domain, subdomain atau halaman web daripada array POST

          • items_count
            Jenis: integer | null Format: int64

            bilangan hasil yang dipulangkan dalam array items

        • result_count
          Jenis: integer | null Format: int64

          bilangan elemen dalam array hasil

        • status_code
          Jenis: integer | null

          kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini

        • status_message
          Jenis: string | null

          mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini

        • time
          Jenis: string | null

          masa pelaksanaan, saat

    • tasks_count
      Jenis: integer | null Format: int64

      bilangan tugas dalam array tasks

    • tasks_error
      Jenis: integer | null Format: int64

      bilangan tugas dalam array tasks yang dipulangkan dengan ralat

    • time
      Jenis: string | null

      jumlah masa pelaksanaan, saat

    • version
      Jenis: string | null

      versi semasa API

    application/json
  • 400

    Permintaan tidak dapat diproses. Semak parameter permintaan.

  • 401

    Kunci API Felo yang sah diperlukan.

  • 402

    Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.

  • 403

    Akaun tidak dibenarkan melakukan operasi ini.

  • 429

    Had permintaan atau had perbelanjaan telah dicapai.

  • 502

    Perkhidmatan tidak dapat menyelesaikan permintaan.

  • 503

    API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.

  • 504

    Perkhidmatan tamat masa semasa memproses permintaan.

  • default

    Respons ralat; respons passthrough huluan mungkin menggunakan format penyedia

    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