Python에서 하나 이상의 공개 프로필 사용자 이름, URL 또는 숫자형 사용자 ID를 Requests 라이브러리로 Datablist의 **Instagram Followers Scraper API**에 전송하면 Instagram 팔로워를 스크래핑할 수 있습니다. API는 팔로워 레코드를 JSON으로 반환하며, 각 관계가 어느 소스 프로필에서 생성됐는지도 표시합니다.

이 가이드에서는 장거리 하이커이자 영화 제작자인 Jupiter Hikes의 팔로워를 먼저 수집합니다. 그런 다음 동일한 Python 함수를 재사용해 그의 팔로워 목록을 또 다른 장거리 하이커이자 아웃도어 영화 제작자인 Darwin on the Trail의 수집된 팔로워와 비교합니다. 코드는 숫자형 Instagram 사용자 ID를 기준으로 결과를 그룹화하고, 두 목록에 모두 포함된 사용자를 찾습니다.

🔑 빠르게 핵심만 확인하기

Datablist의 Instagram Followers Scraper API를 사용하면 Python으로 공개 Instagram 프로필의 팔로워를 스크래핑할 수 있습니다. 스크래핑할 프로필을 제출하고 프로필별 제한을 설정한 다음, 리서치나 마케팅 워크플로에 활용할 수 있는 팔로워 레코드를 JSON으로 가져오세요. 시작하기 전에 Instagram에서 각 프로필의 팔로워 목록을 열람할 수 있는지 확인해야 합니다.

  • Input: Instagram 사용자 이름, 프로필 URL 또는 숫자형 사용자 ID.
  • Output: 사용자 ID, 공개된 프로필 정보, 각 팔로워의 소스 프로필이 포함된 팔로워 레코드.

💡 No-code 방식이 더 편하신가요? Datablist의 **Instagram Followers source**를 사용하면 코드를 작성하지 않고도 팔로워 행을 생성할 수 있습니다.

컬렉션 기반 Instagram 팔로워 가이드에서는 Datablist 인터페이스를 통해 같은 source를 사용하는 방법을 설명합니다. 이 가이드의 나머지 부분에서는 API에 집중합니다.

Instagram 팔로워 목록 제한 확인하기

스크래핑 요청을 제출하기 전에 대상 Instagram 프로필을 열고 Followers를 클릭하세요. 팔로워 목록을 탐색할 수 있는지 확인해야 합니다. 공개 프로필이라고 해서 Instagram이 모든 팔로워를 공개하는 것은 아닙니다.

**“Only [username] can see all followers”**라는 메시지가 표시되면 공개 프로필이어도 스크래퍼가 일부 목록만 가져올 수 있습니다. API는 Instagram이 공개한 팔로워만 가져올 수 있으며, 요청 제한을 높여도 숨겨진 팔로워에는 접근할 수 없습니다.

Levi’s Instagram 프로필에 표시된 팔로워 공개 범위 안내.
Levi’s Instagram 프로필에 표시된 팔로워 공개 범위 안내.

API 요청을 시작하기 전에 스크래핑할 프로필을 각각 확인해, 접근 가능한 팔로워 목록만으로도 작업 목적을 달성할 수 있는지 판단하세요.

Python과 Datablist API 키 설정하기

Datablist REST API는 Growth 플랜에서 이용할 수 있습니다. Source task를 실행할 때도 크레딧이 사용됩니다. 팔로워 source 비용은 실습 이후에 자세히 설명하겠습니다.

Datablist API 계정 페이지에서 Personal API Key를 생성하세요. 이 예제에서는 requests 패키지를 사용합니다. 프로젝트 폴더를 만들고 터미널에서 연 다음, 아래 명령을 실행하세요.

shell
python -m venv .venv
source .venv/bin/activate
python -m pip install requests

scrape_instagram_followers.py라는 파일을 만든 다음, 키를 DATABLIST_API_KEY 환경 변수에 저장하세요.

shell
export DATABLIST_API_KEY="your-api-key"

스크립트는 이 변수를 읽고 X-API-Key 헤더를 통해 값을 전송합니다.

Python 함수 하나로 Instagram 팔로워 스크래핑하기

