Analytics API ของ Linkly

ส่งออกข้อมูลการคลิกและรายงานการจราจรจาก Linkly โดยใช้โปรแกรมผ่าน Analytics API ของเรา

ที่เกี่ยวข้อง: Link Shortening API | Webhooks

ก่อนที่คุณจะเริ่มต้น

Linkly สร้างคำขอ API ในอินเทอร์เฟซสำหรับคุณเพื่อคัดลอกและวางลงในแอปพลิเคชันของคุณ

ประหยัดเวลาและปล่อยให้เราทำงานหนัก API ของเราใช้ได้กับเครื่องจักรทั้งหมด

การอนุญาต

คุณจะต้อง API Key และ Workspace ID คุณสามารถรับรายละเอียดเหล่านี้ได้จากภายใน Linkly

Traffic reports API

Linkly สร้างคำขอ API สำหรับคุณโดยอัตโนมัติภายในรายงานการจราจรของคุณ

รายงานการจราจรของ Linkly สร้างคำขอ API สำหรับคุณโดยอัตโนมัติ ตามข้อมูลที่แสดงบนหน้าจอ

ลิงก์เหล่านี้รวม API key ของคุณ และสามารถปรับแต่งและใช้ได้ง่ายในแอปพลิเคชันของคุณเอง

รูปแบบผลลัพธ์

Analytics API รองรับรูปแบบผลลัพธ์สามรูปแบบ

Pivot mode (รูปแบบเมทริกซ์)

โดยค่าเริ่มต้น API จะส่งกลับข้อมูลอนุกรมเวลาโดยมีหนึ่งแถวต่อวัน ด้วย pivot mode คุณสามารถรับการจราจรของลิงก์ทั้งหมดในคำขอเดียวเป็นเมทริกซ์

ใช้ดรอปดาวน์ Export Data ในรายงานการจราจรใดๆ เพื่อส่งออกข้อมูลตามลิงก์อย่างรวดเร็ว หรือเพิ่ม pivot=link_id ลงในคำขอ API ของคุณ

เพิ่ม pivot=link_id ลงในคำขอของคุณเพื่อรับข้อมูลโดยมี:

• วันที่เป็นแถว (หนึ่งแถวต่อวัน)
• ลิงก์เป็นคอลัมน์ (หนึ่งคอลัมน์ต่อลิงก์)

CSV/TSV pivot output ตัวอย่าง

JSON pivot output ตัวอย่าง

{
  "links": [
    {"id": 123, "name": "My Link", "full_url": "https://linkly.link/abc"},
    {"id": 456, "name": "Other Link", "full_url": "https://linkly.link/xyz"}
  ],
  "data": [
    {"date": "2025-12-30", "clicks": {"123": 45, "456": 12}},
    {"date": "2025-12-31", "clicks": {"123": 52, "456": 8}}
  ]
}

Pivot mode มีประโยชน์สำหรับ:

• การเปรียบเทียบการจราจรในลิงก์หลายชุด
• การนำเข้าลงในสเปรดชีตเพื่อการวิเคราะห์
• การสร้างแดชบอร์ดที่มีข้อมูลลิงก์ทั้งหมดในการโทรหนึ่งครั้ง

ข้อมูลการคลิกแบบดิบ

ข้อมูลการคลิกแบบดิบที่เราบันทึก รวมถึงพารามิเตอร์เต็ม ประทับเวลา และข้อมูลตำแหน่งภูมิศาสตร์ มีให้บริการ

เพื่อเข้าถึงข้อมูลนี้ ให้คลิก Export จากแท็บที่ด้านล่าง แล้วเลือกรูปแบบของคุณ นี่คือคำขอ API ที่มีการจัดรูปแบบอย่างสมบูรณ์ที่คุณสามารถใช้ได้โดยตรงในแอปพลิเคชันของคุณ

หมายเหตุเกี่ยวกับการส่งออกข้อมูล

