노션 데이터베이스 ID 확인하는 방법 (API·자동화 연동 전 필수 확인)

이이웍스 · 2026-08-11 · 6분

<p class="chapter-label">NOTION GUIDE</p>

<p class="lead">API 연동이나 자동화 툴을 설정하려는데 데이터베이스 ID를 어디서 찾는지 모르겠고, URL이 너무 길어서 어디까지가 ID인지 헷갈리고, 인라인 데이터베이스라 URL에 ID가 아예 안 보이는 것 같아 막막했다면, 구조만 알면 30초 안에 끝나는 일이에요.</p>

<p>이 글에서는 노션 데이터베이스 ID를 URL에서 바로 찾는 방법, 인라인 데이터베이스처럼 안 보일 때 해결하는 방법, 그리고 API로 직접 찾는 방법까지 안내합니다.</p>

<div class="quote-callout"><div class="quote-line"><span class="quote-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8"><path d="M4 4h16v11H8l-4 4V4z" stroke-linejoin="round"/></svg></span>“API 연동하려는데 데이터베이스 ID를 어디서 찾는지 모르겠어요.”</div><div class="quote-line"><span class="quote-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8"><path d="M4 4h16v11H8l-4 4V4z" stroke-linejoin="round"/></svg></span>“URL이 너무 길어서 어디까지가 ID인지 감이 안 와요.”</div><div class="quote-line"><span class="quote-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8"><path d="M4 4h16v11H8l-4 4V4z" stroke-linejoin="round"/></svg></span>“인라인 데이터베이스라서 그런지 URL에 ID가 안 보여요.”</div><div class="quote-line"><span class="quote-icon"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8"><path d="M4 4h16v11H8l-4 4V4z" stroke-linejoin="round"/></svg></span>“자동화 툴에 ID를 넣었는데 계속 오류가 나요.”</div></div>

<h2>ID를 못 찾는 진짜 이유는 URL 구조를 모르기 때문이에요</h2>

<p>노션 데이터베이스를 전체 페이지로 열면, 주소창의 URL은 대략 <strong>워크스페이스 이름 / 데이터베이스 ID ? v=뷰 ID</strong> 순서로 구성돼요. 문제는 이 문자열이 하이픈도 없이 32자가 쭉 이어지다 보니, 어디서부터 어디까지가 진짜 ID인지 한눈에 안 들어온다는 점이에요.</p>

<p><span class="accent">"/" 다음부터 "?" 직전까지</span>가 데이터베이스 ID예요. 그 뒤에 <strong>?v=</strong>로 시작하는 부분은 데이터베이스 ID가 아니라 현재 보고 있는 뷰(view)의 ID라서, 이 둘을 섞어서 복사하면 API 연동이나 자동화 설정에서 계속 오류가 나요.</p>

<p>또 하나 헷갈리는 지점은 <strong>인라인 데이터베이스</strong>예요. 페이지 안에 삽입된 형태로 쓰고 있으면 URL에 데이터베이스 ID가 바로 노출되지 않는데, 이건 ID가 없는 게 아니라 아직 전체 페이지로 열지 않아서예요.</p>

<div class="cta-box"><p class="cta-line">API 연동까지 직접 세팅하기 번거롭다면</p><p class="cta-line cta-bold">이미 구조가 잡힌 템플릿부터 시작하세요</p><a href="https://eeworks.co.kr/template/ae06c99d-2df9-47ea-b1f8-3d0f6cabf932" class="cta-button">템플릿 보러가기</a></div>

<p>가장 빠른 방법이에요. 아래 순서만 그대로 따라 하면 됩니다.</p>

<div class="mockup"><p class="mockup-caption">노션 데이터베이스 URL 구조 예시</p><div class="mockup-tree"><div class="lv0">https://www.notion.so/{워크스페이스명}/</div><div class="lv1">d9824bdc844543 27be8b5b47500af6ce<span class="mockup-tag">(데이터베이스 ID · 32자)</span></div><div class="lv1">?v=7752d01c4f30441eb10da5a95394c04<span class="mockup-tag">(뷰 ID · 데이터베이스 ID 아님)</span></div></div></div>

