Is this task synchronous?

No. Create a task, poll its status, and download the result after the status becomes exported.

Which task type should I use?

Use `linkedin_username` for this product.

What does the result file contain?

It contains the submitted value and the product-specific fields documented in the Result Fields table below.

LinkedIn Username Profile Checker API: Bulk Profiles

Check LinkedIn public profiles by username or profile URL and return profile photo, name, headline, location, country, company, follower count, about, languages, education and work experience. Profiles that do not exist or are set to private are returned as not activated. The task uses the standard asynchronous batch workflow.

Input format

Upload a text file with one LinkedIn username per line. The public-profile slug, @slug and full linkedin.com/in/<slug> URLs are all accepted; values are matched case-insensitively.

williamhgates
@satyanadella
https://www.linkedin.com/in/john-smith-1a2b3c4/

Create a task

POST https://api.numberchecker.ai/v1/tasks

curl --location 'https://api.numberchecker.ai/v1/tasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'file=@"./input.txt"' \
--form 'task_type="linkedin_username"'

The API returns a task ID. Keep this ID and use it to poll the task status.

Upload response

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "pending",
  "total": 5000,
  "estimated_amount": {
    "amount": "0.500000",
    "currency": "USD"
  },
  "message": "Task created successfully"
}

Check task status

POST https://api.numberchecker.ai/v1/gettasks

curl --location 'https://api.numberchecker.ai/v1/gettasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'task_id="d4g8o46p2jvh04o9uolg"'

Poll until status becomes exported. Do not treat pending or processing as a completed result.

Processing response

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "processing",
  "total": 5000,
  "success": 2500,
  "failure": 0
}

Exported response

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "exported",
  "total": 5000,
  "success": 5000,
  "failure": 0,
  "result_url": "https://example-link-to-results.zip",
  "actual_amount": {
    "amount": "2.000000",
    "currency": "USD"
  }
}

Result Fields

Field	Description	Example
`username`	Input username or profile URL exactly as submitted.	williamhgates
`activated`	Whether a public profile was found for the username (`no` also covers private and non-existent profiles).	yes
`avatar`	Whether the profile has a real photo (`yes`/`no`).	yes
`avatar_url`	Profile photo URL (non-expiring).	https://media.licdn.com/dms/image/…
`name`	Full name.	Bill Gates
`headline`	Profile headline.	Chair, Gates Foundation
`location`	Location text as shown on the profile.	Seattle, Washington, United States
`country`	ISO country code derived from the location.	US
`company`	Current company.	Gates Foundation
`followers`	Follower count.	40653538
`about`	About section text.	Chair of the Gates Foundation. …
`badges`	Verification labels, e.g. `Creator, Top Voice`.	Creator, Top Voice
`languages`	Languages, `;`-separated.	English;German
`current_title`	Current job title when not hidden by the owner.	Co-chair
`education`	JSON list of `{organization,start,end}`.	[{“organization”:“Harvard University”,“start”:1973,“end”:1975}]
`experience`	JSON list of `{organization,start,end}`.	[{“organization”:“Gates Foundation”,“start”:2000}]
`masked`	Fields the owner’s visibility settings hid, `;`-separated.	jobTitle;worksFor

Result file handling

Download the file from result_url only after the task is exported. Preserve the returned column names when processing the file downstream.

Response fields

Field	Description
`created_at`	Timestamp when the task was created.
`updated_at`	Timestamp of the latest task status update.
`task_id`	Unique task identifier.
`status`	`pending`, `processing`, `exported`, or `failed`.
`total`	Total input values processed.
`success`	Values processed successfully.
`failure`	Values that failed processing.
`result_url`	Download URL when the task is exported.
`actual_amount`	Final settled amount, when available.
`estimated_amount`	Estimated amount returned when the task is created.

Status codes

Status	Description
`200`	Request successful.
`202`	Task created successfully and estimated charge applied.
`400`	Invalid file, unsupported task type, or too few valid entries.
`401`	Missing or invalid API key.
`402`	Insufficient account balance.
`403`	Product not available for your account (discontinued or whitelist-only); contact support.
`404`	Task not found.
`413`	Uploaded file is too large.
`500`	Internal server error; retry later.
`503`	Product temporarily unavailable (paused for maintenance); nothing is charged, retry later.

Operational notes

The task is asynchronous; use the task ID for status polling.
Check product-specific input limits before uploading.
Failed rows are reported in the exported result and reflected in the task counters.
The fields above are based on the current live sample and may change when the upstream export schema changes.