Social Media Profile Finder
대부분의 크리에이터는 여러 SNS에서 활동하며, 그 계정들을 잇는 단서는 소개란, 개인 웹사이트, 링크인바이오 페이지에 흩어져 있고 SNS마다 핸들이 다를 때도 있습니다. 이 조회는 이미 알고 있는 프로필 하나에서 출발해 크리에이터의 다른 SNS 계정을 돌려주며, 각 계정에 0부터 1까지의 점수와 서로의 프로필 링크나 같은 웹사이트처럼 동일 인물로 묶은 단서를 붙입니다.
Social Media Profile Finder API 주요 기능
- 연결된 계정마다 한 행각 행은 다른 SNS의 계정 하나를 network, username, url로 나타내므로 크리에이터의 TikTok, YouTube, X 계정이 각각 별도 레코드로 반환됩니다.
- 신뢰도 점수confidence는 해당 계정이 같은 크리에이터의 것일 가능성을 0부터 1로 나타내며, 자동 매칭 기준값을 직접 정할 수 있습니다.
- 매칭마다 근거 제공evidence에는 reciprocal_profile_link, same_handle, website_link처럼 계정을 연결한 신호가 담겨 모든 매칭의 이유를 설명할 수 있습니다.
- 모든 행에 출발 프로필source_network와 source_url에 조회한 프로필이 들어 있어 결과를 기존 크리에이터 명단과 쉽게 연결할 수 있습니다.
Social Media Profile Finder API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
url | 필수 | SNS 간 매칭을 할 크리에이터의 Instagram, TikTok, YouTube, X, Facebook 프로필 URL 하나. |
Social Media Profile Finder API 사용 방법
크리에이터 프로필 URL 하나를 보내고 다른 SNS에서 찾은 계정을 한 행씩 읽습니다.
- /v1/creator/find-social-profiles에 {"url": "https://www.instagram.com/miguelangeles"}을 POST합니다.
- status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- results.items에서 연결된 계정을 한 행씩 읽고, has_more가 true인 동안 results.next_cursor를 넘깁니다.
curl -X POST "https://api.socq.ai/v1/creator/find-social-profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.instagram.com/miguelangeles"}'Social Media Profile Finder API 추천 활용 사례
- SNS 통합 크리에이터 프로필 구축: 크리에이터를 발견한 SNS에서 출발해 TikTok, YouTube, X, Facebook 계정을 하나의 크리에이터 레코드에 추가합니다.
- 크리에이터 DB 중복 병합: 신뢰도가 높은 매칭으로 서로 다른 SNS에서 들어온 레코드가 같은 사람임을 확인하고 하나로 합칩니다.
- 모든 채널에서 캠페인 추적: 협업 크리에이터마다 다른 계정을 찾아 계약한 SNS뿐 아니라 게시하는 모든 곳에서 콘텐츠와 도달 데이터를 모읍니다.
Social Media Profile Finder API 활용 팁
- 자동 병합용 신뢰도 기준값을 정하고, 그보다 낮은 점수는 evidence와 함께 수동 검토로 넘기세요.
- 연결된 계정의 프로필 URL인 id를 키로 쓰면 같은 크리에이터의 다른 프로필에서 시작한 조회 결과도 맞춰집니다.
- evidence를 매칭 결과와 함께 저장해 두면 나중에 레코드를 검토하는 사람도 두 계정이 연결된 이유를 알 수 있습니다.
관련 API
Social Media Profile Finder API 외에 Creator의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Influencer Email Finder API — Instagram, TikTok, YouTube, X, Facebook 프로필 하나로 크리에이터가 공개한 비즈니스 이메일을 찾아 각각 발견된 페이지와 함께 반환합니다.
- Age and Gender Detection API — Instagram, TikTok, YouTube, X, Threads 프로필 사진으로 크리에이터의 연령대와 성별을 추정하고 성별 신뢰도 점수를 반환합니다.