Get Instagram Profile Scraper task results

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

Authorizations

X-API-Key or Authorizationstringheaderrequired

We recommend sending your Personal API Key in x-api-key. Datablist handles token renewal for you. Optionally, use an access token as Authorization: Bearer <token> if your application manages tokens itself. Send only one credential header.

Authentication options ↗

Read results from a Instagram Profile Scraper task using the task ID returned at creation. All enrichment 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 1,000. Defaults to 500.
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/enrichments/tasks/:taskId/results?limit=500&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 contains your inputId, a status, the data in outputs, and creditsUsed. If the input failed or no profile was found, error explains why; otherwise it is null.

profileUrl contains the resolved Instagram profile URL. Other fields keep their Instagram names, such as instagramUsername, instagramBio, and instagramFollowerCount. Contact details and other optional values depend on the selected mode and the information available for that account.

The schema lists known profile fields. Results can include additional fields, including instagramHomeCountry and instagramDateJoined when requesting "About this account" data. Missing information may be null. Use the result's status and error to interpret the outcome; the legacy instaEnrichmentStatus field is omitted.

instagramFullNamestring

The full name of the user

Enabled when: scrapeType!=about.

instagramBiostring

Instagram user bio.

Enabled when: scrapeType!=about.

instagramFollowerCountnumber

Instagram user follower count.

Enabled when: scrapeType!=about.

instagramFollowingCountnumber

Instagram user following count.

Enabled when: scrapeType!=about.

instagramCategorystring

Instagram user category name.

Enabled when: scrapeType!=about.

instagramWebsitestring

Instagram user external url.

Enabled when: scrapeType!=about.

format: "uri"

instagramEmailstring

Instagram user public email address.

Enabled when: scrapeType!=about,public.

format: "email"

instagramPhonestring

Instagram user phone number, when available.

Enabled when: scrapeType!=about,public.

instagramWhatsAppPhonestring

Instagram WhatsApp phone number, when available.

Enabled when: scrapeType!=about,public.

instagramAccountTypestring

Instagram Account Type. One of: PERSONAL, BUSINESS, CREATOR

Enabled when: scrapeType!=about,public.

instagramPicturestring

Instagram user profile picture.

Enabled when: scrapeType!=about.

format: "uri"

instagramPrivateboolean

Is the Instagram profile private.

Enabled when: scrapeType!=about.

instagramVerifiedboolean

Is the Instagram profile verified.

Enabled when: scrapeType!=about.

instagramIsBusinessboolean

Is the Instagram profile a business profile.

Enabled when: scrapeType!=about.

instagramMediaCountnumber

Number of posts posted

Enabled when: scrapeType!=about.

instagramZipCodestring

Enabled when: scrapeType!=about.

instagramCitystring

Enabled when: scrapeType!=about.

instagramStreetAddressstring

Enabled when: scrapeType!=about.

instagramLastLocationstring

If the user has posts with location information, retrieve the most recent location.

Enabled when: scrapeType==public.

instagramUserIdstring

Instagram internal id

instagramUsernamestring

Instagram username

profileUrlstring

Instagram profile URL

format: "uri"

Additional properties are supported.

Cost: Starts at 1 credit per profile

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 Profile Scraper API overview · Shared results guide

Request

PythoncURLJavaScriptPHPGo

import requests

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

headers = {
    "Accept": "application/json",
    "X-API-Key": "<personal-api-key>"
}

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

print(response.text)

Response · illustrative example

200

{
  "taskId": "00000000000040008000000000000001",
  "results": [
    {
      "inputId": "row-1",
      "status": "success",
      "outputs": {
        "profileUrl": "https://www.instagram.com/example.studio/",
        "instagramUserId": "1234567890",
        "instagramUsername": "example.studio",
        "instagramFullName": "Example Studio",
        "instagramBio": "Independent design studio.",
        "instagramFollowerCount": 12500,
        "instagramFollowingCount": 450,
        "instagramCategory": "Design",
        "instagramWebsite": "https://example.com",
        "instagramEmail": "hello@example.com",
        "instagramPhone": "+14155550100",
        "instagramWhatsAppPhone": "+14155550100",
        "instagramAccountType": "BUSINESS",
        "instagramPicture": "https://example.com/profile.jpg",
        "instagramPrivate": false,
        "instagramVerified": false,
        "instagramIsBusiness": true,
        "instagramMediaCount": 320,
        "instagramZipCode": "94105",
        "instagramCity": "San Francisco",
        "instagramStreetAddress": "123 Example Street"
      },
      "creditsUsed": "3",
      "error": null
    }
  ],
  "nextCursor": null
}