첫 번째 요청에서는 장거리 하이커이자 크리에이터인 Jupiter Hikes의 사용자 이름 jupiterhikes를 사용합니다. 이 source에는 전체 프로필 URL이나 숫자형 Instagram 사용자 ID 문자열도 입력할 수 있습니다. 예를 들어 Jupiter Hikes의 숫자형 ID는 "1507518892"입니다.

아래 전체 스크립트를 scrape_instagram_followers.py에 붙여 넣으세요.

python
import json
import os
import time
import uuid
import requests
def scrape_instagram_users(
profiles,
api_key,
scraping_type="followers",
limit_per_profile=100,
):
"""Submit profiles, wait for the source task, and return all generated users."""
tasks_url = "https://api.datablist.com/v1/sources/tasks"
headers = {"X-API-Key": api_key}
unique_id = str(uuid.uuid4())
print(f"Task uniqueId: {unique_id}", flush=True)
payload = {
"sourceId": "instagram-source",
"uniqueId": unique_id,
"settings": {
"profiles": profiles,
"scrapingType": scraping_type,
"limitPerProfile": limit_per_profile,
},
}
response = requests.post(tasks_url, headers=headers, json=payload)
response.raise_for_status()
task = response.json()
task_id = task["@id"]
task_url = f"{tasks_url}/{task_id}"
print(f"Task ID: {task_id}")
while task["status"] not in ("completed", "failed", "stopped"):
time.sleep(3)
response = requests.get(task_url, headers=headers)
response.raise_for_status()
task = response.json()
print(f"Task status: {task['status']}; credits used: {task['credits']['used']}")
if task["status"] != "completed":
raise RuntimeError(
f"Task {task_id} {task['status']}: {task.get('error')}"
)
results = []
params = {"limit": 10}
while True:
response = requests.get(
f"{task_url}/results",
headers=headers,
params=params,
)
response.raise_for_status()
page = response.json()
results.extend(page["results"])
next_cursor = page["nextCursor"]
if next_cursor is None:
break
params["cursor"] = next_cursor
return results
if __name__ == "__main__":
api_key = os.environ.get("DATABLIST_API_KEY")
if not api_key:
raise RuntimeError("Set DATABLIST_API_KEY before running this script.")
profiles = ["jupiterhikes"]
follower_results = scrape_instagram_users(profiles, api_key)
print(json.dumps(follower_results, indent=2, ensure_ascii=False))

다음 명령으로 실행하세요.

shell
python scrape_instagram_followers.py

함수는 순서대로 세 종류의 API call을 실행합니다.

  1. POST /v1/sources/tasks는 source ID와 설정을 전송합니다. API는 백그라운드 task를 접수하고 task ID를 반환합니다.
  2. GET /v1/sources/tasks/{taskId}는 3초마다 task 상태를 확인합니다. Requests client는 응답을 기다리지만, task 자체는 Datablist에서 비동기 방식으로 실행됩니다.
  3. GET /v1/sources/tasks/{taskId}/results는 평면 구조의 팔로워 객체를 페이지 단위로 가져옵니다. 루프는 nextCursor가 null이 아닐 때마다 해당 값을 변경 없이 다시 전달하고, API가 null을 반환하면 종료됩니다.

예제에서는 scrapingType을 followers로 설정하고 limitPerProfile을 통해 사용자 100명을 요청합니다. 여기서 100은 정확한 결과 수가 아니라 요청 제한입니다. Provider의 페이지 경계와 task 실행 시점에 접근 가능한 사용자에 따라 실제 반환 수가 달라질 수 있습니다.

스크립트는 제출 전에 uniqueId를 출력합니다. POST 도중 연결이 끊긴 경우 이 값을 사용하면 곧바로 새로운 유료 실행을 만들지 않고 이미 접수된 task를 찾을 수 있습니다.

API의 팔로워 관계 레코드 생성 방식

Datablist는 먼저 각 사용자 이름, 전체 프로필 URL 또는 숫자형 ID를 소스 Instagram 프로필로 변환합니다. 이후 백그라운드 작업에서 팔로워 페이지를 가져오고 provider cursor를 처리합니다. 사용자가 관리할 것은 스크립트에 표시된 Datablist task와 결과 페이지 cursor뿐입니다.