<div class="tip-card"><div class="tip-num">1</div><div class="tip-body"><h3 class="tip-title">데이터베이스를 전체 페이지로 열기</h3><p class="tip-desc">인라인 데이터베이스라면 오른쪽 위의 화살표(⤢) 아이콘을 눌러 전체 페이지로 먼저 열어주세요.</p></div></div><div class="tip-card"><div class="tip-num">2</div><div class="tip-body"><h3 class="tip-title">주소창의 URL 복사하기</h3><p class="tip-desc">브라우저 주소창을 클릭해 전체 URL을 복사하거나, 공유 메뉴에서 "링크 복사"를 눌러도 같은 URL을 얻을 수 있어요.</p></div></div><div class="tip-card"><div class="tip-num">3</div><div class="tip-body"><h3 class="tip-title">"/" 다음부터 "?" 직전까지만 잘라내기</h3><p class="tip-desc">하이픈 없이 32자, 또는 하이픈이 포함된 36자 형태 둘 다 노션 API에서 동일하게 인식하니 그대로 쓰면 됩니다.</p></div></div>

<p>페이지 안에 삽입된 인라인 데이터베이스는 그 상태 그대로는 URL에 ID가 드러나지 않아요. 데이터베이스 오른쪽 위에 있는 화살표 아이콘을 눌러 "전체 페이지로 열기"를 하면, 그 순간부터는 일반 데이터베이스 페이지와 똑같이 URL에서 ID를 확인할 수 있어요.</p>

<p>복사한 ID로 계속 오류가 난다면, 노션 API의 검색(Search) 엔드포인트로 직접 찾는 방법도 있어요. 객체 타입을 데이터베이스로 지정해서 검색하면 연결된 인테그레이션이 접근 가능한 데이터베이스 목록과 각각의 정확한 ID를 응답으로 받을 수 있어요. 이 방법은 복잡한 중첩 페이지 구조나 뷰가 여러 개 겹쳐 있어서 URL만으로는 헷갈릴 때 특히 유용해요.</p>

<p>참고로 API가 404 오류를 반환한다면 ID 자체보다 <strong>연결(Share) 설정</strong>이 문제일 가능성이 높아요. 데이터베이스 우측 상단의 공유 메뉴에서 사용 중인 인테그레이션이 연결되어 있는지부터 확인해보세요.</p>

<p>처음부터 API 문서를 다 읽으려고 하지 않아도 돼요. 지금 당장 필요한 게 자동화 툴 하나 연결하는 거라면, 이 글에서 다룬 URL 확인 방법만으로도 충분해요. 그러다 여러 데이터베이스를 다뤄야 하는 상황이 오면 그때 검색 API를 살펴보는 정도로 순서를 잡으시면 됩니다.</p>

<p>자동화나 연동까지 고려하고 계시다면, 속성 구조가 이미 정리되어 있는 ee works 노션 템플릿에서 시작하는 것도 시행착오를 줄이는 방법이에요.</p>

<h2>자주 묻는 질문</h2><div class="faq-item"><h3 class="faq-q">Q. 데이터베이스 ID와 뷰 ID는 다른 건가요?</h3><p class="faq-a">네, 서로 달라요. URL에서 "/" 다음부터 "?" 직전까지가 데이터베이스 ID이고, "?v=" 뒤에 오는 값은 현재 보고 있는 화면(뷰)의 ID예요. API 연동에는 데이터베이스 ID를 써야 해요.</p></div><div class="faq-item"><h3 class="faq-q">Q. ID를 복사했는데 API가 계속 404 오류를 반환해요.</h3><p class="faq-a">ID 자체는 맞는데 인테그레이션이 해당 데이터베이스에 연결되어 있지 않을 때 자주 나는 오류예요. 데이터베이스의 공유 메뉴에서 사용 중인 인테그레이션을 추가했는지 확인해보세요.</p></div><div class="faq-item"><h3 class="faq-q">Q. 하이픈이 있는 ID와 없는 ID, 둘 다 써도 되나요?</h3><p class="faq-a">네, 노션 API는 하이픈이 포함된 36자 형식과 하이픈이 없는 32자 형식을 모두 같은 값으로 인식해요. URL에서 복사한 그대로 쓰면 됩니다.</p></div><div class="faq-item"><h3 class="faq-q">Q. 인라인 데이터베이스는 왜 URL에 ID가 안 보이나요?</h3><p class="faq-a">인라인 상태에서는 페이지 URL만 보이기 때문이에요. 데이터베이스 오른쪽 위의 화살표 아이콘으로 전체 페이지로 열면 그때부터 URL에 데이터베이스 ID가 나타나요.</p></div>

<div class="cta-box"><p class="cta-line">연동까지 고민 중이라면</p><p class="cta-line cta-bold">구조부터 잡힌 템플릿으로 시작하세요</p><a href="https://eeworks.co.kr/template/ae06c99d-2df9-47ea-b1f8-3d0f6cabf932" class="cta-button">템플릿 보러가기</a></div>

</div>