• พิจารณาการกรองข้อมูลในมุมมองก่อนเพื่อลดปริมาณข้อมูลที่ส่งออก ฟังก์ชันนี้ส่งออกข้อมูลพื้นฐานที่ใช้ในการสร้างรายงานที่อยู่บนหน้าจออยู่ในขณะนี้
• ข้อมูลนี้ถูกแคช นานถึง 3 ชั่วโมง คำขอซ้ำไปยังเอนด์พอยต์นี้จะไม่สร้างข้อมูลแบบเรียลไทม์

จำนวนที่จัดกลุ่ม

เอนด์พอยต์ /counters/{dimension} ส่งกลับยอดรวมการคลิกที่จัดกลุ่มตามมิติเดียว เช่น country, platform, destination, referer, isp หรือ link_id ผลลัพธ์จะกลับมาเรียงลำดับตามจำนวนการคลิก สูงสุดก่อน

ส่งกลับค่าสูงสุด 10,000 ค่า มิติที่มีคาร์ดินัลลิตี้สูง — destination, referer, remote_ip และ isp — สามารถมีค่าที่แตกต่างกันมากกว่านั้นในพื้นที่ทำงานที่ยุ่งวุ่นวาย เมื่อเป็นเช่นนั้น คุณจะได้รับ 10,000 อันดับแรกตามจำนวนการคลิก และส่วนที่เหลือจะไม่ถูกส่งกลับ

ฟิลด์ total จะเป็นการคลิกทั้งหมดเสมอใน ทุก กลุ่ม รวมถึงสิ่งที่ไม่ได้ส่งกลับ ดังนั้นในผลลัพธ์ที่ถูกตัดทอน ค่า count จะรวมกันให้น้อยกว่า total — ซึ่งหมายความว่าเปอร์เซ็นต์ที่คำนวณเป็น count / total ยังคงแม่นยำ

หากคุณต้องการชุดค่าสมบูรณ์แทนที่จะเป็น 10,000 ค่าแรก ให้ส่งออกข้อมูลการคลิกแบบดิบและรวมกลุ่มด้วยตัวคุณเอง หรือใช้ BigQuery integration

การแจ้งเตือนการคลิกแบบเรียลไทม์

สำหรับการแจ้งเตือนการคลิกแบบเรียลไทม์ โปรดดู Webhooks Webhooks ส่งคำขอ POST ไปยัง URL ที่ระบุของคุณทันทีที่มีการคลิก พร้อมข้อมูลโดยละเอียดเกี่ยวกับการคลิก

คุณยังสามารถจัดการ webhooks ผ่าน API ได้ - ดู OpenAPI spec สำหรับรายละเอียด

นโยบายการใช้อย่างยุติธรรม

ขีดจำกัดอัตรา

Analytics API ถูก rate limit เป็น 50 คำขอต่อชั่วโมง ต่อพื้นที่ทำงาน

ขีดจำกัดการใช้งาน

นอกเหนือจากขีดจำกัดอัตรา Analytics API มีขีดจำกัดการใช้งานที่รีเซ็ตในแต่ละรอบการเรียกเก็บเงิน:

สิ่งที่นับเป็นการใช้งาน

• API Requests: แต่ละการเรียก Analytics API endpoints (/clicks, /counters, /export) นับเป็นหนึ่งคำขอ Link exports (/links/export) ที่ทำด้วย API key นับเป็นหนึ่งคำขอเช่นกัน
• Data Scanned: ปริมาณข้อมูลที่ประมวลผลโดยฐานข้อมูลการวิเคราะห์ของเรา เพื่อปฏิบัติตามคำขอของคุณ ช่วงวันที่ที่มากขึ้นและการสืบค้นที่ซับซ้อนมากขึ้นจะสแกนข้อมูลมากขึ้น

สิ่งที่เกิดขึ้นเมื่อคุณเกินขีดจำกัด

เมื่อพื้นที่ทำงานในแผนจ่ายเงิน ใช้คำขอ API ทั้งหมด เราจะเพิ่ม API pack ให้กับการสมัครสมาชิกโดยอัตโนมัติเพื่อให้การรวมระบบของคุณยังคงทำงาน และส่งอีเมลให้สมาชิกของพื้นที่ทำงานเพื่อให้พวกเขารู้ว่า API pack เพิ่มคำขอ API พิเศษในแต่ละรอบการเรียกเก็บเงิน จนกว่าคุณจะลบออก

