Create Instagram Followers/Following Scraper task

post/v1/sources/tasks

Authorizations

Authorizationstringheaderrequired

Use an account access token as Bearer <token>.

Get an access token ↗

Generate followers or following users for one or more Instagram profiles, without input rows or a Datablist collection. Results are flat objects, not per-input enrichment outcomes.

Public ID: instagram-source. Get the current definition. You can read it without authentication.

Settings

Put one username, numeric user ID, or profile URL per line in profiles.

Set scrapingType to followers (default) or following. To limit the request, set limitPerProfile to a positive integer. Without it, there is no requested limit. The number returned can differ from the number requested.

The task handles Instagram pagination for you. Do not send collection resume settings.

Followers results identify the starting profile through followerSourceProfileId, followerSourceProfileUsername, and followerSourceProfileUrl. Following mode uses the equivalent followingSource… fields.

resumeScrapestring

Resume a followers/following scrape started in this workspace within the last 7 days. When you resume a scrape, the selected profile and scrape type are reused automatically. ⚠️ A Datablist collection can contain up to 100k scraped profiles. To scrape more, resume this scrape in a different collection.

profilesstring

Instagram Profiles to scrape. Use one profile per line. Use profile username, profile user id, or profile Instagram URL. Examples: https://www.instagram.com/tiboinshape/ k.mbappe 4213518589

Enabled when: resumeScrape==false.

scrapingTypestring

Choose whether to scrape Instagram followers or following users. Defaults to followers.

Enabled when: resumeScrape==false.

Allowed values: "followers", "following"

limitPerProfilenumber

Define the max number of followers/following to scrape for each profile. Default to no limit. 📘 Startup estimate: 1.25 credits for 1 source profile(s). Actual charges depend on returned results.

Additional properties are supported.

Credits and limits

Cost: 0.01 credits per follower/following

Profile resolution and returned objects can consume credits, including work that generates no objects. Use credits.used on the task for actual usage. A requested result limit is not a price cap; maxCredits is a best-effort budget.

Tasks can run for up to 24 hours; completed, failed, or stopped tasks are kept for 90 days. Enrichment and source tasks share your account balance and task limits. Set maxCredits to stop starting new work after a credit threshold; work already underway can still exceed it. See limits and errors.

Accepted task

The API returns 202 Accepted with a task ID. Save it and check links.self every few seconds. Once the task is completed, failed, or stopped, get Instagram Followers/Following Scraper task results. The response below is sample data.

Instagram Followers/Following Scraper overview · Shared task reference

Request

PythoncURLJavaScriptPHPGo

import requests

url = "https://api.datablist.com/v1/sources/tasks"

headers = {
    "Accept": "application/json",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

payload = {
    "sourceId": "instagram-source",
    "uniqueId": "instagram-source-example",
    "settings": {
        "profiles": "example_profile",
        "scrapingType": "followers",
        "limitPerProfile": 100
    }
}

response = requests.post(url, headers=headers, json=payload)

print(response.text)

Response · illustrative example

202

{
  "@id": "00000000000040008000000000000001",
  "@type": "SourceTask",
  "kind": "source",
  "sourceId": "instagram-source",
  "uniqueId": "instagram-source-example",
  "status": "queued",
  "createdAt": "2026-10-09T10:00:00Z",
  "startedAt": null,
  "finishedAt": null,
  "progress": {
    "results": 0
  },
  "credits": {
    "used": "0",
    "max": null
  },
  "error": null,
  "links": {
    "self": "https://api.datablist.com/v1/sources/tasks/00000000000040008000000000000001",
    "results": "https://api.datablist.com/v1/sources/tasks/00000000000040008000000000000001/results"
  }
}