Je kunt Instagram-volgers scrapen met Python door één of meer usernames, profiel-URL's of numerieke user-ID's van openbare profielen via de Requests-library naar Datablists Instagram Followers Scraper API te sturen. De API retourneert de volgerrecords als JSON en vermeldt bij iedere relatie van welk bronprofiel die afkomstig is.

Deze gids begint met de volgers die zijn verzameld voor Jupiter Hikes, een langeafstandswandelaar en filmmaker. Daarna hergebruik ik dezelfde Python-functie om zijn verzamelde volgers te vergelijken met die van Darwin on the Trail, een andere langeafstandswandelaar en outdoorfilmmaker. De code groepeert de resultaten op numerieke Instagram-user-ID en vindt de gebruikers die in beide verzamelde lijsten voorkomen.

🔑 Samenvatting voor wie weinig tijd heeft

Gebruik Datablists Instagram Followers Scraper API om met Python volgers van openbare Instagram-profielen te scrapen. Verstuur de profielen die je wilt scrapen, stel een limiet per profiel in en haal de beschikbare volgerrecords als JSON op voor je eigen onderzoek of marketingworkflow. Controleer vooraf of Instagram je toegang geeft tot de volgers van ieder profiel.

  • Input: Instagram-usernames, profiel-URL's of numerieke user-ID's.
  • Output: Volgerrecords met user-ID's, beschikbare profielgegevens en het bronprofiel waarvan iedere volger afkomstig is.

💡 Liever een no-code-oplossing? Gebruik Datablists Instagram Followers source om zonder code volgerrecords te genereren.

De Instagram-handleiding op basis van collections behandelt dezelfde source via de interface van Datablist. De rest van deze gids richt zich op de API.

Controleer of Instagram de volgerslijst beperkt

Open voordat je een scrape start het beoogde Instagram-profiel en klik op Volgers. Controleer of je door de volgerslijst kunt bladeren. Een openbaar profiel betekent niet automatisch dat Instagram alle volgers zichtbaar maakt.

Zie je “Alleen [username] kan alle volgers zien”, houd dan rekening met een onvolledige lijst van de scraper, ook bij een openbaar profiel. De API kan alleen de volgers ophalen die Instagram beschikbaar stelt. Een hogere aangevraagde limiet maakt verborgen volgers niet toegankelijk.

De melding over de zichtbaarheid van volgers op het Instagram-profiel van Levi’s.
De melding over de zichtbaarheid van volgers op het Instagram-profiel van Levi’s.

Controleer ieder profiel dat je wilt scrapen. Zo weet je vóór de API-request of de beschikbare volgerslijst groot genoeg is voor je toepassing.

Stel Python en je Datablist API-key in

Toegang tot de Datablist REST API is inbegrepen bij het Growth-abonnement. Source-taken verbruiken daarnaast credits. Na de walkthrough leg ik de kosten van de volgers-source uit.

Maak een Personal API Key aan op je Datablist API-accountpagina. Voor dit voorbeeld gebruik ik het package requests. Maak een projectmap, open deze in een terminal en voer het volgende uit:

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

Maak een bestand met de naam scrape_instagram_followers.py en plaats je key vervolgens in de omgevingsvariabele DATABLIST_API_KEY:

shell
export DATABLIST_API_KEY="your-api-key"

Het script leest deze variabele uit en verstuurt de waarde via de header X-API-Key.

Scrape Instagram-volgers met één Python-functie

De eerste request gebruikt jupiterhikes, de username van langeafstandswandelaar en creator Jupiter Hikes. De source accepteert ook een volledige profiel-URL of een numerieke Instagram-user-ID als string. De numerieke ID van Jupiter Hikes is bijvoorbeeld "1507518892".

Plak dit volledige script in 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))

Voer het script uit met:

shell
python scrape_instagram_followers.py