คำขอ API จะส่งกลับข้อผิดพลาด 429 Too Many Requests แทน เมื่อ:

1. 1
   พื้นที่ทำงานอยู่ในแผน Free หรือ Starter ซึ่งไม่สามารถเพิ่ม API packs
2. 2
   การสมัครสมาชิกของพื้นที่ทำงานตั้งค่าให้ยกเลิก หรือการชำระเงินไม่ผ่าน
3. 3
   พื้นที่ทำงานได้ใช้ข้อมูลทั้งหมดของสิ่งที่สแกน — API packs เพิ่มคำขอ ไม่ใช่ข้อมูล

ขีดจำกัดการใช้งานจะรีเซ็ตเมื่อเริ่มต้นแต่ละรอบการเรียกเก็บเงิน และลิงก์ของคุณยังคงทำงานและติดตามการคลิกได้ปกติไม่ว่าในกรณีใด

เคล็ดลับในการลดการใช้งาน

ผู้ใช้ส่วนใหญ่สามารถรับข้อมูลทั้งหมดของพวกเขาในคำขอ API เดียว โดยใช้ pivot mode (pivot=link_id) ซึ่งส่งกลับการจราจรของลิงก์ทั้งหมดเป็นเมทริกซ์ในการโทรครั้งเดียว

• ใช้ pivot mode: เพิ่ม pivot=link_id เพื่อรับการจราจรสำหรับลิงก์ทั้งหมดในคำขอเดียว แทนที่จะสืบค้นลิงก์แต่ละรายแยกกัน
• Cache responses: เก็บ API responses ไว้ในเครื่องแทนที่จะดึงข้อมูลเดียวกันซ้ำ ๆ
• ใช้ช่วงวันที่ที่เล็กกว่า: สืบค้นเฉพาะวันที่ที่คุณต้องการ
• Batch requests: รวมการสืบค้นลิงก์หลายรายเข้าในคำขอเดียวโดยใช้พารามิเตอร์ link_ids

ต้องการเพิ่มเติม?

คุณสามารถเพิ่ม API packs ของคุณเองได้ตลอดเวลาภายใต้ Add-ons บนหน้า การเรียกเก็บเงิน แต่ละแพ็คจะเพิ่มคำขอ API พิเศษในแต่ละรอบการเรียกเก็บเงิน หน้าจะแสดงราคาสำหรับแผนของคุณก่อนที่คุณจะยืนยัน

API packs ไม่เปลี่ยนขีดจำกัดอัตรา หากคุณต้องการขีดจำกัดอัตราที่สูงกว่า โปรดพูดคุยกับเราโดยใช้วิดเจ็ตการสนับสนุน

BigQuery integration

สำหรับความต้องการการวิเคราะห์ปริมาณมาก Linkly มี BigQuery integration ที่ให้การเข้าถึง SQL โดยตรงไปยังข้อมูลการคลิกของคุณ

• Live data access - สอบถามข้อมูลการคลิกของคุณโดยตรงใน BigQuery พร้อมอัปเดตแบบเรียลไทม์
• Unlimited queries - ไม่มีขีดจำกัดอัตรา API คุณจ่ายเฉพาะสำหรับการคำนวณ BigQuery
• Custom reporting - สร้างแดชบอร์ดโดยใช้ Looker Data Studio หรือ Tableau
• Data consolidation - เชื่อมข้อมูลการคลิกกับตัวชี้วัดธุรกิจอื่น ๆ

BigQuery integration รวมอยู่ในแผน Enterprise ติดต่อเรา สำหรับรายละเอียด

เรียนรู้เพิ่มเติมเกี่ยวกับ BigQuery Integration →

ที่เกี่ยวข้อง

• Link Shortening API - สร้างและอัปเดตลิงก์โดยใช้โปรแกรม
• Webhooks - การแจ้งเตือนการคลิกแบบเรียลไทม์
• BigQuery Integration - การเข้าถึง SQL โดยตรงไปยังข้อมูลการคลิก
• Zapier Integration - การรวมระบบที่ไม่มีโค้ด