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

Ikhtisar Peringkat Historis

Felo API Support
MIT
Server:https://openapi.felo.ai
Pustaka Klien
Shell Curl

DataForSEO

​

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

DataForSEO Operasi

Ikhtisar Peringkat Historis

​

Ikhtisar peringkat sebuah domain sebagaimana adanya pada setiap titik dalam riwayat yang tersedia. Endpoint ini tidak menerima parameter batas, tetapi ditagih per panggilan, bukan per item, jadi kirim seluruh daftar sekaligus. Dibungkus dalam envelope DataForSEO: data ada di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Periksa get_dataforseo_labs_google_available_history terlebih dahulu - ini menyebutkan tanggal yang ada, dan meminta tanggal di luarnya tidak mengembalikan apa pun, bukan kesalahan. Snapshot saat ini adalah post_dataforseo_labs_google_domain_rank_overview_live.

Referensi harga

  • Pengukuran: biaya respons yang dilaporkan.
  • Perkiraan referensi per permintaan: USD 0,1356.
  • Pengali referensi pelanggan: 1,0. Jangan menerapkannya lagi pada jumlah tagihan pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukan kredit Felo. Biaya akhir mengikuti catatan penagihan Felo.

Isi
application/json
  • Tipe: array (object | null)[]
    • correlate
      Tipe: boolean | null

      mengorelasikan data dengan kumpulan data yang diperoleh sebelumnya
      field opsional
      nilai default: true
      jika Anda menggunakan parameter ini, sistem kami akan mengorelasikan data yang Anda peroleh sekarang dengan kumpulan data yang diperoleh sebelumnya
      parameter ini dimaksudkan untuk mengurangi inkonsistensi yang mungkin timbul akibat perubahan pada basis data kami
      kami menyarankan untuk selalu menyetel correlate ke true

    • date_from
      Tipe: string | null

      tanggal mulai rentang waktu
      field opsional
      jika Anda tidak menentukan field ini, data akan disediakan untuk 6 bulan sebelumnya
      nilai minimum yang mungkin: 2020-10-01
      format tanggal: "yyyy-mm-dd"

    • date_to
      Tipe: string | null

      tanggal akhir rentang waktu
      field opsional
      jika Anda tidak menentukan field ini, tanggal hari ini akan digunakan secara default
      format tanggal: "yyyy-mm-dd"
      contoh:
      "2021-04-01"

    • ignore_synonyms
      Tipe: boolean | null

      abaikan kata kunci yang sangat mirip
      field opsional
      jika disetel ke true, hanya data berdasarkan kata kunci inti yang akan dikembalikan, data untuk semua kata kunci yang sangat mirip akan dikecualikan;
      nilai default: false

    • include_clickstream_data
      Tipe: boolean | null

      menyertakan atau mengecualikan data dari metrik berbasis clickstream dalam hasil
      field opsional
      jika parameter disetel ke true, Anda akan menerima field clickstream_etv, clickstream_gender_distribution, dan clickstream_age_distribution beserta data clickstream dalam respons;
      nilai default: false;

      Catatan: data clickstream historis tersedia sejak 2024/05 (Mei 2024);
      dengan parameter ini diaktifkan, Anda akan dikenakan biaya dua kali lipat untuk permintaan tersebut;
      pelajari lebih lanjut tentang cara metrik berbasis clickstream dihitung di artikel pusat bantuan ini

    • language_code
      Tipe: string | null

      kode bahasa
      field wajib jika Anda tidak menentukan language_name
      Catatan: Anda harus menentukan language_name atau language_code
      Anda dapat memperoleh daftar lokasi yang tersedia beserta language_code-nya dengan membuat permintaan terpisah ke
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      contoh:
      en

    • language_name
      Tipe: string

      nama lengkap bahasa
      field wajib jika Anda tidak menentukan language_code
      Catatan: Anda harus menentukan language_name atau language_code
      Anda dapat memperoleh daftar lokasi yang tersedia beserta language_name-nya dengan membuat permintaan terpisah ke
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      contoh:
      English

    • location_code
      Tipe: integer

      kode lokasi
      field wajib jika Anda tidak menentukan location_name
      Catatan: Anda harus menentukan location_name atau location_code
      Anda dapat memperoleh daftar lokasi yang tersedia beserta location_code-nya dengan membuat permintaan terpisah ke
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      contoh:
      2840

    • location_name
      Tipe: string

      nama lengkap lokasi
      field wajib jika Anda tidak menentukan location_code
      Catatan: Anda harus menentukan location_name atau location_code
      Anda dapat memperoleh daftar lokasi yang tersedia beserta location_name-nya dengan membuat permintaan terpisah ke
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      contoh:
      United Kingdom

    • tag
      Tipe: string | null

      pengenal tugas yang ditentukan pengguna
      field opsional
      batas karakter adalah 255
      Anda dapat menggunakan parameter ini untuk mengidentifikasi tugas dan mencocokkannya dengan hasil
      Anda akan menemukan nilai tag yang ditentukan di objek data pada respons

    • target
      Tipe: string

      domain
      field wajib
      nama domain situs web target
      domain harus ditentukan tanpa https:// dan www.

