Get Instagram Followers/Following Scraper task results

get/v1/sources/tasks/{taskId}/results

Authorizations

Authorizationstringheaderrequired

Use an account access token as Bearer <token>.

Get an access token ↗

Read results from a Instagram Followers/Following Scraper task using the task ID returned at creation. All source tools use this endpoint; the task ID selects the results.

Parameters

Parameter	Location	Required	Description
taskId	Path	Yes	Your actual task ID from the create response.
limit	Query	No	Results per page, from 1 to 100. Defaults to 50.
cursor	Query	No	The previous page's non-null nextCursor, passed unchanged. Omit it for the first page.

Pagination example: GET https://api.datablist.com/v1/sources/tasks/:taskId/results?limit=50&cursor=XX.

Task readiness

Read results when the task is completed, failed, or stopped. While it is active, this endpoint returns 409 ResultsNotReady. Failed and stopped tasks can still have results and credit usage. Use the status endpoint to check progress; this page does not check or retry automatically.

Outputs

Each result is a JSON object with the fields below. Fields depend on your settings and the data found; extra fields can appear before the catalog lists them.

instagramUserIdstring

Instagram internal id

instagramUsernamestring

Instagram username

instagramProfileUrlstring

Instagram profile URL

format: "uri"

instagramFullNamestring

The full name of the user

instagramPicturestring

Instagram user profile picture.

format: "uri"

instagramPrivateboolean

Is the Instagram profile private.

instagramVerifiedboolean

Is the Instagram profile verified.

followerSourceProfileIdstring

Is a follower of XX

Enabled when: scrapingType==followers,false.

followerSourceProfileUsernamestring

Is a follower of XX

Enabled when: scrapingType==followers,false.

followerSourceProfileUrlstring

Is a follower of XX

Enabled when: scrapingType==followers,false.

format: "uri"

followingSourceProfileIdstring

Is followed by

Enabled when: scrapingType==following.

followingSourceProfileUsernamestring

Is followed by

Enabled when: scrapingType==following.

followingSourceProfileUrlstring

Is followed by

Enabled when: scrapingType==following.

format: "uri"

Additional properties are supported.

Cost: 0.01 credits per follower/following

Sample results

The response below uses sample data and credit amounts. Pages are at most 128 KiB. If nextCursor is not null, pass it unchanged as cursor in the next request.

Instagram Followers/Following Scraper overview · Shared results guide

Request

PythoncURLJavaScriptPHPGo

import requests

url = "https://api.datablist.com/v1/sources/tasks/<taskId>/results"

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

response = requests.get(url, headers=headers)

print(response.text)

Response · illustrative example

200

{
  "taskId": "00000000000040008000000000000001",
  "results": [
    {
      "instagramUsername": "example_user",
      "instagramProfileUrl": "https://www.instagram.com/example_user/",
      "instagramFullName": "Example User",
      "instagramPrivate": false,
      "instagramVerified": false
    }
  ],
  "nextCursor": null
}