De functie voert achtereenvolgens drie soorten API-calls uit.

  1. POST /v1/sources/tasks verstuurt de source-ID en instellingen. De API accepteert de achtergrondtaak en retourneert de task-ID.
  2. GET /v1/sources/tasks/{taskId} controleert de taak iedere drie seconden. De Requests-client wacht, maar de taak zelf draait asynchroon in Datablist.
  3. GET /v1/sources/tasks/{taskId}/results haalt een pagina met platte volgerobjecten op. De loop stuurt iedere nextCursor die niet null is ongewijzigd terug, totdat de API null retourneert.

Het voorbeeld stelt scrapingType in op followers en vraagt met limitPerProfile 100 gebruikers op. Beschouw 100 als een aangevraagde limiet, niet als een exact aantal resultaten. De paginagrenzen van de provider en de gebruikers die tijdens de taak beschikbaar zijn, kunnen het uiteindelijke aantal beïnvloeden.

Het script toont vóór het versturen de uniqueId. Valt de verbinding tijdens de POST weg, dan helpt deze waarde je om de geaccepteerde taak terug te vinden in plaats van meteen een nieuwe betaalde run te starten.

Zo bouwt de API records voor volgerrelaties op

Datablist koppelt iedere username, volledige profiel-URL of numerieke ID eerst aan het bijbehorende Instagram-bronprofiel. Vervolgens haalt een achtergrondproces de volgerpagina's op en verwerkt het de cursor van de provider. Je hoeft alleen de cursors voor de Datablist-taak en resultaatpagina's uit het script te beheren.

Herhaalde user-ID's worden binnen de geretourneerde lijst van één bronprofiel gededupliceerd. Verschijnt dezelfde gebruiker bij twee ingestuurde creators, dan bewaart de API twee relatierecords. Elk record heeft andere followerSourceProfile...-velden. Precies daardoor kun je de audiences met elkaar vergelijken.

Gebruik in de volgende onderdelen deze velden:

  • instagramUserId is de stabiele sleutel om geretourneerde gebruikers te vergelijken.
  • instagramUsername, instagramFullName en de overige instagram...-velden beschrijven de volger wanneer die openbare gegevens beschikbaar zijn.
  • followerSourceProfileId, followerSourceProfileUsername en followerSourceProfileUrl identificeren de creator waarmee je bent begonnen.

Deze source haalt relatielijsten op. De source zoekt geen kandidaten en berekent geen confidence scores.

Bekijk de resultaten van Jupiter Hikes

De voltooide taak voor Jupiter Hikes retourneerde 124 unieke volgerrecords en verbruikte 2,24 credits. Hoewel in de request limitPerProfile: 100 stond, was de teller 99 voordat de provider nog een pagina met 25 gebruikers retourneerde. Datablist behield die volledige pagina, waardoor het resultaat op 124 uitkwam.

Hieronder staat de response van de laatste resultatenpagina. De envelope en alle vier de volgerobjecten zijn ongewijzigd overgenomen:

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
}

Het eerste record heeft de numerieke user-ID 52256365838, de username adventuresoforest en de beschikbare openbare profielvelden. De followerSourceProfileUsername is jupiterhikes, zodat je weet uit welk ingestuurd profiel de relatie afkomstig is. De taak kan ook slagen als een optionele profielwaarde ontbreekt. Lees de aanwezige velden uit in plaats van ieder record volgens een vast schema opnieuw op te bouwen.

Vergelijk twee audiences op Instagram-user-ID

Zodra de request voor één profiel werkt, kun je scrape_instagram_users() hergebruiken met beide hiking-creators in één taak. Groepeer de geretourneerde relaties op numerieke user-ID en bewaar bij iedere ID alle bijbehorende bron-usernames:

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))

De taak met twee profielen retourneerde 124 volgerrelaties voor Jupiter Hikes en 46 voor Darwin on the Trail. Drie numerieke ID's kwamen in beide verzamelde lijsten voor. De taak verbruikte 2,7 credits.

De groeperingscode gebruikt instagramUserId in plaats van de username, omdat de ID de stabiele joinsleutel is die de API retourneert. De code bewaart één volledig API-userobject en voegt een gesorteerde lijst met source_profiles toe. Voor elk van de drie gedeelde ID's bevat die lijst darwin_onthetrail en jupiterhikes.

