Create Instagram Profile Scraper task

post/v1/enrichments/tasks

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 ↗

Extract names, bios, follower counts, websites, and other profile details from Instagram. Choose a scraping mode to include available public contact details or "About this account" data.

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

Settings

Use scrapeType to choose what to retrieve:

• profile (default): profile details, including public email and phone numbers when available.
• profile_about: profile details plus "About this account" data.
• about: only "About this account" data, such as home country and date joined.
• public: a cheaper profile lookup without email or phone details. It can also return the most recent location when available.

scrapeTypestring

• The private profile includes the public phone_number and public email address if provided by the user. It costs 2 credits if the input is an Instagram Id. 2+1 credits if the input is an URL or an username.
• The "About this account" data have two outputs: "Home Country" and "Date Joined". "About" data scraping costs 2 credits. 2+1 credits if the input is an URL or an username.
• The public profile doesn't include phone or email but is cheaper. It costs 1 credit if the input is an username or an URL. 1+1 credits if the input is the Instagram Id.

Allowed values: "profile", "profile_about", "about", "public"

Additional properties are supported.

Inputs

Give each input an inputId you can use to match its result to your record. Put the Instagram identifier in data.instagramIdentifier.

instagramIdentifier accepts a full URL such as https://www.instagram.com/example.studio/, a username such as example.studio, or a numeric user ID as a string, such as "1234567890". Send IDs as strings.

For follower or following lists, use Instagram Followers/Following.

instagramIdentifierstringrequired

Instagram user URL (https://www.instagram.com/tomhanks/), or username (tomhanks), or Instagram id (1758466516).

Additional properties are supported.

Credits and limits

Cost: Starts at 1 credit per profile

Public profile scraping starts at 1 credit per profile. Standard profile and "About this account" lookups each start at 2 credits; combining both starts at 4 credits. Converting a username or URL to an ID, or resolving an ID for a public lookup, can add a credit. Pricing varies, so creditsPerInput is null. Check each result's creditsUsed and the task's credits.used for actual usage.

Send 1–10,000 inputs per task, within 16 KiB per input and 10 MiB per request. Tasks can run for up to 24 hours; completed, failed, or stopped tasks are kept for 90 days.

You can set maxCredits to stop starting new work after a credit threshold. Work already underway can still exceed it. Enrichment and source tasks share your account balance and task limits. 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 Profile Scraper task results. The response below is sample data.

Instagram Profile Scraper API overview · Shared task reference

Request

PythoncURLJavaScriptPHPGo

import requests

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

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

payload = {
    "enrichmentId": "instagram-profile-scraper",
    "uniqueId": "instagram-profile-scraper-example",
    "settings": {
        "scrapeType": "profile"
    },
    "inputs": [{
        "inputId": "row-1",
        "data": {
            "instagramIdentifier": "https://www.instagram.com/example.studio/"
        }
    }]
}

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

print(response.text)

Response · illustrative example

202

{
  "@id": "00000000000040008000000000000001",
  "@type": "EnrichmentTask",
  "kind": "enrichment",
  "enrichmentId": "instagram-profile-scraper",
  "uniqueId": "instagram-profile-scraper-example",
  "status": "queued",
  "createdAt": "2026-11-04T10:00:00Z",
  "startedAt": null,
  "finishedAt": null,
  "progress": {
    "totalInputs": 1,
    "finishedInputs": 0
  },
  "credits": {
    "used": "0",
    "max": null
  },
  "error": null,
  "links": {
    "self": "https://api.datablist.com/v1/enrichments/tasks/00000000000040008000000000000001",
    "results": "https://api.datablist.com/v1/enrichments/tasks/00000000000040008000000000000001/results",
    "inputs": "https://api.datablist.com/v1/enrichments/tasks/00000000000040008000000000000001/inputs"
  },
  "outcomes": {
    "success": 0,
    "noResult": 0,
    "error": 0,
    "skipped": 0
  }
}