인스타 인플루언서 찾기, 릴스 검색 결과를 국가별로 걸러요
인스타 인플루언서 찾기를 나라별로 해 보세요. 릴스 검색에 country나 include=creator를 붙이면 크리에이터 국가와 팔로워 수가 같이 와요.
국가별 인스타 인플루언서 찾기는 /v1/instagram/search/reels에 country를 붙이면 돼요. 예를 들어 query=restaurantes&country=ES를 보내면 인스타그램 「이 계정 정보」에 스페인이 표시된 크리에이터의 릴스만 남아요. 팔로워 수와 게시물 수, 공개한 이메일도 같은 응답에 붙어요.
일반 릴스 검색으로는 크리에이터가 어느 나라 사람인지 알 길이 없어요. region은 검색어를 그 시장에 맞춰 바꾸고 include=creator는 릴스마다 크리에이터 카드를 붙여요. country는 이 둘을 합쳐 그 나라 크리에이터만 남겨요.
일반 릴스 검색은 왜 국가를 못 가리나요?
인스타그램이 밝힌 검색 신호에 국가가 없어서예요. 검색 순위 신호에서 가장 중요한 건 입력한 텍스트이고 내 활동과 인기도가 그다음이에요. 릴스 순위 설명에도 국가나 언어는 나오지 않아요.
공식 Graph API로도 풀리지 않아요. 해시태그 검색은 7일에 고유 해시태그 30개까지예요. 최근 미디어는 24시간 이내 게시물만 주고 username 필드를 받지 않아요. Business Discovery는 대상 username을 미리 알아야 하고 국가 필드가 없어요. 서비스를 고르는 중이라면 인스타그램 데이터 API 비교가 도움이 돼요.
일반 호출은 이렇게 생겼고 1크레딧이에요.
curl -s -H "x-api-key: $SOCIALCRAWL_API_KEY" \
"https://www.socialcrawl.dev/v1/instagram/search/reels?query=fitness"한 페이지에 릴스가 최대 30개 오지만 post.ext.author_country는 전부 비어 있어요. 인스타그램이 검색 응답에 팔로워 수를 더는 싣지 않아서 author_followers도 비어 있어요.
region은 검색을 어떻게 바꾸나요?
region에 ISO-2 시장 코드를 보내면 검색어가 현지화돼요. 인스타그램이 검색하는 사람의 위치로 순위를 매기지 않으니 API가 키워드 뒤에 그 시장 이름을 붙이는 방식이에요. region=ES로 fitness를 보내면 fitness españa로 검색해요. 검색어에 이미 시장 이름이 있으면 그대로 보내요. region=KR에 한글 검색어를 보낼 때도 그대로예요.
curl -s -H "x-api-key: $SOCIALCRAWL_API_KEY" \
"https://www.socialcrawl.dev/v1/instagram/search/reels?query=fitness®ion=ES"응답의 data.region이 실제로 나간 검색어를 알려 줘요.
"region": { "requested": "ES", "method": "localised_query", "query_sent": "fitness españa" }region은 추가 비용이 없고 그 시장 크리에이터가 더 많이 걸리게 해 줘요. 다만 전부 그 나라 크리에이터라는 보장은 없어요. 바뀌는 건 어떤 릴스가 오느냐뿐이에요. 누가 만들었는지는 include=creator로 확인하세요.
릴스마다 크리에이터 프로필을 받으려면?
include=creator를 보내면 돼요. 크리에이터의 「이 계정 정보」 패널에서 읽은 값이 릴스 행마다 붙어서 프로필을 하나씩 열 필요가 없어요.
curl -s -H "x-api-key: $SOCIALCRAWL_API_KEY" \
"https://www.socialcrawl.dev/v1/instagram/search/reels?query=fitness®ion=ES&include=creator"data.items의 각 항목은 릴스를 post 객체로 감싸요. 줄여 보면 이런 모양이에요. 값은 설명용이고 이메일은 가렸어요.
{
"post": {
"url": "https://www.instagram.com/reel/ABC123xyz/",
"author": { "username": "example_creator" },
"engagement": { "views": 78000, "likes": 5200, "comments": 38 },
"ext": {
"author_followers": 488000,
"author_country": "ES",
"author_following": 120,
"author_posts_count": 292,
"author_public_email": "[공개됨, 가림]"
}
}
}| 필드 | 뜻 |
|---|---|
author_country | 크리에이터가 「이 계정 정보」에 표시한 국가의 ISO 코드(예: ES). 공개하지 않으면 null |
author_followers | 팔로워 수 |
author_following, author_posts_count | 팔로잉 수와 게시물 수 |
author_public_email, author_public_phone | 크리에이터가 공개한 연락처만 |
응답에는 data.hydration 블록도 붙어서 행 수, 조회 건수, 크레딧이 나와요. include=creator는 행을 빼거나 더하거나 순서를 바꾸지 않아요. 크리에이터를 조회하는 만큼 일반 검색보다는 느려요. 공개 이메일만 따로 다룬 내용은 인스타 이메일 찾기 글에 있어요.
크리에이터 국가는 정확히 무엇인가요?
post.ext.author_country는 인스타그램이 크리에이터의 「이 계정 정보」 패널에 보여 주는 국가예요. 인스타그램은 가장 자주 쓰는 접속 IP, 기기와 앱의 지역 설정, 특정 지역에서 자주 활동하는지를 보고 국가를 정해요. 계정 주인은 직접 바꿀 수 없어요(Metricool 도움말). 인스타그램이 공개하지 않은 계정은 null이고 추측으로 채우지 않아요.
인플루언서를 찾을 때 '국가'는 세 가지 뜻으로 쓰여서 헷갈리기 쉬워요. country가 맞추는 건 첫 번째뿐이에요.
| 구분 | 뜻 | 어디서 정해지나 |
|---|---|---|
| 크리에이터 국가 | 계정이 기반을 둔 곳 | 인스타그램이 패널에 표시하는 추정값 |
| 릴스 위치 | 릴스를 올리며 붙인 장소 | 업로드할 때 고르는 선택형 위치 태그 |
| 팔로워 위치 | 팔로워가 있는 곳 | 계정 주인만 보는 인사이트, 외부 추정치 |
한 나라 크리에이터만 남기려면?
region 대신 country를 보내요. 둘을 같이 보낼 필요는 없어요. country가 검색어 현지화까지 알아서 해요.
curl -s -H "x-api-key: $SOCIALCRAWL_API_KEY" \
"https://www.socialcrawl.dev/v1/instagram/search/reels?query=restaurantes&country=ES"country는 크리에이터 국가를 알아야 해서 include=creator와 같은 조회를 해요. 조회가 끝나면 그 시장이 표시된 크리에이터의 릴스만 남기고 몇 개를 버렸는지도 알려 줘요.
"region": { "requested": "ES", "method": "localised_query", "query_sent": "restaurantes españa" },
"country": { "requested": "ES", "kept": 24, "dropped_other": 2, "dropped_unknown": 4 },
"hydration": { "implied_by": "country" }implied_by가 country이면 크리에이터 조회가 country 때문에 붙었다는 뜻이에요. dropped_other는 다른 나라 크리에이터의 행이고 dropped_unknown은 국가를 공개하지 않은 크리에이터의 행이에요. 국가를 모르는 계정은 맞는다고 보지 않고 버려요. 맞는 크리에이터가 하나도 없으면 200 응답에 빈 items와 country_no_match 경고가 오고 조회한 만큼은 그대로 과금돼요. 위의 숫자는 설명용이에요.
식당이나 스킨케어처럼 현지 주제는 이 방식이 잘 통해요. 여행이나 eSIM처럼 방문자가 주로 올리는 주제는 현지 크리에이터가 적게 나와요. 그럴 때는 현지인이 쓰는 표현(esim보다 esim móvil)으로 검색하고 거르는 일은 country에 맡기세요. 결과는 인스타그램의 관련도 순위라 호출마다 달라져요. post.id로 중복을 지우고 engagement.views로 직접 정렬하세요.
지원하는 시장과 크레딧은?
시장은 ISO-2 코드로 ES, MX, DE, BR, KR, FR, ZA, NG, KE, AE, SA 11곳이에요. US를 비롯한 다른 코드를 보내면 크레딧 차감 없이 400이 오고 쓸 수 있는 값을 알려 줘요.
| 요청 | 페이지당 크레딧 |
|---|---|
| 일반 검색 | 1 |
region | 1 |
include=creator | 1에 조회한 크리에이터 1명당 2, 최대 61 |
country | 1에 조회한 크리에이터 1명당 2, 최대 61, 남기든 버리든 과금 |
include=country | 1에 국가가 확인된 크리에이터 1명당 1, 최대 31 |
include=country는 author_country만 주고 팔로워 수나 연락처는 주지 않아요. 행에 국가만 붙이면 될 때 더 저렴하고 search/hashtag와 location/posts에서도 똑같이 써요. 같은 크리에이터의 릴스가 두 개 있어도 조회는 한 번이고 찾지 못한 크리에이터는 환불돼요. 15분 안에 조회한 크리에이터는 무료라서 같은 검색을 다시 보내면 비용이 줄어요. include=country는 이 기간이 30일이에요. max_pages로 여러 페이지를 받아도 크리에이터마다 한 번만 조회하고 과금해요. 전체 파라미터는 인스타그램 문서에 있어요.
인플루언서 마케팅 플랫폼과는 어떻게 다른가요?
인플루언서 마케팅 플랫폼과 크리에이터 DB는 직접 모아 둔 크리에이터 색인 안에서 걸러요. Modash는 크리에이터의 거주 국가와 오디언스 위치를 별도 필터로 둬요. HypeAuditor는 댓글 다는 사람을 중심으로 오디언스 위치를 추정해요. 오디언스가 어디 있는지 추정하는 건 이런 도구의 일이고 이 호출은 하지 않아요.
이 호출은 지금 올라오는 주제별 릴스에서 출발해 행마다 크리에이터 카드를 붙여 줘요. 오디언스 인구통계나 섭외 관리 기능이 필요하면 마케팅 플랫폼이 맞아요. 한 시장의 새 크리에이터를 데이터로 받아 자체 도구에 넣으려면 이 호출이 맞아요.
틱톡의 country, region과 같은 옵션인가요?
region과 country는 두 플랫폼에서 이름도 뜻도 같고 ISO-2 코드를 써요. 지원하는 시장과 동작 방식은 달라요. 인스타그램은 검색어를 현지화해요(data.region.method에 나와요). 틱톡은 그 시장에서 직접 검색해요. 인스타그램은 조회한 크리에이터 수만큼 과금하기도 해요. 틱톡 쪽은 틱톡 국가별 크리에이터 찾기와 틱톡 영상 검색 API의 region에 적었어요. API 키는 같은 것을 써요.
이 호출이 못 하는 것은?
- 릴스를 어디서 찍었는지와 팔로워가 어디 사는지는 알려 주지 않아요.
- 오디언스 인구통계는 주지 않아요.
- 인스타그램 순위가 바뀌어서 다시 보내면 같은 크리에이터가 나온다는 보장이 없어요.
직접 해 보려면?
새 계정에는 무료 크레딧 100개가 있고 카드는 필요 없어요(요금). 키는 x-api-key로 보내요. 저장된 응답 대신 새 응답을 받으려면 Cache-Control: no-cache를 붙이세요.
curl -s -H "x-api-key: $SOCIALCRAWL_API_KEY" \
-H "Cache-Control: no-cache" \
"https://www.socialcrawl.dev/v1/instagram/search/reels?query=fitness®ion=ES&include=creator" \
| jq '[.data.items[].post.ext.author_country] | group_by(.) | map({(.[0] // "null"): length}) | add'끝의 jq 한 줄이 크리에이터 국가별로 릴스 개수를 세요. 코드를 쓰기 전에 응답부터 보려면 비주얼 익스플로러에 같은 경로를 넣어 보세요. 찾은 릴스의 조회수와 저장 수를 받는 방법은 릴스 조회수와 저장 수 받기에 있어요.
자주 묻는 질문
인스타 릴스를 국가별로 검색할 수 있나요?
11개 시장에서 돼요. region은 검색어에 그 시장 이름을 붙여 검색하고 country는 「이 계정 정보」에 그 나라가 표시된 크리에이터의 릴스만 남겨요.
어느 나라까지 지원하나요?
ES(스페인), MX(멕시코), DE(독일), BR(브라질), KR(한국), FR(프랑스), ZA(남아프리카공화국), NG(나이지리아), KE(케냐), AE(아랍에미리트), SA(사우디아라비아) 11개 시장이에요. US를 비롯한 다른 코드는 크레딧 차감 없이 400이 오고 쓸 수 있는 값을 알려 줘요.
국가별로 인스타 인플루언서를 찾으려면 어떻게 하나요?
/v1/instagram/search/reels에 주제와 country를 보내세요. 그 나라로 표시된 크리에이터의 릴스만 남고 팔로워 수, 게시물 수, 공개된 이메일과 전화번호가 같이 와요.
프로필을 하나씩 열지 않고 국가와 팔로워 수를 받을 수 있나요?
include=creator를 붙이면 돼요. 릴스마다 post.ext.author_country와 author_followers가 채워져요. 1크레딧짜리 페이지에 크리에이터 1명당 2크레딧이 더 붙어요.
인스타그램 공식 API(그래프 API)로 릴스를 국가별로 검색할 수 있나요?
공식 문서에서 확인한 범위로는 안 돼요. 해시태그 검색은 7일에 고유 해시태그 30개까지예요. 최근 미디어는 24시간 이내 게시물만 주고 username 필드를 받을 수 없어요. Business Discovery는 대상 username을 알아야 하고 국가 필드가 없어요.
크리에이터 프로필까지 붙여 검색하면 크레딧이 얼마나 드나요?
일반 검색과 region은 페이지당 1크레딧이에요. include=creator나 country를 쓰면 여기에 조회한 크리에이터 1명당 2크레딧이 붙어서 릴스 30개짜리 한 페이지는 최대 61크레딧이에요. country는 남기든 버리든 조회한 만큼 과금하고 찾지 못한 크리에이터는 환불해요. 15분 안에 조회한 크리에이터는 무료예요.
크리에이터 국가는 릴스를 찍은 장소인가요?
아니에요. author_country는 인스타그램이 크리에이터의 「이 계정 정보」 패널에 표시하는 국가예요. 촬영 장소도 팔로워가 사는 곳도 아니에요. 인스타그램이 공개하지 않으면 null이고 SocialCrawl은 추측하지 않아요.
릴스 검색에서 크리에이터의 공개 이메일도 받을 수 있나요?
크리에이터가 공개한 경우에만 받아요. include=creator는 연락처를 공개한 계정에만 author_public_email과 author_public_phone을 채워요. 공개된 연락처라도 개인정보 보호 규정에 맞게 다루세요.
틱톡 검색의 country, region과 똑같이 쓰나요?
이름, ISO-2 코드 형식, 뜻은 같고 방식이 달라요. 인스타그램은 검색어를 현지화하고 크리에이터 조회 수만큼 과금해요. 틱톡은 그 시장에서 검색해요.
함께 읽으면 좋은 글
페이스북 댓글 크롤링, 게시물 25개를 한 번에 읽어요
페이스북, 인스타그램, 틱톡, 유튜브 게시물 25개의 댓글을 API 호출 한 번으로 읽어요. since를 넣으면 새 댓글만 읽고 새 댓글이 없으면 크레딧도 들지 않아요.
인플루언서 검색 API: 팔로워가 아니라 조회수로 크리에이터 고르기
인플루언서 검색 API 한 번으로 주제와 국가, 규모에 맞는 크리에이터를 찾아요. 최근 게시물에서 잰 중간 조회수로 순위를 매기고 드라이런으로 비용도 미리 확인해요.
틱톡과 유튜브 이메일 찾기 API, include=contacts 한 줄로
프로필 호출에 include=contacts를 붙이면 크리에이터가 공개한 비즈니스 이메일과 출처가 와요. 결과 상태 다섯 가지와 재시도, 크레딧 규칙까지 담았어요.
