ภาพรวมอันดับย้อนหลัง

Felo API Support

MIT

เซิร์ฟเวอร์

https://openapi.felo.ai

ไลบรารีไคลเอนต์

Shell Curl

DataForSEO

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

DataForSEO การดำเนินการ

post/v1/beta/dataforseo/dataforseo_labs/google/historical_rank_overview/live

ภาพรวมอันดับย้อนหลัง

ภาพรวมอันดับของโดเมน ณ แต่ละจุดของประวัติที่มี endpoint นี้ไม่มีพารามิเตอร์ limit แต่คิดราคาต่อการเรียกไม่ใช่ต่อรายการ จึงควรส่งทั้งรายการในครั้งเดียว ห่อหุ้มในซองของ DataForSEO: ข้อมูลอยู่ใน tasks[0].result ผลลัพธ์อยู่ใน tasks[0].status_code - คำขอที่ถูกปฏิเสธยังคงคืนค่า HTTP 200 ตรวจสอบ get_dataforseo_labs_google_available_history ก่อน - รายการนั้นระบุวันที่ที่มีอยู่ และการขอวันที่นอกช่วงจะคืนค่าเปล่าแทนข้อผิดพลาด สแนปช็อตปัจจุบันคือ post_dataforseo_labs_google_domain_rank_overview_live

ข้อมูลอ้างอิงราคา

การวัดปริมาณ: ต้นทุนการตอบกลับที่รายงาน
ประมาณการคำขออ้างอิง: USD 0.1356
ตัวคูณลูกค้าอ้างอิง: 1.0 ห้ามนำไปใช้ซ้ำกับยอดที่ตัดบัญชีของลูกค้าแล้ว

เป็นเพียงข้อมูลเมตาอ้างอิง ไม่ใช่ใบเสนอราคาของบัญชี ไม่ใช่ราคาที่รับประกัน และไม่ใช่เพดานการใช้จ่าย เครดิตทรัพยากรไม่ใช่เครดิต Felo การเรียกเก็บเงินขั้นสุดท้ายเป็นไปตามบันทึกการเรียกเก็บเงินของ Felo

บอดี้

application/json

ประเภท: array (object | null)[]
- correlate
  ประเภท: boolean | null
  
  เชื่อมโยงข้อมูลกับชุดข้อมูลที่เคยได้รับก่อนหน้า
  ฟิลด์ที่ไม่บังคับ
  ค่าเริ่มต้น: true
  หากใช้พารามิเตอร์นี้ ระบบจะเชื่อมโยงข้อมูลที่คุณได้รับตอนนี้กับชุดข้อมูลที่เคยได้รับก่อนหน้า
  พารามิเตอร์นี้มีไว้เพื่อลดความไม่สอดคล้องที่อาจเกิดจากการเปลี่ยนแปลงฐานข้อมูลของเรา
  แนะนำให้ตั้งค่า correlate เป็น true เสมอ
- date_from
  ประเภท: string | null
  
  วันที่เริ่มต้นของช่วงเวลา
  ฟิลด์ที่ไม่บังคับ
  หากไม่ระบุฟิลด์นี้ ข้อมูลจะถูกส่งสำหรับ 6 เดือนก่อนหน้า
  ค่าต่ำสุดที่ระบุได้: 2020-10-01
  รูปแบบวันที่: "yyyy-mm-dd"
- date_to
  ประเภท: string | null
  
  วันที่สิ้นสุดของช่วงเวลา
  ฟิลด์ที่ไม่บังคับ
  หากไม่ระบุฟิลด์นี้ ระบบจะใช้วันที่ของวันนี้เป็นค่าเริ่มต้น
  รูปแบบวันที่: "yyyy-mm-dd"
  ตัวอย่าง:
  "2021-04-01"
