Puede extraer seguidores de Instagram con Python enviando uno o varios nombres de usuario, URLs de perfiles públicos o IDs numéricos de usuario a la Instagram Followers Scraper API de Datablist mediante la librería Requests. La API devuelve los registros de seguidores en formato JSON e identifica el perfil de origen de cada relación.

Esta guía comienza con los seguidores recopilados de Jupiter Hikes, senderista de larga distancia y cineasta. Después, reutilizo la misma función de Python para comparar sus seguidores recopilados con los de Darwin on the Trail, otro senderista de larga distancia y cineasta especializado en actividades al aire libre. El código agrupa los resultados por ID numérico de usuario de Instagram y encuentra los usuarios presentes en ambas listas.

🔑 Resumen para quienes tienen prisa

Utilice la Instagram Followers Scraper API de Datablist para extraer seguidores de perfiles públicos de Instagram con Python. Envíe los perfiles que quiera analizar, establezca un límite por perfil y recupere en formato JSON los registros de seguidores disponibles para sus procesos de investigación o marketing. Antes de comenzar, compruebe que Instagram le permite consultar los seguidores de cada perfil.

  • Entrada: nombres de usuario, URLs de perfiles o IDs numéricos de usuario de Instagram.
  • Salida: registros de seguidores con IDs de usuario, datos disponibles del perfil y el perfil de origen del que procede cada seguidor.

💡 ¿Prefiere una solución no-code? Utilice la fuente Instagram Followers de Datablist para generar filas de seguidores sin escribir código.

La guía para recopilar seguidores de Instagram mediante una colección explica cómo usar la misma fuente desde la interfaz de Datablist. El resto de esta guía se centra en la API.

Compruebe si Instagram limita la lista de seguidores

Antes de iniciar la extracción, abra el perfil de Instagram de destino y haga clic en Seguidores. Compruebe que puede consultar la lista. Que un perfil sea público no garantiza que Instagram muestre todos sus seguidores.

Si ve el mensaje «Solo [nombre de usuario] puede ver todos los seguidores», el scraper devolverá una lista parcial, aunque el perfil sea público. La API solo puede recuperar los seguidores que Instagram pone a disposición; aumentar el límite solicitado no permite acceder a seguidores ocultos.

Aviso sobre la visibilidad de seguidores en el perfil de Instagram de Levi’s.
Aviso sobre la visibilidad de seguidores en el perfil de Instagram de Levi’s.

Revise todos los perfiles que vaya a extraer para confirmar, antes de iniciar la solicitud a la API, que la lista de seguidores disponible sea suficiente para su objetivo.

Configure Python y su clave API de Datablist

El acceso a la REST API de Datablist está incluido en el plan Growth. Las tareas de Sources también consumen créditos. Más adelante detallo el coste de esta fuente de seguidores.

Cree una Personal API Key en la página de la API de su cuenta de Datablist. En este ejemplo utilizo el paquete requests. Cree una carpeta para el proyecto, ábrala en una terminal y ejecute:

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

Cree un archivo llamado scrape_instagram_followers.py y guarde su clave en la variable de entorno DATABLIST_API_KEY:

shell
export DATABLIST_API_KEY="your-api-key"

El script lee esta variable y envía su valor mediante el encabezado X-API-Key.

Extraiga seguidores de Instagram con una función de Python

La primera solicitud utiliza jupiterhikes, el nombre de usuario del creador y senderista de larga distancia Jupiter Hikes. La fuente también admite la URL completa de un perfil o un ID numérico de usuario de Instagram en formato string. Por ejemplo, el ID numérico de Jupiter Hikes es "1507518892".

Pegue este script completo en 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))

Ejecútelo con:

shell
python scrape_instagram_followers.py

La función realiza tres tipos de llamadas a la API, en este orden.

  1. POST /v1/sources/tasks envía el ID de la fuente y su configuración. La API acepta la tarea en segundo plano y devuelve su ID.
  2. GET /v1/sources/tasks/{taskId} consulta la tarea cada tres segundos. El cliente Requests espera, pero la tarea se ejecuta de forma asíncrona en Datablist.
  3. GET /v1/sources/tasks/{taskId}/results recupera una página de objetos planos de seguidores. El bucle reenvía sin modificar cada nextCursor que no sea nulo hasta que la API devuelve null.

El ejemplo establece scrapingType como followers y solicita 100 usuarios mediante limitPerProfile. Considere 100 como un límite solicitado, no como una cantidad exacta de resultados. Los límites de página del proveedor y los usuarios disponibles durante la tarea pueden alterar el número devuelto.

El script muestra uniqueId antes de enviar la solicitud. Si se pierde la conexión durante el POST, este valor le ayudará a localizar la tarea aceptada y evitará que cree inmediatamente otra ejecución de pago.

Cómo crea la API los registros de relación

Primero, Datablist resuelve cada nombre de usuario, URL completa de perfil o ID numérico para identificar el perfil de Instagram de origen. Después, el proceso en segundo plano recupera las páginas de seguidores y gestiona el cursor del proveedor. Usted solo tiene que gestionar la tarea de Datablist y los cursores de las páginas de resultados que aparecen en el script.