동일한 소스 프로필에서 반환된 목록 안에 사용자 ID가 중복되면 하나로 정리됩니다. 같은 사용자가 제출한 두 크리에이터의 목록에 모두 포함돼 있다면 API는 관계 레코드 두 개를 유지합니다. 각 레코드에는 서로 다른 followerSourceProfile... 필드가 들어갑니다. 이 동작 덕분에 오디언스를 비교할 수 있습니다.

다음 섹션에서는 아래 필드를 사용합니다.

  • instagramUserId는 반환된 사용자를 비교할 때 사용하는 안정적인 key입니다.
  • instagramUsername, instagramFullName을 비롯한 instagram... 필드는 공개된 값이 있을 때 팔로워 정보를 제공합니다.
  • followerSourceProfileId, followerSourceProfileUsername, followerSourceProfileUrl은 출발점이 된 크리에이터를 식별합니다.

이 source는 관계 목록을 가져옵니다. 후보를 검색하거나 신뢰도 점수를 계산하지는 않습니다.

Jupiter Hikes 결과 확인하기

완료된 Jupiter Hikes task에서는 고유 팔로워 레코드 124개가 반환됐고 2.24크레딧이 사용됐습니다. 요청에는 limitPerProfile: 100을 지정했지만, 실행 중 집계가 99명에 도달한 시점에 provider가 사용자 25명이 담긴 다음 페이지를 반환했습니다. Datablist가 이 페이지 전체를 보존하면서 최종 결과는 124개가 됐습니다.

아래는 최종 결과 페이지 응답입니다. Envelope과 팔로워 객체 4개를 반환된 형태 그대로 유지했습니다.