- ignore_synonyms
  ประเภท: boolean | null
  
  ไม่สนใจคีย์เวิร์ดที่คล้ายกันมาก
  ฟิลด์ที่ไม่บังคับ
  หากตั้งค่าเป็น true จะคืนเฉพาะข้อมูลที่อิงคีย์เวิร์ดหลัก และตัดข้อมูลของคีย์เวิร์ดที่คล้ายกันมากทั้งหมดออก;
  ค่าเริ่มต้น: false
- include_clickstream_data
  ประเภท: boolean | null
  
  รวมหรือตัดข้อมูลจากเมตริกที่อิงคลิกสตรีมในผลลัพธ์
  ฟิลด์ที่ไม่บังคับ
  หากตั้งค่าพารามิเตอร์เป็น true คุณจะได้รับฟิลด์ clickstream_etv, clickstream_gender_distribution และ clickstream_age_distribution พร้อมข้อมูลคลิกสตรีมในการตอบกลับ;
  ค่าเริ่มต้น: false;
  
  หมายเหตุ: ข้อมูลคลิกสตรีมย้อนหลังมีให้ตั้งแต่ 2024/05 (พฤษภาคม 2024);
  เมื่อเปิดใช้พารามิเตอร์นี้ จะถูกเรียกเก็บค่าบริการสองเท่าสำหรับคำขอ;
  ดูข้อมูลเพิ่มเติมเกี่ยวกับการคำนวณเมตริกที่อิงคลิกสตรีมได้ในบทความ Help Center นี้
- language_code
  ประเภท: string | null
  
  รหัสภาษา
  ฟิลด์ที่จำเป็นหากไม่ได้ระบุ language_name
  หมายเหตุ: ต้องระบุ language_name หรือ language_code อย่างใดอย่างหนึ่ง
  คุณสามารถรับรายการสถานที่ที่ใช้ได้พร้อม language_code ได้โดยส่งคำขอแยกไปที่
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  ตัวอย่าง:
  en
- language_name
  ประเภท: string
  
  ชื่อเต็มของภาษา
  ฟิลด์ที่จำเป็นหากไม่ได้ระบุ language_code
  หมายเหตุ: ต้องระบุ language_name หรือ language_code อย่างใดอย่างหนึ่ง
  คุณสามารถรับรายการภาษาที่ใช้ได้พร้อม language_name ได้โดยส่งคำขอแยกไปที่
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  ตัวอย่าง:
  English
- location_code
  ประเภท: integer
  
  รหัสสถานที่
  ฟิลด์ที่จำเป็นหากไม่ได้ระบุ location_name
  หมายเหตุ: ต้องระบุ location_name หรือ location_code อย่างใดอย่างหนึ่ง
  คุณสามารถรับรายการสถานที่ที่ใช้ได้พร้อม location_code ได้โดยส่งคำขอแยกไปที่
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  ตัวอย่าง:
  2840
- location_name
  ประเภท: string
  
  ชื่อเต็มของสถานที่
  ฟิลด์ที่จำเป็นหากไม่ได้ระบุ location_code
  หมายเหตุ: ต้องระบุ location_name หรือ location_code อย่างใดอย่างหนึ่ง
  คุณสามารถรับรายการสถานที่ที่ใช้ได้พร้อม location_name ได้โดยส่งคำขอแยกไปที่
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  ตัวอย่าง:
  United Kingdom
- tag
  ประเภท: string | null
  
  ตัวระบุงานที่ผู้ใช้กำหนด
  ฟิลด์ไม่บังคับ
  จำกัด 255 อักขระ
  ใช้พารามิเตอร์นี้เพื่อระบุงานและจับคู่กับผลลัพธ์
  คุณจะพบค่า tag ที่ระบุในออบเจ็กต์ data ของการตอบกลับ
- target
  ประเภท: string
  
  โดเมน
  ฟิลด์ที่จำเป็น
  ชื่อโดเมนของเว็บไซต์เป้าหมาย
  โดเมนควรระบุโดยไม่มี https:// และ www.

การตอบกลับ