Los IDs de usuario repetidos se deduplican dentro de la lista devuelta para un mismo perfil de origen. Cuando un usuario aparece bajo dos creadores enviados, la API conserva dos registros de relación. Cada uno contiene campos followerSourceProfile... distintos. Este comportamiento permite comparar las audiencias.

Utilice estos campos en las secciones siguientes:

  • instagramUserId es la clave estable para comparar los usuarios devueltos.
  • instagramUsername, instagramFullName y los demás campos instagram... describen al seguidor cuando el dato público está disponible.
  • followerSourceProfileId, followerSourceProfileUsername y followerSourceProfileUrl identifican al creador de partida.

Esta fuente recupera listas de relaciones. No busca candidatos ni calcula puntuaciones de confianza.

Analice los resultados de Jupiter Hikes

La tarea completada de Jupiter Hikes devolvió 124 registros únicos de seguidores y consumió 2,24 créditos. Aunque la solicitud indicaba limitPerProfile: 100, el recuento era de 99 antes de que el proveedor devolviera otra página con 25 usuarios. Datablist conservó la página completa, por lo que el resultado alcanzó los 124.

Esta es la respuesta de la última página de resultados. Se mantienen intactos tanto el contenedor como los cuatro objetos de seguidores devueltos:

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
}

El primer registro tiene el ID numérico de usuario 52256365838, el nombre de usuario adventuresoforest y los campos públicos disponibles del perfil. Su followerSourceProfileUsername es jupiterhikes, por lo que puede saber qué perfil enviado originó la relación. La tarea puede completarse aunque falte algún dato opcional del perfil. Lea los campos existentes en lugar de reconstruir cada registro a partir de un esquema fijo.

Compare dos audiencias por ID de usuario de Instagram

Cuando la solicitud de un solo perfil funcione, reutilice scrape_instagram_users() con ambos creadores de contenido de senderismo en una misma tarea. Agrupe las relaciones devueltas por ID numérico de usuario y conserve todos los nombres de usuario de origen asociados a cada 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))

La tarea con dos perfiles devolvió 124 relaciones de seguidores para Jupiter Hikes y 46 para Darwin on the Trail. Tres IDs numéricos aparecieron en ambas listas recopiladas. La tarea consumió 2,7 créditos.

El código de agrupación utiliza instagramUserId en lugar del nombre de usuario porque el ID es la clave estable para combinar registros que devuelve la API. Conserva un objeto de usuario completo de la API y añade una lista ordenada source_profiles. Para cada uno de los tres IDs compartidos, esta lista contiene darwin_onthetrail y jupiterhikes.

Por ejemplo, el ID numérico 42048393083 aparece una vez en los resultados de Jupiter Hikes y otra en los de Darwin on the Trail. Ambos registros corresponden al nombre de usuario hikingful, pero cada uno incluye un followerSourceProfileUsername diferente. El código de agrupación combina estos dos registros de relación en un único objeto de usuario con source_profiles: ["darwin_onthetrail", "jupiterhikes"].

Dos listas recopiladas de seguidores de Instagram combinadas por ID numérico de usuario para detectar el solapamiento de audiencias y conservar ambos perfiles de origen
Dos listas recopiladas de seguidores de Instagram combinadas por ID numérico de usuario para detectar el solapamiento de audiencias y conservar ambos perfiles de origen

📘 Interprete el solapamiento de forma estricta: Un ID compartido apareció en ambas muestras devueltas. Esto no mide el solapamiento total entre las audiencias de los creadores, no demuestra que la cuenta siga siguiéndolos en la fecha de publicación ni la convierte en apta para acciones de Outbound.

Los valores de collected_count dejan claro el denominador. Si calcula un porcentaje, etiquételo de forma precisa. Por ejemplo, 3 / 124 representa los IDs compartidos como porcentaje de los registros de Jupiter Hikes recopilados en esta tarea.

Si prefiere un script local para el navegador, consulte la guía para extraer gratis seguidores, listas de seguidos y autores de publicaciones de Instagram.

Enriquezca perfiles compartidos para analizar la audiencia

El solapamiento proporciona IDs numéricos de Instagram y la procedencia de cada relación. Un siguiente paso práctico consiste en enviar esos IDs compartidos al enrichment Instagram Profile Scraper y segmentar después los resultados correctos según la web, el email público, la biografía, la categoría o las métricas disponibles del perfil.

Añada esta segunda función debajo de la función de la fuente. Utiliza la misma clave API y la misma secuencia de envío, consulta y paginación:

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

Cuando las dos listas recopiladas no comparten ningún ID, overlap queda vacío y la función devuelve [] antes de enviar una solicitud POST. Así puede continuar con un segmento de investigación vacío sin crear una tarea de enrichment de pago.

Usar cada ID numérico como inputId y como instagramIdentifier permite volver a combinar los resultados con el solapamiento sin ambigüedades. Conserve todos los objetos devueltos, incluidos los estados fallidos, los resultados vacíos, el consumo de créditos y los errores. Aplique filtros únicamente cuando cree un segmento local.