json
{
"taskId": "695846750eb440c3870e763d38ef4f4b",
"results": [
{
"instagramUserId": "52256365838",
"instagramUsername": "adventuresoforest",
"instagramFullName": "Forest",
"instagramProfileUrl": "https://www.instagram.com/adventuresoforest/",
"instagramPicture": "https://scontent-fra3-2.cdninstagram.com/v/t51.82787-19/809812326_18068055263741839_8426418313724501534_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-fra3-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2gGE1JNYkQoszNL29wj7UyG4OGKOarcf_iw1luHzGMllAjP-kLWQ5LQPxtYI3LUcC5g&_nc_ohc=1hyyyEDHulgQ7kNvwFJIKKP&_nc_gid=ATIykjgJSgaEOBqdAnjQcg&edm=AIfao94BAAAA&ccb=7-5&ig_cache_key=GGbBRDCPB8fvzDBAAB4eZa7PpvB0bmNDAQAB1501500j-ccb7-5&oh=00_AQQZ3R0wDeV-bTnR2lYSje_IQ-ly9n6pyxGHXpJGAmzUHA&oe=6AF37F89&_nc_sid=9f8d40",
"followerSourceProfile": "https://www.instagram.com/jupiterhikes/",
"followerSourceProfileId": "1507518892",
"followerSourceProfileUsername": "jupiterhikes",
"followerSourceProfileUrl": "https://www.instagram.com/jupiterhikes/",
"instagramVerified": false,
"instagramPrivate": false
},
{
"instagramUserId": "199102398",
"instagramUsername": "richie_nu_field",
"instagramFullName": "新野 豊",
"instagramProfileUrl": "https://www.instagram.com/richie_nu_field/",
"instagramPicture": "https://scontent-fra3-1.cdninstagram.com/v/t51.2885-19/348434195_2264827180367957_813086592749200065_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby42NDAuYzIifQ&_nc_ht=scontent-fra3-1.cdninstagram.com&_nc_cat=105&_nc_oc=Q6cZ2gGE1JNYkQoszNL29wj7UyG4OGKOarcf_iw1luHzGMllAjP-kLWQ5LQPxtYI3LUcC5g&_nc_ohc=xux3gQ4SQEAQ7kNvwGj5tEv&_nc_gid=ATIykjgJSgaEOBqdAnjQcg&edm=AIfao94BAAAA&ccb=7-5&ig_cache_key=GBOvxBRVQJAr2QsIAMHicrzyqUgLbkULAAAB1501500j-ccb7-5&oh=00_AQRa3Zl_viAM914UM1_kQYrqGwPLfpmVqPwlMltzkNd44Q&oe=6AF3871F&_nc_sid=9f8d40",
"followerSourceProfile": "https://www.instagram.com/jupiterhikes/",
"followerSourceProfileId": "1507518892",
"followerSourceProfileUsername": "jupiterhikes",
"followerSourceProfileUrl": "https://www.instagram.com/jupiterhikes/",
"instagramVerified": false,
"instagramPrivate": false
},
{
"instagramUserId": "43861505420",
"instagramUsername": "shivroam",
"instagramFullName": "Shivam Rana I Mountaineer",
"instagramProfileUrl": "https://www.instagram.com/shivroam/",
"instagramPicture": "https://scontent-fra3-1.cdninstagram.com/v/t51.82787-19/858921985_18104766389457421_6701325443259882004_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-fra3-1.cdninstagram.com&_nc_cat=101&_nc_oc=Q6cZ2gGE1JNYkQoszNL29wj7UyG4OGKOarcf_iw1luHzGMllAjP-kLWQ5LQPxtYI3LUcC5g&_nc_ohc=NMw7vs1oyqQQ7kNvwEYvnsx&_nc_gid=ATIykjgJSgaEOBqdAnjQcg&edm=AIfao94BAAAA&ccb=7-5&ig_cache_key=GAEcMjMNkmJpMFJAABTaykn84-9cbmNDAQAB1501500j-ccb7-5&oh=00_AQR5iJXKSUhS5uS8xmmkgeYw-QZ8AbYxVHqIj3guogZgyA&oe=6AF38C8B&_nc_sid=9f8d40",
"followerSourceProfile": "https://www.instagram.com/jupiterhikes/",
"followerSourceProfileId": "1507518892",
"followerSourceProfileUsername": "jupiterhikes",
"followerSourceProfileUrl": "https://www.instagram.com/jupiterhikes/",
"instagramVerified": false,
"instagramPrivate": false
},
{
"instagramUserId": "23413245087",
"instagramUsername": "double24762",
"instagramFullName": "double 佳",
"instagramProfileUrl": "https://www.instagram.com/double24762/",
"instagramPicture": "https://scontent-iad6-1.cdninstagram.com/v/t51.2885-19/573323465_1219825463302212_7278921664109726296_n.png?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xNTAuYzIifQ&_nc_ht=scontent-iad6-1.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2gH2sHBsdmQY1aWiWoZZWA6eZ603UbEQOH0raGAaH9APRHqzVjuOTqB7gW86Vp6E9Xx44csiK9pjfjrqCVl5R1HC&_nc_ohc=kwiilGbw6cUQ7kNvwHe7b38&edm=AAAAAAABAAAA&ccb=7-5&ig_cache_key=YW5vbnltb3VzX3Byb2ZpbGVfcGlj.3-ccb7-5&oh=00_AQT5TH4G4DvUg9YUXYlVAW4_1Z03ebdjvl84MLuV0umlaQ&oe=6AF37C2A&_nc_sid=328259",
"followerSourceProfile": "https://www.instagram.com/jupiterhikes/",
"followerSourceProfileId": "1507518892",
"followerSourceProfileUsername": "jupiterhikes",
"followerSourceProfileUrl": "https://www.instagram.com/jupiterhikes/",
"instagramVerified": false,
"instagramPrivate": false
}
],
"nextCursor": null
}

첫 번째 레코드에는 숫자형 사용자 ID 52256365838, 사용자 이름 adventuresoforest, 그리고 공개된 프로필 필드가 들어 있습니다. followerSourceProfileUsername은 jupiterhikes이므로 어느 제출 프로필에서 이 관계가 생성됐는지 알 수 있습니다. 선택적 프로필 값이 없어도 task는 완료될 수 있습니다. 모든 레코드를 고정 schema에 억지로 맞추기보다 실제로 존재하는 필드를 읽으세요.

Instagram 사용자 ID로 두 오디언스 비교하기

단일 프로필 요청이 제대로 작동하면 scrape_instagram_users()를 재사용해 두 하이킹 크리에이터를 하나의 task에 넣으세요. 반환된 관계를 숫자형 사용자 ID로 그룹화하고, 각 ID에 연결된 모든 소스 사용자 이름을 유지합니다.