200
ประเภท: object | null · Response36Afe1097B20_DataforseoLabsGoogleHistoricalRankOverviewLiveResponseInfo
cost
ประเภท: number | null รูปแบบ: double

ค่าใช้จ่ายรวมของงาน, USD

status_code
ประเภท: integer | null

รหัสสถานะทั่วไป คุณสามารถดูรายการรหัสการตอบกลับทั้งหมดได้ที่นี่

status_message
ประเภท: string | null

ข้อความข้อมูลทั่วไป คุณสามารถดูรายการข้อความข้อมูลทั่วไปทั้งหมดได้ที่นี่

tasks
ประเภท: array (object | null)[] | null

อาร์เรย์ของงาน

ประเภท: object | null · Response36Afe1097B20_DataforseoLabsGoogleHistoricalRankOverviewLiveTaskInfo
cost
ประเภท: number | null รูปแบบ: double

ค่าใช้จ่ายรวมของงาน, USD

data
ประเภท: object | null

มีพารามิเตอร์เดียวกับที่คุณระบุในคำขอ POST

propertyName
ประเภท: object | null
id
ประเภท: string | null

ตัวระบุงาน ตัวระบุงานที่ไม่ซ้ำกันในระบบของเราในรูปแบบ UUID

path
ประเภท: array (string | null)[] | null

พาธ URL

result
ประเภท: array (object | null)[] | null

อาร์เรย์ของผลลัพธ์

items
ประเภท: array (object | null)[] | null

มีข้อมูลอันดับและทราฟฟิกย้อนหลัง

metrics
ประเภท: object | null

ข้อมูลอันดับที่เกี่ยวข้องกับโดเมนที่ระบุ

propertyName
ประเภท: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
clickstream_age_distribution
ประเภท: object | null

การกระจายตัวของตัวชี้วัดจาก clickstream ตามอายุ
หากต้องการดึงผลลัพธ์ของฟิลด์นี้ ต้องตั้งค่าพารามิเตอร์ include_clickstream_data เป็น true
อ่านเพิ่มเติมเกี่ยวกับวิธีคำนวณตัวชี้วัดได้ในบทความศูนย์ช่วยเหลือนี้

propertyName
ประเภท: integer | null รูปแบบ: int64

Signed 64-bit integers (long type).

clickstream_etv
ประเภท: number | null รูปแบบ: double

ปริมาณทราฟฟิกโดยประมาณจากข้อมูล clickstream
คำนวณเป็นผลคูณของอัตราการคลิกและค่าปริมาณการค้นหาแบบ clickstream ของทุกคีย์เวิร์ดที่โดเมนจัดอันดับ
หากต้องการดึงผลลัพธ์ของฟิลด์นี้ ต้องตั้งค่าพารามิเตอร์ include_clickstream_data เป็น true
อ่านเพิ่มเติมเกี่ยวกับวิธีคำนวณตัวชี้วัดได้ในบทความศูนย์ช่วยเหลือนี้

clickstream_gender_distribution
ประเภท: object | null

การกระจายตัวของตัวชี้วัดจาก clickstream โดยประมาณตามเพศ
หากต้องการดึงผลลัพธ์ของฟิลด์นี้ ต้องตั้งค่าพารามิเตอร์ include_clickstream_data เป็น true
อ่านเพิ่มเติมเกี่ยวกับวิธีคำนวณตัวชี้วัดได้ในบทความศูนย์ช่วยเหลือนี้

propertyName
ประเภท: integer | null รูปแบบ: int64

Signed 64-bit integers (long type).

count
ประเภท: integer | null รูปแบบ: int64

จำนวน SERP แบบออร์แกนิกทั้งหมดที่มีโดเมนหรือซับโดเมนนี้

estimated_paid_traffic_cost
ประเภท: number | null

