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

Gambaran Keseluruhan Kedudukan Sejarah

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

DataForSEO

​

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

DataForSEO Operasi

Gambaran Keseluruhan Kedudukan Sejarah

​

Gambaran keseluruhan kedudukan sesuatu domain sebagaimana adanya pada setiap titik dalam sejarah tersedia. Endpoint ini tiada parameter had, tetapi dicaj setiap panggilan dan bukan setiap item, jadi hantar keseluruhan senarai sekali gus. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak masih memulangkan HTTP 200. Semak get_dataforseo_labs_google_available_history terlebih dahulu - ia menamakan tarikh yang wujud, dan meminta tarikh di luarnya tidak memulangkan apa-apa, bukan ralat. Snapshot semasa ialah post_dataforseo_labs_google_domain_rank_overview_live.

Rujukan harga

  • Pemeteran: kos respons yang dilaporkan.
  • Anggaran rujukan setiap permintaan: USD 0,1356.
  • 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)[]
    • correlate
      Jenis: boolean | null

      mengaitkan data dengan set data yang diperoleh sebelum ini
      medan pilihan
      nilai lalai: true
      jika anda menggunakan parameter ini, sistem kami akan mengaitkan data yang anda peroleh sekarang dengan set data yang diperoleh sebelum ini
      parameter ini bertujuan untuk mengurangkan sebarang ketidakselarasan yang mungkin timbul daripada perubahan pada pangkalan data kami
      kami mengesyorkan agar sentiasa menetapkan correlate kepada true

    • date_from
      Jenis: string | null

      tarikh mula julat masa
      medan pilihan
      jika anda tidak menentukan medan ini, data akan disediakan untuk 6 bulan sebelumnya
      nilai minimum yang mungkin: 2020-10-01
      format tarikh: "yyyy-mm-dd"

    • date_to
      Jenis: string | null

      tarikh tamat julat masa
      medan pilihan
      jika anda tidak menentukan medan ini, tarikh hari ini akan digunakan secara lalai
      format tarikh: "yyyy-mm-dd"
      contoh:
      "2021-04-01"

    • ignore_synonyms
      Jenis: boolean | null

      abaikan kata kunci yang sangat serupa
      medan pilihan
      jika ditetapkan kepada true, hanya data berdasarkan kata kunci teras akan dipulangkan, data untuk semua kata kunci yang sangat serupa akan dikecualikan;
      nilai lalai: false

    • include_clickstream_data
      Jenis: boolean | null

      sertakan atau kecualikan data daripada metrik berasaskan clickstream dalam hasil
      medan pilihan
      jika parameter ditetapkan kepada true, anda akan menerima medan clickstream_etv, clickstream_gender_distribution dan clickstream_age_distribution dengan data clickstream dalam respons;
      nilai lalai: false;

      Nota: data clickstream sejarah tersedia mulai 2024/05 (Mei 2024);
      dengan parameter ini didayakan, anda akan dikenakan caj dua kali ganda untuk permintaan tersebut;
      ketahui lebih lanjut tentang cara metrik berasaskan clickstream dikira dalam artikel pusat bantuan ini

    • language_code
      Jenis: string | null

      kod bahasa
      medan wajib jika anda tidak menentukan language_name
      Nota: anda perlu menentukan language_name atau language_code
      anda boleh mendapatkan senarai lokasi tersedia bersama language_code masing-masing dengan membuat permintaan berasingan ke
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      contoh:
      en

    • language_name
      Jenis: string

      nama penuh bahasa
      medan wajib jika anda tidak menentukan language_code
      Nota: anda perlu menentukan language_name atau language_code
      anda boleh mendapatkan senarai lokasi tersedia bersama language_name masing-masing dengan membuat permintaan berasingan ke
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      contoh:
      English

    • location_code
      Jenis: integer

      kod lokasi
      medan wajib jika anda tidak menentukan location_name
      Nota: anda perlu menentukan location_name atau location_code
      anda boleh mendapatkan senarai lokasi tersedia bersama location_code masing-masing dengan membuat permintaan berasingan ke
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      contoh:
      2840

    • location_name
      Jenis: string

      nama penuh lokasi
      medan wajib jika anda tidak menentukan location_code
      Nota: anda perlu menentukan location_name atau location_code
      anda boleh mendapatkan senarai lokasi tersedia bersama location_name masing-masing dengan membuat permintaan berasingan ke
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      contoh:
      United Kingdom

    • 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
      medan wajib
      nama domain laman web sasaran
      domain harus ditentukan tanpa https:// dan www.