Respons
  • 200
    Tipe: object | null · Response36Afe1097B20_DataforseoLabsGoogleHistoricalRankOverviewLiveResponseInfo
    • cost
      Tipe: number | null Format: double

      total biaya tugas, USD

    • status_code
      Tipe: integer | null

      kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini

    • status_message
      Tipe: string | null

      pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

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

      array tugas

      • Tipe: object | null · Response36Afe1097B20_DataforseoLabsGoogleHistoricalRankOverviewLiveTaskInfo
        • cost
          Tipe: number | null Format: double

          total biaya tugas, USD

        • data
          Tipe: object | null

          berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST

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

          pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID

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

          Jalur URL

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

          array hasil

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

            berisi data peringkat dan trafik historis

            • metrics
              Tipe: object | null

              data peringkat yang relevan dengan domain yang ditentukan

              • propertyName
                Tipe: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
                • clickstream_age_distribution
                  Tipe: object | null

                  distribusi metrik berbasis clickstream menurut usia
                  untuk mengambil hasil untuk field ini, parameter include_clickstream_data harus diatur ke true
                  pelajari lebih lanjut cara metrik dihitung di artikel pusat bantuan ini

                  • propertyName
                    Tipe: integer | null Format: int64

                    Signed 64-bit integers (long type).

                • clickstream_etv
                  Tipe: number | null Format: double

                  volume trafik perkiraan berdasarkan data clickstream
                  dihitung sebagai produk dari click-through-rate dan nilai volume pencarian clickstream dari semua kata kunci yang diperingkatkan domain
                  untuk mengambil hasil untuk field ini, parameter include_clickstream_data harus diatur ke true
                  pelajari lebih lanjut cara metrik dihitung di artikel pusat bantuan ini

                • clickstream_gender_distribution
                  Tipe: object | null

                  distribusi metrik berbasis clickstream perkiraan menurut gender
                  untuk mengambil hasil untuk field ini, parameter include_clickstream_data harus diatur ke true
                  pelajari lebih lanjut cara metrik dihitung di artikel pusat bantuan ini

                  • propertyName
                    Tipe: integer | null Format: int64

                    Signed 64-bit integers (long type).

                • count
                  Tipe: integer | null Format: int64

                  jumlah total SERP organik yang berisi domain atau subdomain

                • estimated_paid_traffic_cost
                  Tipe: number | null

                  perkiraan biaya mengubah trafik pencarian organik menjadi berbayar
                  mewakili perkiraan biaya bulanan (USD) untuk menjalankan iklan bagi semua kata kunci dalam kategori yang diperingkatkan domain atau subdomain
                  metrik dihitung sebagai produk dari nilai etv organik dan cpc berbayar dan menunjukkan biaya mendorong volume trafik organik bulanan perkiraan melalui iklan PPC di Google Search
                  pelajari lebih lanjut cara metrik dihitung di artikel pusat bantuan ini

                • etv
                  Tipe: number | null

                  volume trafik perkiraan
                  perkiraan trafik organik bulanan ke domain atau subdomain
                  dihitung sebagai produk dari CTR (click-through-rate) dan nilai volume pencarian semua kata kunci dalam kategori yang diperingkatkan domain atau subdomain
                  pelajari lebih lanjut cara metrik dihitung di artikel pusat bantuan ini

                • is_down
                  Tipe: integer | null

                  peringkat turun
                  menunjukkan berapa banyak elemen berperingkat dari target yang ditentukan yang turun

                • is_lost
                  Tipe: integer | null

                  elemen berperingkat yang hilang
                  menunjukkan berapa banyak elemen berperingkat dari target yang ditentukan yang sebelumnya muncul di SERP, tetapi tidak ditemukan selama pemeriksaan terakhir

                • is_new
                  Tipe: integer | null

                  jumlah elemen berperingkat baru
                  menunjukkan berapa banyak elemen berperingkat baru yang ditemukan untuk target yang ditentukan

                • is_up
                  Tipe: integer | null

                  peringkat naik
                  menunjukkan berapa banyak elemen berperingkat dari target yang ditentukan yang naik

                • pos_1
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #1

                • pos_11_20
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #11-20

                • pos_2_3
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #2-3

                • pos_21_30
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #21-30

                • pos_31_40
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #31-40

                • pos_4_10
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #4-10

                • pos_41_50
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #41-50

                • pos_51_60
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #51-60

                • pos_61_70
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #61-70

                • pos_71_80
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #71-80

                • pos_81_90
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #81-90

                • pos_91_100
                  Tipe: integer | null

                  jumlah SERP organik tempat domain atau subdomain berada di peringkat #91-100

            • month
              Tipe: integer | null

              bulan data disediakan

            • se_type
              Tipe: string | null

              jenis mesin pencari

            • year
              Tipe: integer | null

              tahun data disediakan

          • items_count
            Tipe: integer | null Format: int64

            jumlah hasil yang dikembalikan dalam array items

          • language_code
            Tipe: string | null

            kode bahasa dalam array POST

          • location_code
            Tipe: integer | null

            kode lokasi dalam array POST

          • se_type
            Tipe: string | null

            jenis mesin pencari

          • target
            Tipe: string | null

            domain target dalam array POST

          • total_count
            Tipe: integer | null Format: int64

            jumlah total hasil di basis data kami yang relevan dengan permintaan Anda

        • result_count
          Tipe: integer | null Format: int64

          jumlah elemen dalam array hasil

        • status_code
          Tipe: integer | null

          kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini

        • status_message
          Tipe: string | null

          pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

        • time
          Tipe: string | null

          waktu eksekusi, detik

    • tasks_count
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks

    • tasks_error
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks yang dikembalikan dengan error

    • time
      Tipe: string | null

      total waktu eksekusi, detik

    • version
      Tipe: string | null

      versi API saat ini

    application/json
  • 400

    Permintaan tidak dapat diproses. Periksa parameter permintaan.

  • 401

    Kunci API Felo yang valid diperlukan.

  • 402

    Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.

  • 403

    Akun tidak diizinkan melakukan operasi ini.

  • 429

    Batas permintaan atau batas pengeluaran telah tercapai.

  • 502

    Layanan tidak dapat menyelesaikan permintaan.

  • 503

    API atau layanan penagihan untuk sementara tidak tersedia.

  • 504

    Layanan kehabisan waktu saat memproses permintaan.

  • default

    Respons error; respons passthrough upstream dapat menggunakan format penyedia

    application/json
Request Example for post/v1/beta/dataforseo/dataforseo_labs/google/historical_rank_overview/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/historical_rank_overview/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "location_code": 2840,
    "language_code": "en",
    "date_from": "2021-01-01",
    "date_to": "2021-03-29"
  }
]'

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

Operasi berhasil

Historical Rank Overview