ต้นทุนโดยประมาณจากการแปลงทราฟฟิกการค้นหาออร์แกนิกเป็นแบบเสียเงิน
แสดงต้นทุนรายเดือนโดยประมาณ (USD) ในการลงโฆษณาสำหรับทุกคีย์เวิร์ดในหมวดหมู่ที่โดเมนหรือซับโดเมนจัดอันดับ
ตัวชี้วัดคำนวณเป็นผลคูณของค่า etv แบบออร์แกนิกและค่า cpc แบบเสียเงิน และระบุต้นทุนในการนำปริมาณทราฟฟิกออร์แกนิกรายเดือนโดยประมาณผ่านการโฆษณา PPC ใน Google Search
อ่านเพิ่มเติมเกี่ยวกับวิธีคำนวณตัวชี้วัดได้ในบทความศูนย์ช่วยเหลือนี้

etv
ประเภท: number | null

ปริมาณทราฟฟิกโดยประมาณ
ทราฟฟิกออร์แกนิกรายเดือนโดยประมาณไปยังโดเมนหรือซับโดเมน
คำนวณเป็นผลคูณของค่า CTR (อัตราการคลิก) และปริมาณการค้นหาของทุกคีย์เวิร์ดในหมวดหมู่ที่โดเมนหรือซับโดเมนจัดอันดับ
อ่านเพิ่มเติมเกี่ยวกับวิธีคำนวณตัวชี้วัดได้ในบทความศูนย์ช่วยเหลือนี้

is_down
ประเภท: integer | null

อันดับลดลง
ระบุจำนวนองค์ประกอบที่จัดอันดับของเป้าหมายที่ระบุซึ่งลดลง

is_lost
ประเภท: integer | null

องค์ประกอบที่จัดอันดับซึ่งสูญหาย
ระบุจำนวนองค์ประกอบที่จัดอันดับของเป้าหมายที่ระบุซึ่งเคยปรากฏใน SERP แต่ไม่พบในการตรวจสอบครั้งล่าสุด

is_new
ประเภท: integer | null

จำนวนองค์ประกอบที่จัดอันดับใหม่
ระบุจำนวนองค์ประกอบที่จัดอันดับใหม่ที่พบสำหรับเป้าหมายที่ระบุ

is_up
ประเภท: integer | null

อันดับเพิ่มขึ้น
ระบุจำนวนองค์ประกอบที่จัดอันดับของเป้าหมายที่ระบุซึ่งเพิ่มขึ้น

pos_1
ประเภท: integer | null

จำนวน SERP แบบออร์แกนิกที่โดเมนหรือซับโดเมนอยู่อันดับ #1

pos_11_20
ประเภท: integer | null

จำนวน SERP แบบออร์แกนิกที่โดเมนหรือซับโดเมนอยู่อันดับ #11-20

pos_2_3
ประเภท: integer | null

จำนวน SERP แบบออร์แกนิกที่โดเมนหรือซับโดเมนอยู่อันดับ #2-3

pos_21_30
ประเภท: integer | null

จำนวน SERP แบบออร์แกนิกที่โดเมนหรือซับโดเมนอยู่อันดับ #21-30

pos_31_40
ประเภท: integer | null

จำนวน SERP แบบออร์แกนิกที่โดเมนหรือซับโดเมนอยู่อันดับ #31-40

pos_4_10
ประเภท: integer | null

จำนวน SERP แบบออร์แกนิกที่โดเมนหรือซับโดเมนอยู่อันดับ #4-10

pos_41_50
ประเภท: integer | null

จำนวน SERP แบบออร์แกนิกที่โดเมนหรือซับโดเมนอยู่อันดับ #41-50

pos_51_60
ประเภท: integer | null

จำนวน SERP แบบออร์แกนิกที่โดเมนหรือซับโดเมนอยู่อันดับ #51-60

pos_61_70
ประเภท: integer | null

จำนวน SERP แบบออร์แกนิกที่โดเมนหรือซับโดเมนอยู่อันดับ #61-70

pos_71_80
ประเภท: integer | null