python
comparison_profiles = [
"jupiterhikes",
"https://www.instagram.com/darwin_onthetrail/",
]
comparison_results = scrape_instagram_users(comparison_profiles, api_key)
audience_by_id = {}
collected_count = {}
for result in comparison_results:
source_username = result["followerSourceProfileUsername"]
collected_count[source_username] = collected_count.get(source_username, 0) + 1
user_id = result["instagramUserId"]
grouped_user = audience_by_id.setdefault(
user_id,
{"user": result, "source_profiles": set()},
)
grouped_user["source_profiles"].add(source_username)
overlap = [
{
**grouped_user["user"],
"source_profiles": sorted(grouped_user["source_profiles"]),
}
for grouped_user in audience_by_id.values()
if len(grouped_user["source_profiles"]) == len(comparison_profiles)
]
overlap_report = {
"collected_count": collected_count,
"overlap_count": len(overlap),
"overlap": overlap,
}
print(json.dumps(overlap_report, indent=2, ensure_ascii=False))

두 프로필 task에서는 Jupiter Hikes의 팔로워 관계 124개와 Darwin on the Trail의 관계 46개가 반환됐습니다. 두 수집 목록에 모두 포함된 숫자형 ID는 3개였으며, task에는 2.7크레딧이 사용됐습니다.

그룹화 코드는 사용자 이름 대신 instagramUserId를 사용합니다. 이 ID가 API에서 반환하는 안정적인 join key이기 때문입니다. 완전한 API 사용자 객체 하나를 유지하고 정렬된 source_profiles 목록을 추가합니다. 공유된 ID 3개 각각의 목록에는 darwin_onthetrail과 jupiterhikes가 포함됩니다.

예를 들어 숫자형 ID 42048393083은 Jupiter Hikes 결과와 Darwin on the Trail 결과에 각각 한 번씩 나타납니다. 두 레코드 모두 사용자 이름 hikingful을 가리키지만, 각 레코드의 followerSourceProfileUsername은 서로 다릅니다. 그룹화 코드는 이 두 관계 레코드를 source_profiles: ["darwin_onthetrail", "jupiterhikes"]가 포함된 하나의 사용자 객체로 합칩니다.

두 Instagram 팔로워 수집 목록을 숫자형 사용자 ID로 join해 소스 프로필을 모두 유지하면서 오디언스 중복을 찾는 과정
두 Instagram 팔로워 수집 목록을 숫자형 사용자 ID로 join해 소스 프로필을 모두 유지하면서 오디언스 중복을 찾는 과정

📘 중복 결과는 제한적으로 해석하세요: 공유 ID는 반환된 두 범위에 모두 나타났다는 의미일 뿐입니다. 크리에이터의 전체 오디언스 중복률을 나타내거나, 게시 시점에도 현재 팔로우 중임을 입증하거나, 해당 계정이 아웃리치 대상에 적합하다는 뜻은 아닙니다.

collected_count 값은 분모를 명확히 보여줍니다. 비율을 계산한다면 기준을 분명히 표시하세요. 예를 들어 3 / 124는 이번 task에서 수집된 Jupiter Hikes 레코드 중 공유 ID가 차지하는 비율을 의미합니다.

로컬 브라우저 스크립트를 선호한다면 Instagram 팔로워, 팔로잉 목록, 게시물 작성자를 무료로 스크래핑하는 가이드를 확인하세요.

오디언스 리서치를 위한 공유 프로필 Enrich

중복 결과에는 숫자형 Instagram ID와 소스 출처가 포함됩니다. 다음 단계로 이러한 공유 ID를 Instagram Profile Scraper enrichment에 제출한 뒤, 확인된 결과를 공개된 웹사이트, 이메일, bio, 카테고리 또는 프로필 지표에 따라 세분화할 수 있습니다.

아래 두 번째 함수를 source 함수 다음에 추가하세요. 같은 API 키를 사용하며 제출, polling, pagination 순서도 동일합니다.

