Datablistの**Instagram Followers Scraper API**に、公開プロフィールのユーザー名、URL、または数値のユーザーIDを1件以上送信すれば、PythonのRequestsライブラリからInstagramフォロワーを取得できます。APIはフォロワーのレコードをJSONで返し、それぞれの関係に紐づく取得元プロフィールも識別します。
このガイドでは、まず長距離ハイカー兼映像クリエイターのJupiter Hikesから取得したフォロワーを使用します。続いて、同じPython関数を再利用し、別の長距離ハイカー兼アウトドア映像クリエイターであるDarwin on the Trailのフォロワーと比較します。取得結果をInstagramの数値ユーザーIDでグループ化し、両方のリストに含まれるユーザーを特定します。
🔑 お急ぎの方向けの要約
DatablistのInstagram Followers Scraper APIを使うと、PythonからInstagramの公開プロフィールのフォロワーを取得できます。対象プロフィールとプロフィールごとの上限を指定し、取得可能なフォロワーレコードをJSONで受け取って、リサーチやマーケティングのワークフローに活用できます。開始前に、Instagram上で各プロフィールのフォロワー一覧を閲覧できるかご確認ください。
- 入力: Instagramのユーザー名、プロフィールURL、または数値ユーザーID。
- 出力: ユーザーID、取得可能なプロフィール情報、各フォロワーの取得元プロフィールを含むフォロワーレコード。
💡 ノーコードで進めたい場合 Datablistの**Instagram Followers source**を使えば、コードを書かずにフォロワーの行データを生成できます。
Datablistの画面から同じsourceを使う方法は、コレクションベースのInstagramフォロワー取得ガイドで解説しています。ここからはAPIを使う方法に絞ってご説明します。
Instagramのフォロワー一覧に制限がないか確認する
スクレイピングを実行する前に、対象のInstagramプロフィールを開き、Followersをクリックしてください。フォロワー一覧を閲覧できるか確認します。公開プロフィールであっても、Instagramがすべてのフォロワーを表示するとは限りません。
**「Only [username] can see all followers」**と表示される場合、公開プロフィールでもScraperから取得できるのは一部のリストのみです。APIが取得できるのはInstagram側で閲覧可能なフォロワーだけであり、指定上限を増やしても非表示のフォロワーにはアクセスできません。
APIリクエストを開始する前に、取得予定のプロフィールをそれぞれ確認し、閲覧可能なフォロワー一覧だけで目的を達成できるか判断してください。
PythonとDatablist APIキーをセットアップする
Datablist REST APIへのアクセスはGrowthプランに含まれています。Sourceタスクでもクレジットを消費します。フォロワーsourceの料金は、手順の後半で詳しくご説明します。
Datablist APIアカウントページからPersonal API Keyを作成してください。この例ではrequestsパッケージを使用します。プロジェクトフォルダーを作成してターミナルで開き、次のコマンドを実行します。
python -m venv .venv
source .venv/bin/activate
python -m pip install requestsscrape_instagram_followers.pyというファイルを作成し、キーを環境変数DATABLIST_API_KEYに設定します。
export DATABLIST_API_KEY="your-api-key"スクリプトはこの変数を読み取り、X-API-Keyヘッダーで値を送信します。
1つのPython関数でInstagramフォロワーを取得する
最初のリクエストでは、長距離ハイカー兼クリエイターのJupiter Hikesが使用するユーザー名jupiterhikesを指定します。このsourceには、完全なプロフィールURLやInstagramの数値ユーザーIDを文字列として渡すこともできます。たとえば、Jupiter Hikesの数値IDは"1507518892"です。
次の完全なスクリプトをscrape_instagram_followers.pyに貼り付けます。
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))次のコマンドで実行します。
python scrape_instagram_followers.pyこの関数は、次の3種類のAPIコールを順番に実行します。
POST /v1/sources/tasksでsource IDと設定を送信します。APIはバックグラウンドタスクを受け付け、そのタスクIDを返します。GET /v1/sources/tasks/{taskId}でタスクの状態を3秒ごとに確認します。Requestsクライアント側では待機しますが、タスク自体はDatablist上で非同期に実行されます。GET /v1/sources/tasks/{taskId}/resultsで、フラットなフォロワーオブジェクトをページ単位で取得します。ループは、nextCursorがnullになるまで、nullではない値を変更せずにAPIへ渡し続けます。
この例ではscrapingTypeをfollowersに設定し、limitPerProfileで100ユーザーをリクエストしています。100は指定上限であり、正確な取得件数ではありません。プロバイダー側のページ区切りや、タスク実行時にアクセスできるユーザーによって、返される件数は変わります。
スクリプトは送信前にuniqueIdを出力します。POST中に接続が切れた場合、この値を使えば、すぐに別の有料タスクを作成せず、受理済みのタスクを探せます。
APIがフォロワー関係レコードを生成する仕組み
Datablistはまず、各ユーザー名、完全なプロフィールURL、または数値IDから、取得元となるInstagramプロフィールを特定します。その後、バックグラウンド処理でフォロワーページを取得し、プロバイダー側のcursorを処理します。利用者が管理するのは、スクリプトに示したDatablistのタスクと結果ページのcursorだけです。
返却される1つの取得元プロフィールのリスト内では、重複するユーザーIDが除外されます。同じユーザーが送信した2人のクリエイターの両方に含まれる場合、APIは2件の関係レコードを保持します。それぞれのfollowerSourceProfile...フィールドは異なります。この仕様により、オーディエンスを比較できます。
次のセクションでは、以下のフィールドを使用します。
instagramUserIdは、返されたユーザーを比較するための安定したキーです。instagramUsername、instagramFullNameなどのinstagram...フィールドには、公開情報を取得できる場合にフォロワーの詳細が入ります。followerSourceProfileId、followerSourceProfileUsername、followerSourceProfileUrlは、起点となったクリエイターを示します。
このsourceが取得するのは関係リストです。候補の検索や信頼度スコアの算出は行いません。
Jupiter Hikesの取得結果を確認する
完了したJupiter Hikesのタスクでは、一意のフォロワーレコードが124件返され、2.24クレジットを消費しました。リクエストではlimitPerProfile: 100を指定していましたが、プロバイダーが25ユーザーを含む次のページを返す直前の取得件数は99件でした。Datablistはそのページ全体を保持したため、最終結果は124件になりました。
以下は、最後の結果ページのレスポンスです。エンベロープと4件のフォロワーオブジェクトを、返されたとおりに掲載しています。
{
"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
}最初のレコードには、数値ユーザーID52256365838、ユーザー名adventuresoforest、取得可能な公開プロフィール情報が含まれています。followerSourceProfileUsernameはjupiterhikesなので、どの送信プロフィールから生成された関係かを判別できます。任意のプロフィール値が欠けていても、タスクは正常に完了する場合があります。すべてのレコードを固定スキーマから再構築するのではなく、実際に存在するフィールドを読み取ってください。
2つのオーディエンスをInstagramユーザーIDで比較する
単一プロフィールのリクエストが動作したら、2人のハイキングクリエイターを1つのタスクに指定し、scrape_instagram_users()を再利用します。返された関係を数値ユーザーIDでグループ化し、そのIDに紐づくすべての取得元ユーザー名を保持します。
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))2プロフィールのタスクでは、Jupiter Hikesから124件、Darwin on the Trailから46件のフォロワー関係が返されました。両方の取得リストに存在した数値IDは3件です。タスクは2.7クレジットを消費しました。
グループ化コードでは、ユーザー名ではなくinstagramUserIdを使用しています。IDはAPIが返す安定した結合キーだからです。完全なAPIユーザーオブジェクトを1件保持し、並べ替えたsource_profilesリストを追加します。共通する3件のIDでは、このリストにdarwin_onthetrailとjupiterhikesが入ります。
たとえば、数値ID42048393083はJupiter Hikesの結果とDarwin on the Trailの結果に1回ずつ現れます。どちらのレコードもユーザー名hikingfulを示していますが、それぞれ異なるfollowerSourceProfileUsernameを持ちます。グループ化コードは、この2件の関係レコードをsource_profiles: ["darwin_onthetrail", "jupiterhikes"]を持つ1つのユーザーオブジェクトに結合します。
📘 重複は限定的に解釈してください: 共通IDは、返された2つの取得範囲の両方に存在したことだけを示します。クリエイターの全オーディエンスにおける重複率を測るものでも、記事公開時点のフォロー関係を証明するものでも、アウトリーチ対象として適格であることを示すものでもありません。
collected_countの値により、分母が明確になります。割合を計算する場合は、何を表す数値か明記してください。たとえば3 / 124は、このタスクで取得したJupiter Hikesのレコードに占める共通IDの割合です。
ローカルのブラウザスクリプトを使いたい場合は、Instagramのフォロワー、フォロー中リスト、投稿者を無料でスクレイピングするガイドをご覧ください。
共通プロフィールをエンリッチしてオーディエンスを分析する
重複結果には、Instagramの数値IDと取得元情報が含まれます。実用的な次のステップとして、それらの共通IDをInstagram Profile Scraper enrichmentへ送信し、取得に成功した結果をWebサイト、公開メールアドレス、bio、カテゴリー、プロフィール指標などでセグメント化できます。
source関数の下に、次の2つ目の関数を追加してください。同じAPIキーを使い、送信、polling、paginationという同じ流れで処理します。
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")
]取得した2つのリストに共通IDがない場合、overlapは空になり、この関数はPOSTリクエストを送信する前に[]を返します。有料のenrichmentタスクを作成せず、空のリサーチセグメントとして処理を続けられます。
各数値IDをinputIdとinstagramIdentifierの両方に使用すると、重複結果への結合が明確になります。失敗ステータス、空の出力、クレジット使用量、エラーを含め、返されたすべての結果オブジェクトを保持してください。フィルタリングはローカルでセグメントを作成するときだけ行います。
profileモードは数値IDごとに2クレジットから利用でき、プロフィールで公開されている場合は、bio、Webサイト、メールアドレス、電話番号のほか、プロフィールの各種件数やカテゴリー情報を返します。プロフィールが見つかっても、連絡先フィールドが空の場合があります。このコードが行うのは、ローカルでのリサーチセグメント作成です。メッセージを送信したり、共通フォロワーであることを連絡への同意とみなしたりするものではありません。
この手順をノーコードで行う場合は、Datablistの**Instagram Profile Scraper**をご利用ください。
followersからfollowingへ切り替える
同じsourceで、送信プロフィールがフォローしているアカウントも取得できます。変更するのはscraping_type引数だけです。
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では、返されたフォロワーまたはフォロー中ユーザー1件につき0.01クレジットを消費します。送信した取得元プロフィールの特定には、追加で最大1クレジットかかる場合があります。キャッシュされた特定結果が使われると、実際の料金は下がることがあります。
2つのプロフィールで、それぞれ100ユーザーを上限として指定する場合、計画時の見積もりは次のとおりです。
2 × (1 + 100 × 0.01) = 4 credits
これは見積もりであり、上限ではありません。2プロフィールのタスクでは170件の関係レコードが返され、2.7クレジットを消費しました。実際の料金は、実行後にtask.credits.usedをご確認ください。
APIアクセス、プラン付属のクレジット、任意の追加購入、タスクの使用量は、それぞれ別項目です。Growth月額プランは50ドルまたは50ユーロで、REST APIへのアクセスと毎月20,000クレジットが含まれます。現在の最小追加購入では、20ドルまたは17.50ユーロで20,000クレジットが加算されます。
この追加購入レートでは、返された1,000ユーザーで10クレジットを消費します。取得元プロフィールの特定料金を除くと、この使用量は0.01ドルまたは0.00875ユーロ相当です。これは正規化した使用量の金額であり、その価格で購入できるパッケージではありません。追加購入には20ドルまたは17.50ユーロがかかり、APIアクセスには引き続きGrowthプランが必要です。最新の内容はDatablistの料金ページをご確認ください。
任意で使用するInstagram Profile Scraperには別途料金がかかります。数値IDとscrapeType: "profile"を指定した場合、送信する共通プロフィール1件につき2クレジットからです。
入力・タスク・結果のよくある問題を解決する
APIキーが設定されていない
HTTPリクエストが行われる前に、スクリプトがSet DATABLIST_API_KEY before running this script.というエラーを出します。同じshellで環境変数をexportし、ファイルを再度実行してください。
APIがキーを拒否する
response.raise_for_status()がHTTPエラーを発生させます。Personal API Keyを正しくコピーしたか、アカウントにGrowthプランのAPIアクセス権があるかご確認ください。例で使用しているX-API-Keyヘッダーは1つだけにしてください。
取得元プロフィールを特定できない
各値がユーザー名、Instagramプロフィールの完全なURL、または数値ユーザーIDの文字列であることをご確認ください。別の有料タスクを作成する前に、既存タスクとそのエラーを確認してください。
クレジットが不足している
残高を確認し、別のタスクを送信する前にプロフィール数または指定上限を減らしてください。すでに開始されたタスクでは、クレジットが消費されている場合があります。
タスクがfailedまたはstoppedになった
スクリプトはタスクIDを出力し、RuntimeErrorを発生させます。そのIDを使って、既存タスクのerror、credits.used、利用可能な部分結果を確認してください。failedまたはstoppedになったタスクでも、生成済みの行が残る場合があります。再送信する前に必ず確認してください。
返された件数が指定上限と異なる
結果に含まれる実際の件数を使用してください。limitPerProfileは指定上限であり、正確な件数を保証するものではありません。また、1回の結果だけでは、プロバイダーがアクセス可能なユーザーを指定数より多く、または少なく返した理由は判断できません。
タスク送信時のレスポンスを受け取れなかった
最近のsourceタスクを一覧表示し、POST前に出力されたuniqueIdと照合します。
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"])そのタスクIDのpollingを続けるか、既存の結果を取得してください。Sourcesタスクのドキュメントでは、一覧、ステータス、結果、保持期間に関するendpointを詳しく解説しています。
次のステップ
これで、Instagramのフォロワー関係を取得する再利用可能なPython Requests関数と、Jupiter HikesとDarwin on the Trailから取得したリストを数値ユーザーIDで比較するローカルレポートが完成しました。共通レコードには、両方の取得元プロフィールが保持されます。
例を、確認済みの少数の公開クリエイタープロフィールに置き換えてください。プロフィールごとの上限を目的に合わせて設定し、各取得元から実際に返された件数を基準に重複結果を解釈します。メンテナンスされている同期Requestsのサンプルをダウンロードするか、ノンブロッキングな並行処理が必要な場合はメンテナンスされている非同期HTTPXのサンプルをご利用ください。最初に取得元アカウントを探す必要がある場合は、キーワードからInstagramプロフィールを検索するガイドをご覧ください。