De numerieke ID 42048393083 komt bijvoorbeeld één keer voor in de resultaten van Jupiter Hikes en één keer in die van Darwin on the Trail. Beide records beschrijven de username hikingful, maar hebben elk een andere followerSourceProfileUsername. De groeperingscode voegt die twee relatierecords samen tot één userobject met source_profiles: ["darwin_onthetrail", "jupiterhikes"].

Twee verzamelde lijsten met Instagram-volgers, gekoppeld op numerieke user-ID om audience-overlap te vinden en beide bronprofielen te behouden
Twee verzamelde lijsten met Instagram-volgers, gekoppeld op numerieke user-ID om audience-overlap te vinden en beide bronprofielen te behouden

📘 Interpreteer de overlap beperkt: Een gedeelde ID kwam in beide geretourneerde selecties voor. Dit meet niet de volledige audience-overlap van de creators, bewijst niet dat het account op het moment van publicatie nog steeds volgt en kwalificeert het account niet automatisch voor outreach.

De waarden van collected_count maken de noemer expliciet. Geef een percentage altijd een duidelijk label. Zo beschrijft 3 / 124 de gedeelde ID's als percentage van de Jupiter Hikes-records die tijdens deze taak zijn verzameld.

Gebruik je liever een lokaal browserscript? Bekijk dan de gids over gratis Instagram-volgers, following-lijsten en auteurs van posts scrapen.

Verrijk gedeelde profielen voor audience research

De overlap levert numerieke Instagram-ID's en informatie over hun herkomst op. Een logische vervolgstap is om die gedeelde ID's naar de enrichment Instagram Profile Scraper te sturen. Daarna kun je de geslaagde resultaten segmenteren op beschikbare website, openbaar e-mailadres, bio, categorie of profielstatistieken.

Voeg deze tweede functie onder de source-functie toe. Ze gebruikt dezelfde API-key en dezelfde volgorde voor versturen, pollen en pagineren:

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")
]

Wanneer de twee verzamelde lijsten geen gedeelde ID's hebben, is overlap leeg en retourneert deze functie [] voordat ze een POST-request verstuurt. Je kunt dan met een leeg onderzoekssegment doorgaan zonder een betaalde enrichment-taak aan te maken.

Door iedere numerieke ID zowel als inputId als instagramIdentifier te gebruiken, blijft de join met de overlap eenduidig. Bewaar ieder geretourneerd resultaatobject, inclusief mislukte statussen, lege outputs, creditverbruik en fouten. Filter pas wanneer je lokaal een segment opbouwt.

De modus profile begint bij 2 credits per numerieke ID. Als het profiel deze openbaar maakt, kan deze modus de bio, website, het e-mailadres of telefoonnummer retourneren, samen met profielaantallen en categoriegegevens. Ook een gevonden profiel kan lege contactvelden hebben. De code maakt lokaal onderzoekssegmenten aan. Ze verstuurt geen berichten en beschouwt een gedeelde volger niet als toestemming om contact op te nemen.

Gebruik voor een no-code-versie van deze vervolgstap Datablists Instagram Profile Scraper.

Schakel van followers naar following

Dezelfde source kan de accounts ophalen die een ingestuurd profiel volgt. Wijzig alleen het argument scraping_type:

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

Deze records beschrijven de accounts die Jupiter Hikes volgt. De herkomst staat nu in followingSourceProfileId, followingSourceProfileUsername en followingSourceProfileUrl. Gebruik net als in de followers-modus het werkelijk geretourneerde aantal.

Bereken de kosten van de Instagram Followers API

De Instagram follower source gebruikt 0,01 credits per geretourneerde follower of following user. Het koppelen van een ingestuurd bronprofiel kan maximaal 1 extra credit kosten. Door caching kunnen de werkelijke kosten lager uitvallen.

Voor twee profielen en een aangevraagde limiet van 100 gebruikers per profiel kun je deze schatting gebruiken:

2 × (1 + 100 × 0,01) = 4 credits