El modo profile parte de 2 créditos por ID numérico y puede devolver la biografía pública, la web, el email o el teléfono cuando el perfil los muestra, además de recuentos y datos sobre la categoría. Un perfil encontrado puede tener igualmente vacíos los campos de contacto. El código prepara segmentos de investigación de forma local. No envía mensajes ni interpreta que un seguidor compartido haya dado su consentimiento para recibir comunicaciones.

Para realizar este proceso sin código, utilice Instagram Profile Scraper de Datablist.

Cambie de seguidores a cuentas seguidas

La misma fuente puede recuperar las cuentas que sigue un perfil enviado. Solo tiene que cambiar el argumento scraping_type:

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

Estos registros describen las cuentas que sigue Jupiter Hikes. La procedencia pasa a los campos followingSourceProfileId, followingSourceProfileUsername y followingSourceProfileUrl. Utilice la cantidad real devuelta, igual que en el modo followers.

Calcule el coste de la API de seguidores de Instagram

La fuente de seguidores de Instagram consume 0,01 créditos por cada usuario devuelto, ya sea un seguidor o una cuenta seguida. Resolver cada perfil de origen enviado puede consumir hasta 1 crédito adicional. Si la resolución está almacenada en caché, el coste real puede ser menor.

Para dos perfiles y un límite solicitado de 100 usuarios por perfil, una estimación sería:

2 × (1 + 100 × 0,01) = 4 créditos

Se trata de una estimación, no de un límite máximo. La tarea con dos perfiles devolvió 170 registros de relación y consumió 2,7 créditos. Consulte task.credits.used después de la ejecución para conocer el coste real.

Loading pricing…

El acceso a la API, los créditos incluidos en el plan, las recargas opcionales y el consumo de las tareas son conceptos independientes. El plan mensual Growth cuesta 50 $ o 50 € e incluye acceso a la REST API y 20.000 créditos mensuales. La recarga mínima actual añade 20.000 créditos por 20 $ o 17,50 €.

Con estas tarifas de recarga, 1.000 usuarios devueltos consumen 10 créditos. Ese uso equivale a 0,01 $ o 0,00875 €, sin contar la resolución de los perfiles de origen. Es un valor de consumo normalizado, no un paquete que pueda comprar: la recarga sigue costando 20 $ o 17,50 €, y para acceder a la API continúa siendo necesaria la suscripción Growth. Consulte las tarifas actuales de Datablist.

Instagram Profile Scraper es opcional y tiene su propio coste. Con un ID numérico y scrapeType: "profile", parte de 2 créditos por cada perfil compartido enviado.

Solucione problemas de entrada, tareas y resultados

Falta la clave API

El script genera el error Set DATABLIST_API_KEY before running this script. antes de realizar una solicitud HTTP. Exporte la variable en la misma shell y vuelva a ejecutar el archivo.

La API rechaza la clave

response.raise_for_status() genera un error HTTP. Compruebe que ha copiado correctamente la Personal API Key y que su cuenta tiene acceso a la API mediante el plan Growth. Mantenga el único encabezado X-API-Key utilizado en el ejemplo.

No se puede resolver un perfil de origen

Compruebe que cada valor sea un nombre de usuario, la URL completa de un perfil de Instagram o un ID numérico de usuario en formato string. Revise la tarea existente y su error antes de crear otra ejecución de pago.

No hay créditos suficientes

Compruebe su saldo y reduzca el número de perfiles o el límite solicitado antes de enviar otra tarea. Una tarea que ya ha comenzado puede haber consumido créditos.

La tarea ha fallado o se ha detenido

El script muestra el ID de la tarea y genera un RuntimeError. Utilice ese ID para revisar la tarea existente, su campo error, el valor credits.used y los resultados parciales disponibles. Una tarea fallida o detenida puede conservar las filas generadas, así que revíselas antes de volver a enviarla.

La cantidad devuelta no coincide con el límite

Indique la cantidad real de resultados. limitPerProfile es un límite solicitado: no garantiza una cifra exacta, y un único resultado no permite saber por qué el proveedor devolvió más o menos usuarios accesibles.

Se perdió la respuesta del envío

Consulte sus tareas de Sources recientes y busque el uniqueId que se mostró antes del POST:

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

Continúe consultando ese ID de tarea o recupere sus resultados existentes. La documentación sobre tareas de Sources explica en detalle los endpoints de listado, estado, resultados y retención.

Próximos pasos

Ahora dispone de una función reutilizable de Python Requests para recuperar relaciones de seguidores de Instagram y de un informe local que compara las listas recopiladas de Jupiter Hikes y Darwin on the Trail mediante el ID numérico de usuario. Cada registro compartido conserva ambos perfiles de origen.

Sustituya los ejemplos por un conjunto reducido y revisado de perfiles públicos de creadores. Elija de forma deliberada un límite por perfil e interprete el solapamiento según la cantidad real devuelta para cada fuente. Puede descargar el ejemplo síncrono mantenido para Requests o utilizar el ejemplo asíncrono mantenido para HTTPX cuando necesite concurrencia no bloqueante. Si primero necesita encontrar cuentas de origen, empiece por la guía para buscar perfiles de Instagram por palabras clave.