플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Snapchat 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
프로필profile | 핸들이나 프로필 링크로 Snapchat 크리에이터 또는 비즈니스 계정을 조회합니다. | 요청 1,000개당 $1.39 | 정상 |
스토리stories | Snapchat 계정에 현재 게시된 Story를 가져오며, 스토리 ID, 제목, 미디어 링크, 썸네일, 게시 시각을 제공합니다. | 요청 1,000개당 $1.39 | 정상 |
사용자 게시물user_posts | Snapchat 계정의 Spotlight 동영상을 수집하며, 캡션, 미디어 링크, 길이, 크기, 조회·공유·댓글·부스트·추천 수를 제공합니다. | 요청 1,000개당 $1.39 | 정상 |
동영상 상세 정보video | 정확한 동영상 링크로 Snapchat Spotlight 동영상 하나를 가져옵니다. | 요청 1,000개당 $1.39 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Snapchat 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
profile프로필 핸들이나 프로필 링크로 Snapchat 크리에이터 또는 비즈니스 계정을 조회합니다. 소개, 계정 유형, 카테고리, 구독자 수, Lens·Highlight·Spotlight 수를 받을 수 있습니다. | username | — | Sync 응답 | — | 요청 1,000개당 $1.39 | business_profile_id · username · display_name · bio · profile_type · category · subcategory · subscriber_count · is_verified · website · address · has_story · lens_count · highlight_count · spotlight_count · url · avatar_url · snapcode_url · hero_image_url · created_at · platform · related_accounts |
stories스토리 Snapchat 계정에 현재 게시된 Story를 가져오며, 스토리 ID, 제목, 미디어 링크, 썸네일, 게시 시각을 제공합니다. 친구 전용 Story는 가져올 수 없으며, Story 공개 기간 전체를 포괄한다는 보장은 없습니다. | username | — | Sync 응답 | — | 요청 1,000개당 $1.39 | id · story_id · story_title · media_url · thumbnail_url · posted_at · username · author_name · author_url · platform |
user_posts사용자 게시물 Snapchat 계정의 Spotlight 동영상을 수집하며, 캡션, 미디어 링크, 길이, 크기, 조회·공유·댓글·부스트·추천 수를 제공합니다. 길이는 밀리초 단위이며, 채팅과 전체 과거 게시물은 포함되지 않습니다. | username | — | Sync 응답 | — | 요청 1,000개당 $1.39 | id · url · title · text · summary · caption · media_url · thumbnail_url · duration_ms · width · height · view_count · share_count · comment_count · boost_count · recommend_count · posted_at · username · author_name · author_url · platform |
video동영상 상세 정보 정확한 동영상 링크로 Snapchat Spotlight 동영상 하나를 가져옵니다. 캡션, 해시태그, 조회수, 공유 수, 길이, 크리에이터 이름과 프로필을 받을 수 있습니다. 프로필 링크와 add/ 링크는 여기서 허용되지 않습니다. 미디어 링크가 영구적인 접근이나 재사용 권리를 보장하지는 않습니다. | url | spotlight_url | Sync 응답 | — | 요청 1,000개당 $1.39 | id · url · text · hashtags · view_count · share_count · duration_ms · posted_at · thumbnail_url · media_url · username · author_name · author_url · author_avatar_url · platform |
Snapchat profile 파라미터는 각각 무엇을 의미하나요?
핸들이나 프로필 링크로 Snapchat 크리에이터 또는 비즈니스 계정을 조회합니다. 소개, 계정 유형, 카테고리, 구독자 수, Lens·Highlight·Spotlight 수를 받을 수 있습니다. has_story는 지금 볼 수 있는 Story가 있는지를 나타냅니다. 비공개 Snap, 연락처, 법적 신원은 다루지 않습니다.
username필수- 공개 크리에이터 핸들을 지정하며, 사용자 이름(
@접두사는 선택) 또는 snapchat.com 프로필 전체 URL을 받습니다.profile에서는 공개 프로필 데이터를,stories에서는 현재 공개 스토리를,user_posts에서는 Spotlight 짧은 동영상을 가져옵니다. 비공개 채팅과 친구에게만 공개된 스토리에는 접근할 수 없습니다.Snapchat: 공개 프로필, 비즈니스 프로필, Snap Star 구분하기 — 공식 문서는 공개 프로필(Public Profile)을 개인 계정과 구분하며, 공개 프로필이 있다고 해서 비즈니스 프로필이나 Snap Star 자격이 주어지지는 않는다고 설명합니다. 이는 계정 유형과 자격 범위를 정의할 뿐이며, 웹 인터페이스의 모든 기능을 이 엔드포인트로 확장하지는 않습니다. · 확인일
Snapchat stories 파라미터는 각각 무엇을 의미하나요?
Snapchat 계정에 현재 게시된 Story를 가져오며, 스토리 ID, 제목, 미디어 링크, 썸네일, 게시 시각을 제공합니다. 친구 전용 Story는 가져올 수 없으며, Story 공개 기간 전체를 포괄한다는 보장은 없습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- 공개 크리에이터 핸들을 지정하며, 사용자 이름(
@접두사는 선택) 또는 snapchat.com 프로필 전체 URL을 받습니다.profile에서는 공개 프로필 데이터를,stories에서는 현재 공개 스토리를,user_posts에서는 Spotlight 짧은 동영상을 가져옵니다. 비공개 채팅과 친구에게만 공개된 스토리에는 접근할 수 없습니다.Snapchat: 공개 스토리와 친구 전용 스토리의 범위 차이 — 공식 문서에 따르면 현재 게시 중인 공개 스토리(Public Stories)는 공개 프로필 페이지에서 볼 수 있지만, My Story · Friends는 친구에게만 공개됩니다. EveryInfra는 현재 공개된 스토리 범위만 다루며, 친구 전용 스토리나 만료된 과거 콘텐츠를 가져오는 것은 보장하지 않습니다. · 확인일
Snapchat user_posts 파라미터는 각각 무엇을 의미하나요?
Snapchat 계정의 Spotlight 동영상을 수집하며, 캡션, 미디어 링크, 길이, 크기, 조회·공유·댓글·부스트·추천 수를 제공합니다. 길이는 밀리초 단위이며, 채팅과 전체 과거 게시물은 포함되지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태username필수- 공개 크리에이터 핸들을 지정하며, 사용자 이름(
@접두사는 선택) 또는 snapchat.com 프로필 전체 URL을 받습니다.profile에서는 공개 프로필 데이터를,stories에서는 현재 공개 스토리를,user_posts에서는 Spotlight 짧은 동영상을 가져옵니다. 비공개 채팅과 친구에게만 공개된 스토리에는 접근할 수 없습니다.Snapchat: Spotlight는 독립된 공개 콘텐츠 허브다 — 공식 문서는 Spotlight를 커뮤니티의 Snap을 찾아볼 수 있는 중심 허브로 정의하며, 웹에서도 볼 수 있다고 설명합니다. 이 정의는 콘텐츠 유형만 다루며, 이 엔드포인트에서 Spotlight 검색, 업로드, 전체 트렌드 필터링을 사용할 수 있다는 의미는 아닙니다. · 확인일
Snapchat video 파라미터는 각각 무엇을 의미하나요?
정확한 동영상 링크로 Snapchat Spotlight 동영상 하나를 가져옵니다. 캡션, 해시태그, 조회수, 공유 수, 길이, 크리에이터 이름과 프로필을 받을 수 있습니다. 프로필 링크와 add/ 링크는 여기서 허용되지 않습니다. 미디어 링크가 영구적인 접근이나 재사용 권리를 보장하지는 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수video액션에 필요한 Spotlight 동영상의 정확한 URL을 지정합니다. 동영상 전용 엔드포인트에서는 프로필 링크나add/링크로 대체할 수 없습니다. 프로필 관련 액션에서는 전체 URL이 크리에이터 사용자 이름을 파싱하기 위한 보조 입력으로만 쓰입니다.Snapchat Spotlight: 총 조회수와 순 시청자 수는 따로 봐야 한다 — 공식 문서는 총 재생 시작 수(Views)를 순 시청자 수(Viewers), 공유 수, 댓글 수와 구분합니다. EveryInfra의 view_count 파라미터를 순 시청자 수로 재정의해서는 안 되며, 대시보드의 시청 시간, 시청자 인구통계, 권한이 있는 공유에 대한 추가 지표는 이 엔드포인트의 보장 범위에 포함되지 않습니다. · 확인일spotlight_url선택video액션의 보조 호환용 입력으로,url보다 우선순위가 낮습니다. 일반적인 공개 동영상 요청에는url을 직접 입력하세요.
Snapchat API 사용 방법
- 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
- 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
- 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
- 04애플리케이션에 필요한 응답 필드를 저장합니다.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"snapchat","action":"profile","params":{"username":"<username>"}}'
Snapchat API 자주 묻는 질문
Snapchat API로 무엇을 가져올 수 있나요?
platform을 snapchat 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 프로필, 스토리, 사용자 게시물 및 동영상 상세 정보입니다. 각 액션 이름은 서로 다른 Snapchat 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Snapchat profile 요청에는 어떤 입력이 필요한가요?
공개 크리에이터 핸들을 지정하며, 사용자 이름(@ 접두사는 선택) 또는 snapchat.com 프로필 전체 URL을 받습니다. profile에서는 공개 프로필 데이터를, stories에서는 현재 공개 스토리를, user_posts에서는 Spotlight 짧은 동영상을 가져옵니다. 비공개 채팅과 친구에게만 공개된 스토리에는 접근할 수 없습니다. params 안의 username 필드로 전달하세요.
Snapchat profile 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 business_profile_id, username, display_name 및 bio입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Snapchat 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.