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

NOTION GUIDE

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

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

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

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

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

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

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

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

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

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

어떻게 시작하면 좋을까요

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

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

자주 묻는 질문