python
def enrich_instagram_profiles(overlap_users, api_key):
"""Retrieve public profile details for the numeric IDs in the overlap."""
if not overlap_users:
return []
tasks_url = "https://api.datablist.com/v1/enrichments/tasks"
headers = {"X-API-Key": api_key}
inputs = [
{
"inputId": user["instagramUserId"],
"data": {"instagramIdentifier": user["instagramUserId"]},
}
for user in overlap_users
]
payload = {
"enrichmentId": "instagram-profile-scraper",
"uniqueId": str(uuid.uuid4()),
"settings": {"scrapeType": "profile"},
"inputs": inputs,
}
response = requests.post(tasks_url, headers=headers, json=payload)
response.raise_for_status()
task = response.json()
task_id = task["@id"]
task_url = f"{tasks_url}/{task_id}"
while task["status"] not in ("completed", "failed", "stopped"):
time.sleep(3)
response = requests.get(task_url, headers=headers)
response.raise_for_status()
task = response.json()
if task["status"] != "completed":
raise RuntimeError(
f"Task {task_id} {task['status']}: {task.get('error')}"
)
profile_results = []
params = {"limit": 100}
while True:
response = requests.get(
f"{task_url}/results",
headers=headers,
params=params,
)
response.raise_for_status()
page = response.json()
profile_results.extend(page["results"])
if page["nextCursor"] is None:
break
params["cursor"] = page["nextCursor"]
return profile_results
profile_results = enrich_instagram_profiles(overlap, api_key)
profiles_with_websites = [
result
for result in profile_results
if result["status"] == "success"
and result["outputs"].get("instagramWebsite")
]
profiles_with_public_email = [
result
for result in profile_results
if result["status"] == "success"
and result["outputs"].get("instagramEmail")
]

두 수집 목록에 공유 ID가 없으면 overlap은 비어 있고, 이 함수는 POST 요청을 보내기 전에 []를 반환합니다. 유료 enrichment task를 만들지 않고도 빈 리서치 세그먼트로 작업을 이어갈 수 있습니다.

각 숫자형 ID를 inputId와 instagramIdentifier에 모두 사용하면 중복 결과와 다시 join할 때 혼동이 없습니다. 실패 상태, 빈 output, 크레딧 사용량, 오류를 포함해 반환된 모든 결과 객체를 유지하세요. 로컬 세그먼트를 만들 때만 필터링하는 것이 좋습니다.

profile 모드는 숫자형 ID당 2크레딧부터 시작합니다. 프로필이 공개한 경우 bio, 웹사이트, 이메일 또는 전화번호 필드를 가져올 수 있으며 프로필 수치와 카테고리 정보도 반환합니다. 프로필을 찾았더라도 연락처 필드는 비어 있을 수 있습니다. 이 코드는 로컬에서 리서치 세그먼트를 준비할 뿐입니다. 메시지를 보내거나, 공유 팔로워라는 사실을 연락에 동의한 것으로 간주하지 않습니다.

이 후속 작업을 no-code 방식으로 진행하려면 Datablist의 **Instagram Profile Scraper**를 사용하세요.

팔로워에서 팔로잉으로 전환하기

동일한 source로 제출한 프로필이 팔로우하는 계정도 가져올 수 있습니다. scraping_type 인수만 변경하세요.

python
following_results = scrape_instagram_users(
["1507518892"],
api_key,
scraping_type="following",
limit_per_profile=100,
)

이 레코드는 Jupiter Hikes가 팔로우하는 계정을 나타냅니다. 출처 필드는 followingSourceProfileId, followingSourceProfileUsername, followingSourceProfileUrl로 바뀝니다. followers 모드와 마찬가지로 실제 반환 수를 사용하세요.

Instagram 팔로워 API 비용 계산하기

Instagram follower source는 반환된 팔로워 또는 팔로잉 사용자 한 명당 0.01크레딧을 사용합니다. 제출한 소스 프로필을 확인하는 데는 프로필당 최대 1크레딧이 추가로 사용될 수 있습니다. 캐시된 확인 결과가 있으면 실제 비용은 줄어듭니다.

프로필 2개에 프로필당 사용자 100명을 요청할 경우 예상 비용은 다음과 같습니다.

2 × (1 + 100 × 0.01) = 4 credits

이는 예상치이며 상한이 아닙니다. 두 프로필 task에서는 관계 레코드 170개가 반환됐고 2.7크레딧이 사용됐습니다. 실제 비용은 실행 후 task.credits.used에서 확인하세요.

Loading pricing…

API access, 플랜에 포함된 크레딧, 선택적 top-up, task 사용량은 각각 별도입니다. Growth 월간 플랜은 $50 또는 €50이며, REST API access와 월 20,000크레딧이 포함됩니다. 현재 가장 작은 top-up은 $20 또는 €17.50에 20,000크레딧을 추가합니다.

