Linkly의 Analytics API

Linkly의 Analytics API를 사용하여 프로그래밍 방식으로 클릭 데이터 및 트래픽 보고서를 내보내세요.

관련: 링크 단축 API | 웹훅

시작하기 전에

Linkly는 인터페이스에서 API 요청을 생성하므로 애플리케이션에 복사하여 붙여넣을 수 있습니다.

시간을 절약하고 어려운 작업은 저희가 처리하게 하세요. 저희 API는 완전히 기계 처리 가능합니다.

인증

API 키와 워크스페이스 ID가 필요합니다. Linkly 내에서 이러한 세부 정보를 얻을 수 있습니다.

트래픽 보고서 API

Linkly는 트래픽 보고서 내에서 자동으로 API 요청을 생성합니다.

Linkly의 트래픽 보고서는 화면에 표시된 데이터를 기반으로 자동으로 API 요청을 생성합니다.

이 링크에는 API 키가 포함되며 쉽게 사용자 정의하고 자신의 애플리케이션에서 사용할 수 있습니다.

출력 형식

Analytics API는 세 가지 출력 형식을 지원합니다.

피벗 모드(매트릭스 형식)

기본적으로 API는 날짜당 하나의 행을 포함한 시계열 데이터를 반환합니다. 피벗 모드를 사용하면 단일 요청으로 모든 링크의 트래픽을 매트릭스로 얻을 수 있습니다.

모든 트래픽 보고서에서 데이터 내보내기 드롭다운을 사용하여 링크별로 데이터를 빠르게 내보내거나 API 요청에 pivot=link_id를 추가하세요.

요청에 pivot=link_id를 추가하여 다음을 포함한 데이터를 얻으세요.

• 행으로서의 날짜 (하루에 하나의 행)
• 열로서의 링크 (링크당 하나의 열)

CSV/TSV 피벗 출력 예제

JSON 피벗 출력 예제

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

피벗 모드는 다음 용도에 유용합니다.

• 여러 링크의 트래픽 비교
• 분석을 위해 스프레드시트로 가져오기
• 한 번의 호출로 모든 링크 데이터를 사용하여 대시보드 구축

원본 클릭 데이터

전체 파라미터, 타임스탐프 및 지리적 위치 정보를 포함하여 기록된 원본 클릭 데이터를 사용할 수 있습니다.

이 데이터에 접근하려면 하단의 탭에서 내보내기를 클릭하고 형식을 선택하세요. 이는 애플리케이션에서 직접 사용할 수 있는 완전히 형성된 API 요청입니다.

데이터 내보내기에 대한 참고사항

• 내보낸 데이터 양을 줄이기 위해 먼저 보기에서 데이터를 필터링하는 것을 고려하세요. 이 함수는 현재 화면의 보고서를 생성하는 데 사용된 기본 데이터를 내보냅니다.
• 이 데이터는 최대 3시간 동안 캐시됩니다. 이 엔드포인트에 대한 반복 요청은 실시간 데이터를 생성하지 않습니다.

실시간 클릭 알림

실시간 클릭 알림은 웹훅을 참조하세요. 웹훅은 클릭이 발생할 때 즉시 지정된 URL에 POST 요청을 보내며 클릭에 대한 자세한 정보를 포함합니다.

또한 API를 통해 웹훅을 관리할 수 있습니다. 자세한 내용은 OpenAPI 사양을 참조하세요.

공정한 사용 정책

속도 제한

Analytics API는 워크스페이스당 시간당 50개 요청으로 속도 제한됩니다.

사용 제한

속도 제한 외에도 Analytics API는 각 청구 기간마다 리셋되는 사용 제한이 있습니다.

사용량으로 계산되는 것

• API 요청: Analytics API 엔드포인트(/clicks, /counters, /export)에 대한 각 호출은 하나의 요청으로 계산됩니다.
• 스캔된 데이터: 요청을 처리하기 위해 분석 데이터베이스에서 처리한 데이터의 양입니다. 더 큰 날짜 범위와 더 복잡한 쿼리는 더 많은 데이터를 스캔합니다.

제한을 초과할 때 발생하는 일

사용 제한을 초과하면:

1. 1
   API 요청은 429 Too Many Requests 오류를 반환합니다.
2. 2
   다음 청구 기간 시작 시 제한이 자동으로 리셋됩니다.
3. 3
   링크가 계속 작동하고 정상적으로 클릭을 추적합니다.

사용 줄이기 팁

대부분의 사용자는 피벗 모드(pivot=link_id)를 사용하여 단일 API 요청에서 모든 데이터를 얻을 수 있으며, 이는 모든 링크의 트래픽을 매트릭스로 한 번에 반환합니다.

• 피벗 모드 사용: pivot=link_id를 추가하여 각 링크를 별도로 쿼리하는 대신 단일 요청에서 모든 링크의 트래픽을 얻으세요.
• 응답 캐시: 동일한 데이터를 반복해서 가져오는 대신 API 응답을 로컬에 저장하세요.
• 더 작은 날짜 범위 사용: 필요한 날짜만 쿼리하세요.
• 배치 요청: link_ids 파라미터를 사용하여 여러 링크 쿼리를 단일 요청으로 결합하세요.

더 필요하신가요?

더 높은 제한이 필요하면 지원 위젯을 사용하여 문의해 주세요.

BigQuery 통합

대량의 분석이 필요한 경우 Linkly는 클릭 데이터에 대한 직접 SQL 액세스를 제공하는 BigQuery 통합을 제공합니다.

• 라이브 데이터 액세스 - BigQuery에서 실시간 업데이트로 클릭 데이터를 직접 쿼리합니다.
• 무제한 쿼리 - API 속도 제한 없음. BigQuery 컴퓨팅 비용만 지불합니다.
• 사용자 정의 보고 - Looker, Data Studio 또는 Tableau로 대시보드를 구축합니다.
• 데이터 통합 - 클릭 데이터를 다른 비즈니스 메트릭과 결합합니다.

BigQuery 통합은 Enterprise 플랜에 포함되어 있습니다. 자세한 내용은 문의하기를 참조하세요.

BigQuery 통합에 대해 자세히 알아보기 →

관련

• 링크 단축 API - 프로그래밍 방식으로 링크 생성 및 업데이트
• 웹훅 - 실시간 클릭 알림
• BigQuery 통합 - 클릭 데이터에 대한 직접 SQL 액세스
• Zapier 통합 - 코드 없는 통합