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

Ringkasan Siri Masa Pautan Balik

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

DataForSEO

​

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

Ringkasan Siri Masa Pautan Balik

​

Metrik pautan balik teras satu target dari semasa ke semasa, dikumpulkan mengikut group_range (hari, minggu, bulan). Memulangkan date_from, date_to, group_range dan satu item bagi setiap tempoh. Untuk perolehan dan kehilangan dan bukan jumlah, gunakan post_dataforseo_backlinks_timeseries_new_lost_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,0273.
  • 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)[]
    • date_from
      Jenis: string | null

      tarikh mula julat masa
      medan pilihan
      medan ini menunjukkan tarikh yang akan digunakan sebagai ambang bagi data ringkasan;

      nilai minimum: 2019-01-30
      nilai maksimum tidak boleh melebihi tarikh yang ditetapkan dalam date_to
      format tarikh: "yyyy-mm-dd"
      contoh:
      "2021-01-01"

    • date_to
      Jenis: string | null

      tarikh tamat julat masa
      medan pilihan
      jika anda tidak menetapkan medan ini, tarikh hari ini akan digunakan secara lalai
      nilai minimum tidak boleh mendahului tarikh yang ditetapkan dalam date_from
      nilai maksimum: tarikh hari ini
      format tarikh: "yyyy-mm-dd"
      contoh:
      "2021-01-15"

    • group_range
      Jenis: string | null

      julat masa yang akan digunakan untuk mengumpulkan hasil
      medan pilihan
      nilai lalai: month
      nilai tersedia: day, week, month, year

      nota: untuk day, kami akan memulangkan item yang sepadan dengan semua tarikh antara dan termasuk date_from dan date_to;
      untuk week/month/year, kami akan memulangkan item yang sepadan dengan minggu/bulan/tahun penuh, di mana setiap item akan menunjukkan hari terakhir minggu/bulan/tahun tersebut

      contohnya, jika anda menetapkan:
      "group_range": "month",
      "date_from": "2022-03-23",
      "date_to": "2022-05-13"

      kami akan memulangkan item yang jatuh antara 2022-03-01 dan 2022-05-31, iaitu tiga item yang sepadan dengan tarikh berikut: 2022-03-31, 2022-04-30, 2022-05-31

      jika tiada data untuk day/week/month/year tertentu, kami akan memulangkan 0

    • include_subdomains
      Jenis: boolean | null

      menunjukkan sama ada subdomain bagi target akan disertakan dalam carian
      medan pilihan
      jika ditetapkan kepada false, subdomain akan diabaikan
      nilai lalai: true

    • 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

    • target
      Jenis: string

      domain untuk mendapatkan data
      medan wajib
      domain harus ditentukan tanpa https:// dan www.
      contoh:
      "forbes.com"

Respons
  • 200
    Jenis: object | null · Response36Afe1097B20_BacklinksTimeseriesSummaryLiveResponseInfo
    • 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_BacklinksTimeseriesSummaryLiveTaskInfo
        • 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

          • date_from
            Jenis: string | null

            tarikh mula julat masa
            dalam format UTC: “yyyy-mm-dd”
            contoh:
            2019-01-01

          • date_to
            Jenis: string | null

            tarikh tamat julat masa
            dalam format UTC: "yyyy-mm-dd"
            contoh:
            "2019-01-15"

          • group_range
            Jenis: string | null

            group_range daripada array POST

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

            mengandungi data ringkasan yang berkaitan

            • backlinks
              Jenis: integer | null Format: int64

              bilangan pautan balik bagi date yang diberikan

            • backlinks_nofollow
              Jenis: integer | null Format: int64

              bilangan pautan balik nofollow bagi date yang diberikan

            • date
              Jenis: string | null

              tarikh dan masa data bagi sasaran disimpan
              dalam format UTC: "yyyy-mm-dd hh-mm-ss +00:00"
              contoh:
              2019-11-15 12:57:46 +00:00

            • rank
              Jenis: integer | null

              kedudukan target bagi date yang diberikan
              ketahui lebih lanjut tentang metrik dan cara pengiraannya dalam artikel Pusat Bantuan ini

            • referring_domains
              Jenis: integer | null Format: int64

              bilangan domain perujuk bagi date yang diberikan
              domain perujuk merangkumi subdomain yang dikira sebagai domain berasingan untuk metrik ini

            • referring_domains_nofollow
              Jenis: integer | null Format: int64

              bilangan domain yang menunjuk sekurang-kurangnya satu pautan nofollow ke target bagi date yang diberikan

            • referring_ips
              Jenis: integer | null Format: int64

              bilangan alamat IP perujuk bagi date yang diberikan
              bilangan alamat IP yang menunjuk ke halaman ini

            • referring_main_domains
              Jenis: integer | null Format: int64

              bilangan domain utama perujuk bagi date yang diberikan

            • referring_main_domains_nofollow
              Jenis: integer | null Format: int64

              bilangan domain utama yang menunjuk sekurang-kurangnya satu pautan nofollow ke target bagi date yang diberikan

            • referring_pages
              Jenis: integer | null Format: int64

              bilangan halaman yang menunjuk ke target bagi date yang diberikan

            • referring_pages_nofollow
              Jenis: integer | null Format: int64

              bilangan halaman perujuk yang menunjuk sekurang-kurangnya satu pautan nofollow ke target bagi date yang diberikan

            • referring_subnets
              Jenis: integer | null Format: int64

              bilangan subrangkaian perujuk bagi date yang diberikan

            • type
              Jenis: string | null

              jenis elemen

          • items_count
            Jenis: integer | null Format: int64

            bilangan hasil yang dipulangkan dalam array items

          • target
            Jenis: string | null

            target daripada array POST

        • 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/timeseries_summary/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/timeseries_summary/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "date_from": "2021-12-01",
    "date_to": "2022-02-01",
    "group_range": "month"
  }
]'
{
  "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": [
        {
          "target": null,
          "date_from": null,
          "date_to": null,
          "group_range": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "date": null,
              "rank": null,
              "backlinks": null,
              "backlinks_nofollow": null,
              "referring_pages": null,
              "referring_pages_nofollow": null,
              "referring_domains": null,
              "referring_domains_nofollow": null,
              "referring_main_domains": null,
              "referring_main_domains_nofollow": null,
              "referring_ips": null,
              "referring_subnets": null
            }
          ]
        }
      ]
    }
  ]
}
Backlinks Timeseries Summary