จำนวน SERP แบบออร์แกนิกที่โดเมนหรือซับโดเมนอยู่อันดับ #71-80

pos_81_90
ประเภท: integer | null

จำนวน SERP แบบออร์แกนิกที่โดเมนหรือซับโดเมนอยู่อันดับ #81-90

pos_91_100
ประเภท: integer | null

จำนวน SERP แบบออร์แกนิกที่โดเมนหรือซับโดเมนอยู่อันดับ #91-100

month
ประเภท: integer | null

เดือนที่ให้ข้อมูล

se_type
ประเภท: string | null

ประเภทของเครื่องมือค้นหา

year
ประเภท: integer | null

ปีที่ให้ข้อมูล

items_count
ประเภท: integer | null รูปแบบ: int64

จำนวนผลลัพธ์ที่ส่งคืนในอาร์เรย์ items

language_code
ประเภท: string | null

รหัสภาษาในอาร์เรย์ POST

location_code
ประเภท: integer | null

รหัสสถานที่ในอาร์เรย์ POST

se_type
ประเภท: string | null

ประเภทของเครื่องมือค้นหา

target
ประเภท: string | null

โดเมนเป้าหมายในอาร์เรย์ POST

total_count
ประเภท: integer | null รูปแบบ: int64

จำนวนผลลัพธ์ทั้งหมดในฐานข้อมูลของเราที่เกี่ยวข้องกับคำขอของคุณ

result_count
ประเภท: integer | null รูปแบบ: int64

จำนวนองค์ประกอบในอาร์เรย์ result

status_code
ประเภท: integer | null

รหัสสถานะของงาน สร้างโดย DataForSEO โดยอยู่ในช่วงต่อไปนี้ได้: 10000-60000 คุณสามารถดูรายการรหัสการตอบกลับทั้งหมดได้ที่นี่

status_message
ประเภท: string | null

ข้อความข้อมูลของงาน คุณสามารถดูรายการข้อความข้อมูลทั่วไปทั้งหมดได้ที่นี่

time
ประเภท: string | null

เวลาดำเนินการ, วินาที

tasks_count
ประเภท: integer | null รูปแบบ: int64

จำนวนงานในอาร์เรย์ tasks

tasks_error
ประเภท: integer | null รูปแบบ: int64

จำนวนงานในอาร์เรย์ tasks ที่ส่งคืนพร้อมข้อผิดพลาด

time
ประเภท: string | null

เวลาดำเนินการทั้งหมด (วินาที)

version
ประเภท: string | null

เวอร์ชันปัจจุบันของ API
application/json
400

ไม่สามารถประมวลผลคำขอได้ ตรวจสอบพารามิเตอร์ของคำขอ
401

จำเป็นต้องใช้คีย์ API ของ Felo ที่ถูกต้อง
402

ไม่สามารถดำเนินการตามคำขอได้ เนื่องจากไม่เป็นไปตามข้อกำหนดด้านการเรียกเก็บเงิน
403

บัญชีไม่ได้รับอนุญาตให้ดำเนินการนี้
429

ถึงขีดจำกัดคำขอหรือการใช้จ่ายแล้ว
502

บริการไม่สามารถดำเนินการตามคำขอให้เสร็จสิ้นได้
503

API หรือบริการเรียกเก็บเงินไม่พร้อมใช้งานชั่วคราว
504

บริการหมดเวลาระหว่างประมวลผลคำขอ
default

การตอบกลับข้อผิดพลาด; การตอบกลับที่ส่งผ่านจากต้นทางอาจใช้รูปแบบของผู้ให้บริการ

application/json

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
            }
          ]
        }
      ]
    }
  ]
}

ดำเนินการสำเร็จ

ภาพรวมอันดับย้อนหลัง

การยืนยันตัวตนRequired

DataForSEO

ภาพรวมอันดับย้อนหลัง

ข้อมูลอ้างอิงราคา