Dit is een schatting, geen maximum. De taak met twee profielen retourneerde 170 relatierecords en verbruikte 2,7 credits. Lees na afloop task.credits.used uit voor de werkelijke kosten.

Loading pricing…

API-toegang, inbegrepen abonnementscredits, optionele top-ups en taakverbruik staan los van elkaar. Het maandelijkse Growth-abonnement kost $ 50 of € 50 en omvat toegang tot de REST API plus 20.000 credits per maand. De kleinste huidige top-up voegt 20.000 credits toe voor $ 20 of € 17,50.

Tegen die top-up-tarieven verbruiken 1.000 geretourneerde gebruikers 10 credits. Dat verbruik komt overeen met $ 0,01 of € 0,00875, exclusief het koppelen van het bronprofiel. Dit is een genormaliseerde verbruikswaarde, geen los verkrijgbaar pakket: de top-up kost nog steeds $ 20 of € 17,50 en voor API-toegang blijft een Growth-abonnement vereist. Bekijk de actuele prijzen van Datablist voor het volledige aanbod.

De optionele Instagram Profile Scraper heeft eigen kosten. Met een numerieke ID en scrapeType: "profile" beginnen die bij 2 credits voor ieder ingestuurd overlapprofiel.

Los veelvoorkomende input-, taak- en resultaatproblemen op

De API-key ontbreekt

Het script geeft vóór een HTTP-request de fout Set DATABLIST_API_KEY before running this script.. Exporteer de variabele in dezelfde shell en voer het bestand opnieuw uit.

De API weigert de key

response.raise_for_status() geeft een HTTP-fout. Controleer of je de Personal API Key correct hebt gekopieerd en of je account API-toegang via het Growth-abonnement heeft. Behoud de ene header X-API-Key uit het voorbeeld.

Een bronprofiel kan niet worden gevonden

Controleer of iedere waarde een username, een volledige Instagram-profiel-URL of een numerieke user-ID als string is. Bekijk de bestaande taak en de bijbehorende fout voordat je een nieuwe betaalde run aanmaakt.

Er zijn onvoldoende credits

Controleer je saldo en verlaag het aantal profielen of de aangevraagde limiet voordat je een nieuwe taak verstuurt. Een taak die al is gestart, kan nog steeds credits hebben verbruikt.

De taak is mislukt of gestopt

Het script toont de task-ID en geeft een RuntimeError. Gebruik die ID om de bestaande taak, de error, credits.used en eventuele gedeeltelijke resultaten te bekijken. Een mislukte of gestopte taak kan gegenereerde rijen bewaren. Controleer dit dus voordat je de taak opnieuw verstuurt.

Het resultaat wijkt af van de aangevraagde limiet

Rapporteer het werkelijke aantal uit de resultaten. limitPerProfile is een aangevraagde limiet en garandeert geen exact aantal. Eén resultaat laat bovendien niet zien waarom de provider meer of minder toegankelijke gebruikers retourneerde.

De response op de request is verloren gegaan

Vraag je recente source-taken op en zoek de uniqueId die vóór de POST werd getoond:

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"])

Blijf die task-ID pollen of haal de bestaande resultaten op. De documentatie voor Sources-taken behandelt de endpoints voor lijsten, statussen, resultaten en bewaartermijnen uitgebreid.

Volgende stappen

Je hebt nu één herbruikbare Python Requests-functie om Instagram-volgerrelaties op te halen, plus een lokaal rapport dat de verzamelde lijsten van Jupiter Hikes en Darwin on the Trail vergelijkt op numerieke user-ID. Ieder gedeeld record behoudt beide bronprofielen.

Vervang de voorbeelden door een kleine, zorgvuldig gecontroleerde selectie openbare creatorprofielen. Kies bewust een limiet per profiel en interpreteer de overlap vervolgens aan de hand van het werkelijke aantal resultaten per source. Je kunt het onderhouden synchrone Requests-voorbeeld downloaden of het onderhouden asynchrone HTTPX-voorbeeld gebruiken wanneer je non-blocking concurrency nodig hebt. Heb je eerst bronaccounts nodig, begin dan met de gids over Instagram-profielen vinden op basis van keywords.