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시간 동안 캐시됩니다. 이 엔드포인트에 대한 반복 요청은 실시간 데이터를 생성하지 않습니다.

그룹화된 개수

/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 통합을 사용합니다.

실시간 클릭 알림

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

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

공정한 사용 정책

속도 제한

Analytics API는 작업 공간당 시간당 50개의 요청으로 제한됩니다.

사용 제한

속도 제한 외에도 Analytics API는 각 청구 기간마다 재설정되는 사용 제한을 가집니다:

사용으로 계산되는 항목

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

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

유료 플랜의 작업 공간이 모든 API 요청을 사용할 때 통합이 계속 작동하도록 구독에 API 팩을 자동으로 추가하고 작업 공간의 멤버에게 알립니다. API 팩은 제거할 때까지 매 청구 기간마다 추가 API 요청을 추가합니다.

다음의 경우 API 요청은 대신 429 Too Many Requests 오류를 반환합니다:

1. 1
   작업 공간이 무료 또는 스타터 플랜에 있으며, API 팩을 추가할 수 없습니다.
2. 2
   작업 공간의 구독이 취소로 설정되어 있거나 결제가 연체되었습니다.
3. 3
   작업 공간이 스캔한 데이터 허용량을 모두 사용했습니다 — API 팩은 요청을 추가하고 데이터가 아닙니다.

사용 제한은 각 청구 기간이 시작될 때 재설정되며, 어느 쪽이든 링크가 계속 작동하고 클릭을 정상적으로 추적합니다.

사용을 줄이는 팁

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

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

더 필요하신가요?

결제 페이지의 Add-ons에서 언제든지 API 팩을 직접 추가할 수 있습니다. 각 팩은 매 청구 기간마다 추가 API 요청을 추가합니다. 페이지에는 확인하기 전에 플랜에 대한 가격이 표시됩니다.

API 팩은 속도 제한을 변경하지 않습니다. 더 높은 속도 제한이 필요한 경우 지원 위젯을 사용하여 문의하세요.

BigQuery 통합

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

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

BigQuery 통합은 Enterprise 플랜에 포함됩니다. 자세한 내용은 문의하세요.

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

관련

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