이 top-up 요율을 기준으로 반환된 사용자 1,000명은 10크레딧을 사용합니다. 소스 프로필 확인 비용을 제외하면 사용 금액은 $0.01 또는 €0.00875에 해당합니다. 이는 표준화된 사용 가치일 뿐 별도로 구매할 수 있는 패키지가 아닙니다. Top-up 가격은 여전히 $20 또는 €17.50이며, API access에는 Growth 구독이 필요합니다. 현재 상품 구성은 Datablist 요금제에서 확인하세요.

선택 사항인 Instagram Profile Scraper에는 별도 비용이 적용됩니다. 숫자형 ID와 scrapeType: "profile"을 사용하면 제출한 중복 프로필당 2크레딧부터 시작합니다.

자주 발생하는 입력·task·결과 문제 해결하기

API 키가 없는 경우

스크립트는 HTTP 요청을 보내기 전에 Set DATABLIST_API_KEY before running this script. 오류를 발생시킵니다. 같은 shell에서 변수를 export한 뒤 파일을 다시 실행하세요.

API가 키를 거부하는 경우

response.raise_for_status()가 HTTP 오류를 발생시킵니다. Personal API Key를 정확히 복사했는지, 계정에 Growth 플랜 API access가 있는지 확인하세요. 예제에 사용된 단일 X-API-Key 헤더를 그대로 유지합니다.

소스 프로필을 확인할 수 없는 경우

각 값이 사용자 이름, 전체 Instagram 프로필 URL 또는 숫자형 사용자 ID 문자열인지 확인하세요. 새로운 유료 실행을 만들기 전에 기존 task와 오류를 먼저 살펴보세요.

크레딧이 부족한 경우

잔액을 확인하고, 다른 task를 제출하기 전에 프로필 수나 요청 제한을 줄이세요. 이미 시작된 task에서는 크레딧이 사용됐을 수 있습니다.

Task가 failed 또는 stopped 상태인 경우

스크립트는 task ID를 출력하고 RuntimeError를 발생시킵니다. 해당 ID로 기존 task의 error, credits.used, 그리고 이용 가능한 일부 결과를 확인하세요. Failed 또는 stopped 상태의 task에도 생성된 행이 남아 있을 수 있으므로 다시 제출하기 전에 반드시 확인해야 합니다.

반환 수가 요청 제한과 다른 경우

결과의 실제 개수를 보고하세요. limitPerProfile은 요청 제한일 뿐 정확한 개수를 보장하지 않습니다. 또한 결과 하나만으로 provider가 접근 가능한 사용자를 더 적게 또는 더 많이 반환한 이유를 알 수는 없습니다.

제출 응답이 유실된 경우

최근 source task를 나열하고 POST 전에 출력된 uniqueId와 일치하는 항목을 찾으세요.

python
unique_id = "paste-the-printed-unique-id"
response = requests.get(
"https://api.datablist.com/v1/sources/tasks",
headers={"X-API-Key": api_key},
params={"sourceId": "instagram-source", "limit": 100},
)
response.raise_for_status()
for task in response.json()["tasks"]:
if task["uniqueId"] == unique_id:
print(task["@id"], task["status"])

해당 task ID의 polling을 계속하거나 기존 결과를 가져오세요. Sources task 문서에서 목록, 상태, 결과, 보존 endpoint를 자세히 확인할 수 있습니다.

다음 단계

이제 Instagram 팔로워 관계를 가져오는 재사용 가능한 Python Requests 함수와, 수집된 Jupiter Hikes 및 Darwin on the Trail 목록을 숫자형 사용자 ID로 비교하는 로컬 리포트를 갖추게 됐습니다. 공유된 각 레코드에는 두 소스 프로필이 모두 유지됩니다.

예제 프로필을 검토를 마친 소수의 공개 크리에이터 프로필로 교체하세요. 프로필별 제한을 목적에 맞게 정한 다음, 각 source에서 실제로 반환된 수를 기준으로 중복 결과를 해석합니다. 관리되는 동기식 Requests 예제를 다운로드하거나, non-blocking concurrency가 필요하다면 관리되는 비동기 HTTPX 예제를 사용할 수 있습니다. 먼저 소스 계정을 찾아야 한다면 키워드로 Instagram 프로필을 찾는 가이드부터 시작하세요.