Threads 인사이트 API 수집기에서 공유가 0으로 찍힌 이유와 빠진 지표 찾는 법

주간 정리 표를 보는데 그 주에 올린 Threads 글 5편의 공유 수가 전부 0으로 적혀 있었습니다. 그중 한 편은 조회 1,193, 좋아요 11, 리포스트 1이 나온 글이라 공유만 0인 게 이상해서 앱에서 직접 열어 보니 공유가 10이었습니다. 원인은 제가 만든 지표 수집기였습니다. Threads 인사이트 API는 글 하나에 지표 여섯 개를 주는데, 수집기는 그중 다섯 개만 요청하고 있었고 공유(shares)가 빠져 있었습니다. 저장하는 표에도 공유 칸이 없어서, 주간 정리에서는 그 자리가 “안 쟀음”이 아니라 0으로 채워졌습니다.

이 글에는 그때 확인한 순서와, 같은 일이 다른 대시보드에서도 생기지 않게 점검하는 방법을 적었습니다.

Threads 인사이트 API가 주는 지표 여섯 개

글 하나의 지표는 GET /{media-id}/insights 로 받고, 받을 지표 이름을 metric 파라미터에 쉼표로 이어 적습니다. 공식 문서(Threads Insights API)에 나온 글 단위 지표는 다음 여섯 개입니다. 2026년 10월에 확인했을 때 views 와 shares 에는 아직 개발 중이라는 표시가 붙어 있었습니다.

지표	뜻	제 수집기
views	조회	가져옴
likes	좋아요	가져옴
replies	답글	가져옴
reposts	리포스트	가져옴
quotes	인용	가져옴
shares	공유	빠짐

수집기 코드에는 요청할 지표가 "views,likes,replies,reposts,quotes" 한 줄로 고정돼 있었습니다. 처음 만들 때 눈에 들어온 다섯 개를 넣고 그대로 굳은 것입니다. 직접 만든 수집기인데도 공유를 빼놨다는 걸 표를 의심하기 전까지 몰랐습니다.

공유 수가 0으로 보일 때 확인하는 순서

1. 원본 화면과 표를 대조합니다. 앱이나 관리자 화면에서 그 글을 열어 표의 숫자와 비교합니다. 이번에 공유 10을 찾은 것도 표가 아니라 앱을 직접 열어 봤기 때문입니다.
2. API를 직접 불러 봅니다. 수집기를 거치지 않고 metric=shares 를 넣어 같은 글을 조회합니다. 2026년 9월 4일에 직접 불렀을 때 그 글은 조회 1,202, 좋아요 11, 답글 0, 리포스트 1, 인용 0, 공유 10이었고, 같은 주 나머지 4편은 공유가 실제로 0이었습니다.
3. 수집 목록을 확인합니다. 수집 코드가 요청하는 지표 목록에 그 이름이 있는지 봅니다. 없으면 API 문제가 아니라 수집 쪽 누락입니다.
4. 저장하는 표에 칸이 있는지 봅니다. 요청 목록에 넣어도 저장할 칸이 없으면 값이 버려집니다. 제 경우는 둘 다 없었습니다.

안 잰 지표가 0으로 보이는 이유

대시보드의 0에는 두 가지 뜻이 섞여 있습니다. 실제로 값이 0인 것과, 재지 않아서 0으로 찍힌 것입니다. 표는 빈 항목을 따로 표시하지 않고 0이나 공백으로 채우는 경우가 많아서, 같은 자리에 같은 0이 적히면 만든 사람도 읽는 사람도 “공유가 없었구나”로 넘어갑니다. 원본을 열어 보기 전에는 알아챌 방법이 없습니다.

하필 빠진 공유가 그 주에 가장 눈여겨볼 숫자였습니다. 조회와 좋아요는 피드 안에서 끝나는 반응이지만 공유는 글을 다른 사람에게 직접 보내는 행동이라 도달 범위 밖으로 나가는 신호입니다. 그 주 다섯 편 중 공유가 나온 건 그 글 하나였는데, 표에서는 그 차이가 전혀 보이지 않았습니다.

빠진 지표를 막는 점검 세 가지

Threads만의 문제는 아닙니다. 매출, 방문자, 문의 수처럼 남의 서비스에서 숫자를 끌어오는 대시보드라면 어디서든 생깁니다.

• 제공 목록과 수집 목록을 나란히 놓습니다. 공식 문서의 지표 목록과 내가 요청하는 목록을 한 번 대조하면, 빠진 항목이 지금 0으로 찍히고 있는 후보입니다.
• 안 재는 칸은 0 대신 ”—“로 채웁니다. 그러면 실제로 0인 칸과 아직 재지 않은 칸이 표에서 바로 갈립니다. 수집 코드 쪽도 같은 원칙으로, API가 어떤 지표를 안 주면 실패시키지 말고 비워(null) 둡니다. 지표 하나 때문에 나머지 적재까지 막히면 안 됩니다.
• 한 달에 한 번은 원본 화면을 엽니다. 표에 적힌 숫자 몇 개를 골라 원본과 맞춰 봅니다.

과거 글 공유 수를 다시 채울 때 주의할 점

인사이트 API는 조회하는 시점의 누적값을 줍니다. 그래서 과거 글도 지금 조회하면 공유 값을 받을 수 있습니다. 데이터를 못 쓰는 게 아니라 안 가져오고 있었던 것입니다. 9월 13일에 다시 조회했을 때도 그 글의 공유는 10 그대로였습니다.

지금 받은 값을 “발행 24시간 뒤”, “7일 뒤” 같은 기존 시점 칸에 넣으면 안 됩니다. 사흘 뒤에 잰 값을 24시간 시점 값이라고 적으면 기록이 틀려지기 때문입니다. 그래서 수정 작업지시서에는 기존 칸은 건드리지 않고, 잰 시각이 같이 남는 “최신값” 칸을 따로 만들어 글마다 한 줄씩 채우는 방식으로 적었습니다. 삭제된 글처럼 조회에 실패하는 글이 있어도 그 글만 건너뛰고 나머지는 계속 채우게 했습니다.

수집기에서 조용히 빠지는 문제는 만료된 토큰 때문에 자동화가 닷새 동안 안 돈 일과 같은 종류입니다. 에러가 나지 않으니 아무도 모르고 넘어갑니다. 지표 화면을 배포해 놓고 수집기가 2주 동안 3건만 넣은 일은 회사 시스템 넉 달 치를 DB에서 세어 본 글에 적었습니다.