SNS API: 게시, 예약, 분석 데이터 조회

SNS API를 쓰면 평소 대시보드에서 손으로 하던 일을 내 코드로 처리할 수 있습니다. 게시물 게시와 예약, 결과 조회, 파일 관리입니다. sona.to REST API는 연결한 모든 채널에서 이 작업을 하고, SEO 도구에도 접근합니다. Free를 포함한 모든 요금제에 포함되며, REST API 페이지에 요약되어 있습니다.

sona.to API로 할 수 있는 일

API는 앱에서 다루는 것과 같은 단위로 구성되어 있습니다.

채널과 게시물

워크스페이스에 연결된 채널 목록을 가져온 뒤, 그중 하나 또는 여러 채널에 게시물을 만듭니다. 바로 게시하거나 지정한 날짜에 게시할 수 있습니다. 게시물은 조회, 검색, 수정, 삭제할 수 있고, 게시물 유형 같은 플랫폼별 옵션도 함께 보낼 수 있습니다.

파일

이미지와 동영상을 미디어 라이브러리에 업로드하고 게시물에 사용합니다. 큰 동영상은 저장소로 바로 업로드되므로, 요청 한 번의 크기 제한을 받지 않습니다.

분석

채널의 기간별 수치를 가져옵니다. 해당 채널의 분석 페이지에 표시되는 것과 같은 데이터입니다.

SEO, 순위 추적, AI 가시성

SEO 프로젝트를 만들고, 사이트 진단을 실행하고, 진단에서 찾은 페이지와 문제를 조회하고, 문제의 수정안을 생성합니다. 순위 추적에 키워드를 추가해 순위를 조회하고, AI 가시성의 프롬프트를 실행해 어떤 AI 어시스턴트가 나를 언급하는지 확인합니다.

인증 방식

대시보드에서 API 페이지를 열고 읽기 전용 또는 쓰기 권한이 있는 토큰을 만듭니다. 각 요청의 Authorization 헤더에 Bearer 토큰으로 담아 보냅니다. 토큰은 만들 때 열려 있던 워크스페이스에 속하므로, 그 워크스페이스의 데이터에만 접근합니다.

팀에서는 선택한 채널만 담당하는 멤버는 API로도 그 채널에만 접근합니다. 게시물 승인이 필요한 멤버도 게시물을 만들 수 있지만, 게시물은 게시되지 않고 "승인" 페이지로 갑니다.

API로 만드는 것들

자주 쓰는 예를 몇 가지 들어 보겠습니다.

내 CMS에 새 글이 올라오면 그 순간 채널 게시물이 됩니다. 스프레드시트에 추가한 행이 예약 게시물이 됩니다. 지난주 수치가 매주 월요일 보고용 시트에 들어갑니다. 웹사이트를 업데이트할 때마다 SEO 진단이 시작되고, 찾은 문제가 작업으로 등록됩니다.

코드 없이 API 사용하기

n8n, Make, Zapier용 sona.to 앱도 같은 API로 작동하므로, 단계를 고르는 것만으로 이런 워크플로를 만들 수 있습니다. 게시 완료나 실패처럼 무슨 일이 생겼을 때 sona.to가 내 시스템에 알려 주게 하려면 웹훅을 추가하세요. Claude나 ChatGPT에서 sona.to를 쓰려면 MCP로 연결하세요.

문서

모든 엔드포인트, 파라미터, 응답은 developers.sona.to에 정리되어 있고, 직접 실행해 볼 수 있는 예시도 있습니다. 요청은 https://api.sona.to/v1로 보냅니다.

자주 묻는 질문

sona.to API는 무료인가요?

API 접근은 Free를 포함한 모든 요금제에 포함됩니다. API로 할 수 있는 일은 앱과 마찬가지로 요금제에 따라 정해집니다.

API로 어떤 플랫폼에 게시할 수 있나요?

워크스페이스에 연결한 모든 플랫폼입니다. API는 앱과 같은 채널을 통해 게시합니다.

API로 게시물을 예약할 수 있나요?

네. 게시물과 함께 날짜와 시간을 보내면 그때 게시됩니다. 앱에서 예약한 게시물과 같습니다.