이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.
티스토리 블로그를 운영하면서 API를 활용하여 콘텐츠를 관리하거나 외부 시스템과 연동해야 할 때, 가장 기본적이면서도 필수적인 정보가 바로 '카테고리 ID'입니다. 하지만 티스토리 관리자 페이지에서는 이 카테고리 ID를 직관적으로 찾기 어려워 많은 분들이 혼란을 겪곤 합니다. 2025년 현재, 티스토리 API를 효과적으로 사용하기 위해 카테고리 ID를 정확하고 빠르게 확인하는 방법을 총정리해 드리겠습니다. 이 글을 끝까지 읽으시면, 더 이상 카테고리 ID 때문에 API 연동에 어려움을 겪지 않으실 겁니다.
왜 티스토리 API에서 카테고리 ID가 중요할까요?
✨ Top 5 추천 제품
티스토리 API는 블로그의 다양한 기능을 프로그래밍 방식으로 제어할 수 있게 해주는 강력한 도구입니다. 글 작성, 수정, 삭제, 댓글 관리 등 여러 작업을 API를 통해 자동화할 수 있는데, 이때 각 작업의 대상이 되는 '카테고리'를 명확히 지정하기 위해 카테고리 ID가 사용됩니다.
예를 들어, 특정 카테고리에 속한 글 목록만 가져오고 싶거나, 새 글을 특정 카테고리로 발행하고 싶을 때, 해당 카테고리의 고유 ID를 알아야만 API 요청이 정상적으로 처리됩니다. ID 값이 잘못되었거나 존재하지 않는 ID를 사용하면 API 오류가 발생하며 원하는 작업을 수행할 수 없습니다.
2025년, 티스토리 API 카테고리 ID 확인 방법 A to Z
티스토리 카테고리 ID를 확인하는 방법은 크게 두 가지로 나눌 수 있습니다. 하나는 티스토리 관리자 페이지를 이용하는 방법이고, 다른 하나는 API를 직접 호출하여 확인하는 방법입니다. 두 방법 모두 유용하며, 각 상황에 맞게 선택하여 사용하시면 됩니다.
방법 1: 티스토리 관리자 페이지에서 카테고리 ID 확인하기 (가장 쉬운 방법)
가장 쉽고 직관적으로 카테고리 ID를 확인할 수 있는 방법입니다. 별도의 도구나 복잡한 절차 없이 바로 확인 가능합니다.
- 1단계: 티스토리 로그인 및 관리자 페이지 접속
먼저 티스토리 계정으로 로그인한 후, 블로그 관리자 페이지로 이동합니다. (예: `[블로그주소].tistory.com/manage`) - 2단계: '꾸미기' > '스킨 편집'으로 이동
좌측 메뉴에서 '꾸미기' 항목을 클릭하고, 하위 메뉴 중 '스킨 편집'을 선택합니다. - 3단계: HTML 편집 모드 진입
'스킨 편집' 화면에서 상단에 있는 'html 편집' 버튼을 클릭하여 HTML 편집 모드로 진입합니다. - 4단계: 카테고리 목록 확인 (HTML 코드 분석)
html 편집 화면이 나타나면, 코드 내에서<ul class="category">또는 유사한 태그를 찾아봅니다. 이 부분에 블로그의 카테고리 목록이 HTML 형식으로 나열되어 있습니다. 각 카테고리 항목(<li>)을 살펴보면,<a href="/category/카테고리명"형식으로 링크가 표시되는 것을 볼 수 있습니다. 이 링크에서/category/바로 뒤에 오는 '카테고리명'이 바로 해당 카테고리의 ID(슬러그)입니다.
주의사항:
- 티스토리 스킨이나 테마에 따라 HTML 구조가 조금씩 다를 수 있습니다.
<ul class="category">대신 다른 클래스 이름이나 구조를 사용할 수도 있으니, 'category' 또는 'menu' 등과 관련된 목록 태그를 찾아보세요. - 이 방법으로 확인되는 ID는 주로 카테고리 슬러그(slug)이며, API에서 일반적으로 사용되는 ID와 동일하게 취급됩니다.
방법 2: 티스토리 API를 직접 호출하여 카테고리 ID 확인하기 (개발자에게 유용)
개발자이거나 API 연동 작업을 진행 중이라면, API 요청을 통해 직접 카테고리 정보를 얻는 것이 더욱 효율적일 수 있습니다. 티스토리 API는 GET 요청을 통해 카테고리 목록을 반환합니다.
- 1단계: 티스토리 API 설정 및 키 발급
아직 티스토리 API를 설정하지 않았다면, '블로그 관리' > '플러그인' > 'API' 메뉴에서 API 사용 설정을 활성화하고, API 키를 발급받아야 합니다. API 키는 외부 서비스에서 블로그에 접근할 때 인증하는 데 사용됩니다. - 2단계: API 엔드포인트 확인
카테고리 목록을 가져오기 위한 API 엔드포인트는 일반적으로 다음과 같습니다.https://www.tistory.com/apis/blog/category - 3단계: API 요청 보내기 (예: CURL 사용)
아래는 CURL 명령어를 사용하여 카테고리 목록을 가져오는 예시입니다. 실제 요청 시에는 `[YOUR_ACCESS_TOKEN]`을 발급받은 액세스 토큰으로, `[YOUR_BLOG_NAME]`을 본인의 블로그 이름(예: `myblog`)으로 변경해야 합니다.
CURL 예시:
curl -v -X GET "https://www.tistory.com/apis/blog/category?access_token=[YOUR_ACCESS_TOKEN]&output=json&blogName=[YOUR_BLOG_NAME]"
-H "Accept: application/json"
- 4단계: API 응답 분석
API 요청을 보내면 JSON 형식으로 응답을 받게 됩니다. 이 응답에는 블로그의 모든 카테고리 정보가 포함되어 있으며, 각 카테고리별 ID (또는 slug)와 이름을 확인할 수 있습니다.
API 응답 예시 (JSON):
{
"tistory": {
"status": "200",
"item": {
"categories": [
{
"id": "1",
"name": "IT 정보",
"label": "it-info",
"url": "/category/it-info",
"count": 15
},
{
"id": "2",
"name": "블로그 팁",
"label": "blog-tips",
"url": "/category/blog-tips",
"count": 22
}
// ... 추가 카테고리 정보
]
}
}
}
위 응답에서 "id" 필드 값이 해당 카테고리의 API ID이며, "label" 필드 값이 앞에서 설명한 관리자 페이지에서 확인 가능한 카테고리 슬러그입니다. API 연동 시에는 주로 "id" 값을 사용하게 됩니다.
카테고리 ID 활용 팁 및 주의사항 (2025년 기준)
카테고리 ID를 정확히 아는 것만큼 중요한 것은 이를 올바르게 활용하는 것입니다. 몇 가지 팁과 주의사항을 알려드립니다.
1. 카테고리 변경 시 ID 확인 필수
블로그를 운영하다 보면 카테고리 구조를 변경하거나 이름을 바꾸고 싶을 때가 있습니다. 카테고리 이름을 변경하더라도 ID(슬러그)는 유지되는 경우가 많지만, 간혹 ID까지 함께 변경되거나 삭제 후 재생성되는 경우가 발생할 수 있습니다. 따라서 카테고리를 변경한 후에는 반드시 API 연동에 사용되는 카테고리 ID가 유효한지 다시 확인해야 합니다. API를 통해 글을 발행하거나 관리하는 경우, 이전 ID로 요청하면 오류가 발생할 수 있습니다.
2. API 키 관리의 중요성
API 키는 블로그의 핵심 정보를 제어할 수 있는 중요한 정보입니다. API 키가 노출되면 악의적인 사용자가 당신의 블로그에 접근하여 글을 삭제하거나 정보를 탈취할 위험이 있습니다. 따라서 API 키는 안전하게 관리하고, 필요한 경우에만 사용하며, 주기적으로 변경하는 것을 권장합니다.
3. 공식 문서 참고
티스토리 API는 지속적으로 업데이트될 수 있습니다. 따라서 가장 최신의 정확한 정보를 얻기 위해서는 티스토리에서 제공하는 공식 API 문서를 참고하는 것이 가장 좋습니다. API 엔드포인트, 파라미터, 응답 형식 등은 공식 문서를 통해 확인하시는 것이 오류를 줄이는 가장 확실한 방법입니다.
4. 여러 카테고리 ID를 한 번에 얻는 방법
많은 수의 카테고리를 관리하거나, API 연동 시 초기에 모든 카테고리 ID 목록을 준비해야 한다면, 위에서 설명한 '방법 2: 티스토리 API를 직접 호출'하는 것이 가장 효율적입니다. 한 번의 API 요청으로 모든 카테고리 정보를 얻어오기 때문에 반복적인 수작업을 줄일 수 있습니다.
결론: 카테고리 ID, 알고 나면 별것 아니다!
티스토리 API를 활용하는 데 있어 카테고리 ID는 마치 건물의 주소와 같습니다. 이 주소를 정확히 알아야 원하는 곳으로 데이터를 보내고 받을 수 있습니다. 2025년 현재, 티스토리 관리자 페이지의 HTML을 분석하거나 API를 직접 호출하는 두 가지 방법을 통해 카테고리 ID를 어렵지 않게 확인할 수 있습니다.
이 글에서 제시해 드린 방법을 통해 여러분의 티스토리 API 연동 작업이 한층 더 수월해지기를 바랍니다. 카테고리 ID 확인은 API 활용의 첫걸음이며, 이 기본적인 부분을 확실히 이해하고 넘어가면 앞으로 티스토리 API를 더욱 폭넓고 다양하게 활용할 수 있을 것입니다.
혹시 카테고리 ID 확인이나 API 활용에 대해 궁금한 점이 있다면 언제든지 댓글로 질문해주세요. 여러분의 성공적인 블로그 운영과 API 활용을 응원합니다!
함께 읽으면 좋은 글:
- 2025년 티스토리 API 이미지 업로드: 5분 완성 핵심 가이드
- 2025년 티스토리 API 글쓰기(post) 파이썬 예제 코드 완벽 가이드
- 2025년 티스토리 API 발급 및 인증, 1단계 자동화 완벽 가이드
