Linkly의 분석 API

Linkly의 분석 API를 사용하여 프로그래밍 방식으로 클릭 데이터 및 트래픽 리포트를 내보냅니다.

관련 항목: 링크 단축 API | 웹훅

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

시간을 절약하고 어려운 작업은 저희가 처리하도록 하세요. 저희 API는 완전히 기계로 사용할 수 있습니다.

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

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

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

이러한 링크에는 API 키가 포함되어 있으며, 사용자 정의가 쉽고 자체 애플리케이션에서 사용할 수 있습니다.

분석 API는 세 가지 출력 형식을 지원합니다:

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

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

요청에 pivot=link_id를 추가하여 다음과 같은 데이터를 가져옵니다:

• 행으로 날짜 (날짜당 한 행)
• 열로 링크 (링크당 한 열)

{
  "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 사양을 참조하세요.

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

속도 제한 외에도 분석 API에는 각 청구 기간마다 재설정되는 사용 제한이 있습니다:

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

사용 제한을 초과하는 경우:

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

대부분의 사용자는 피벗 모드(pivot=link_id)를 사용하여 단일 API 요청으로 모든 데이터를 가져올 수 있습니다. 이는 한 번의 호출로 모든 링크의 트래픽을 행렬로 반환합니다.

• 피벗 모드 사용: 각 링크를 개별적으로 쿼리하는 대신 pivot=link_id를 추가하여 단일 요청으로 모든 링크의 트래픽을 가져옵니다
• 응답 캐시: 동일한 데이터를 반복적으로 가져오는 대신 API 응답을 로컬에 저장합니다
• 더 작은 날짜 범위 사용: 필요한 날짜만 쿼리합니다
• 요청 일괄 처리: link_ids 매개변수를 사용하여 여러 링크 쿼리를 단일 요청으로 결합합니다

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

대용량 분석 요구 사항에 대해 Linkly는 클릭 데이터에 대한 직접 SQL 액세스를 제공하는 BigQuery 통합을 제공합니다.

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

BigQuery 통합은 무제한 플랜 고객에게는 무료이며, 다른 플랜에는 월 $100의 추가 기능으로 제공됩니다.

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

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