Respons
  • 200
    Jenis: object | null · Response36Afe1097B20_DataforseoLabsGoogleHistoricalRankOverviewLiveResponseInfo
    • 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_DataforseoLabsGoogleHistoricalRankOverviewLiveTaskInfo
        • 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 kedudukan dan trafik sejarah

            • metrics
              Jenis: object | null

              data kedudukan yang berkaitan dengan domain yang ditentukan

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

                  taburan metrik berasaskan clickstream mengikut umur
                  untuk mendapatkan hasil bagi medan ini, parameter include_clickstream_data mesti ditetapkan kepada true
                  ketahui lebih lanjut cara metrik dikira dalam artikel pusat bantuan ini

                  • propertyName
                    Jenis: integer | null Format: int64

                    Signed 64-bit integers (long type).

                • clickstream_etv
                  Jenis: number | null Format: double

                  anggaran volum trafik berdasarkan data clickstream
                  dikira sebagai hasil darab click-through-rate dan nilai volum carian clickstream semua kata kunci yang diduduki domain
                  untuk mendapatkan hasil bagi medan ini, parameter include_clickstream_data mesti ditetapkan kepada true
                  ketahui lebih lanjut cara metrik dikira dalam artikel pusat bantuan ini

                • clickstream_gender_distribution
                  Jenis: object | null

                  taburan anggaran metrik berasaskan clickstream mengikut jantina
                  untuk mendapatkan hasil bagi medan ini, parameter include_clickstream_data mesti ditetapkan kepada true
                  ketahui lebih lanjut cara metrik dikira dalam artikel pusat bantuan ini

                  • propertyName
                    Jenis: integer | null Format: int64

                    Signed 64-bit integers (long type).

                • count
                  Jenis: integer | null Format: int64

                  jumlah keseluruhan SERP organik yang mengandungi domain atau subdomain

                • estimated_paid_traffic_cost
                  Jenis: number | null

                  anggaran kos menukar trafik carian organik kepada berbayar
                  mewakili anggaran kos bulanan (USD) untuk menjalankan iklan bagi semua kata kunci dalam kategori yang diduduki domain atau subdomain
                  metrik dikira sebagai hasil darab nilai etv organik dan cpc berbayar dan menunjukkan kos memacu anggaran volum trafik organik bulanan melalui pengiklanan PPC dalam Google Search
                  ketahui lebih lanjut cara metrik dikira dalam artikel pusat bantuan ini

                • etv
                  Jenis: number | null

                  anggaran volum trafik
                  anggaran trafik organik bulanan ke domain atau subdomain
                  dikira sebagai hasil darab CTR (click-through-rate) dan nilai volum carian semua kata kunci dalam kategori yang diduduki domain atau subdomain
                  ketahui lebih lanjut cara metrik dikira dalam artikel pusat bantuan ini

                • is_down
                  Jenis: integer | null

                  kedudukan menurun
                  menunjukkan berapa banyak elemen berkedudukan bagi sasaran yang dinyatakan telah menurun

                • is_lost
                  Jenis: integer | null

                  elemen berkedudukan yang hilang
                  menunjukkan berapa banyak elemen berkedudukan bagi sasaran yang dinyatakan sebelum ini muncul dalam SERP, tetapi tidak ditemui semasa semakan terakhir

                • is_new
                  Jenis: integer | null

                  bilangan elemen berkedudukan baharu
                  menunjukkan berapa banyak elemen berkedudukan baharu ditemui bagi sasaran yang dinyatakan

                • is_up
                  Jenis: integer | null

                  kedudukan meningkat
                  menunjukkan berapa banyak elemen berkedudukan bagi sasaran yang dinyatakan telah meningkat

                • pos_1
                  Jenis: integer | null

                  bilangan SERP organik tempat domain atau subdomain menduduki #1

                • pos_11_20
                  Jenis: integer | null

                  bilangan SERP organik tempat domain atau subdomain menduduki #11-20

                • pos_2_3
                  Jenis: integer | null

                  bilangan SERP organik tempat domain atau subdomain menduduki #2-3

                • pos_21_30
                  Jenis: integer | null

                  bilangan SERP organik tempat domain atau subdomain menduduki #21-30

                • pos_31_40
                  Jenis: integer | null

                  bilangan SERP organik tempat domain atau subdomain menduduki #31-40

                • pos_4_10
                  Jenis: integer | null

                  bilangan SERP organik tempat domain atau subdomain menduduki #4-10

                • pos_41_50
                  Jenis: integer | null

                  bilangan SERP organik tempat domain atau subdomain menduduki #41-50

                • pos_51_60
                  Jenis: integer | null

                  bilangan SERP organik tempat domain atau subdomain menduduki #51-60

                • pos_61_70
                  Jenis: integer | null

                  bilangan SERP organik tempat domain atau subdomain menduduki #61-70

                • pos_71_80
                  Jenis: integer | null

                  bilangan SERP organik tempat domain atau subdomain menduduki #71-80

                • pos_81_90
                  Jenis: integer | null

                  bilangan SERP organik tempat domain atau subdomain menduduki #81-90

                • pos_91_100
                  Jenis: integer | null

                  bilangan SERP organik tempat domain atau subdomain menduduki #91-100

            • month
              Jenis: integer | null

              bulan data disediakan

            • se_type
              Jenis: string | null

              jenis enjin carian

            • year
              Jenis: integer | null

              tahun data disediakan

          • items_count
            Jenis: integer | null Format: int64

            bilangan hasil yang dipulangkan dalam array items

          • language_code
            Jenis: string | null

            kod bahasa dalam array POST

          • location_code
            Jenis: integer | null

            kod lokasi dalam array POST

          • se_type
            Jenis: string | null

            jenis enjin carian

          • target
            Jenis: string | null

            domain sasaran dalam array POST

          • total_count
            Jenis: integer | null Format: int64

            jumlah hasil dalam pangkalan data kami yang berkaitan dengan permintaan anda

        • 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/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 berjaya

Historical Rank Overview