Submit SpiderPublicInstagram Job

POST/api/v1/jobs/spiderPublicInstagram/submit

Overview

SpiderPublicInstagram extracts public profile data from Instagram using the direct web API. No Instagram login is required - it uses the web_profile_info endpoint to fetch profile information.

info

No Authentication Required: This worker uses Instagram's public web API endpoint. It does not require Instagram login credentials, making it safe and compliant for public data extraction.

Best For

Extracting business contact information (email, phone)
Getting follower/following counts and engagement metrics
Downloading and hosting profile images permanently
Verifying Instagram presence for lead enrichment
Building influencer databases with verified metrics

Request Body

payloadobjectrequired

Job configuration payload

properties

usernamestring

Instagram username (without @ symbol).

Example: natgeo

Note: Either username or instagram_url is required.

instagram_urlstring

Full Instagram profile URL.

Supported Formats:

https://instagram.com/username
https://www.instagram.com/username/
https://instagram.com/username?igsh=...

Note: Either username or instagram_url is required.

extract_contact_from_biobooleandefault: true

Extract email addresses and phone numbers from bio text using regex patterns.

Useful for finding contact info that users list in their bio.

store_profile_imagebooleandefault: true

Upload profile image to SpiderMedia (per-client storage).

Returns a permanent hosted URL instead of Instagram's CDN URL which may expire.

testbooleandefault: false

Route to test queue (local workers only).

Use for development and testing.

priorityintegerdefault: 5

Job priority (0-10, higher = processed first).

Response

job_idstring

Unique job identifier (UUID format).

typestring

Always spiderPublicInstagram.

statusstring

Initial status: queued.

created_atstring

Job creation timestamp (ISO 8601).

messagestring

Confirmation message.

Example Request

cURL - Basic
cURL - With URL
Python
JavaScript

curl -X POST https://spideriq.ai/api/v1/jobs/spiderPublicInstagram/submit \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "payload": {
      "username": "natgeo"
    }
  }'

curl -X POST https://spideriq.ai/api/v1/jobs/spiderPublicInstagram/submit \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "payload": {
      "instagram_url": "https://instagram.com/natgeo",
      "extract_contact_from_bio": true,
      "store_profile_image": true
    }
  }'

import requests

url = "https://spideriq.ai/api/v1/jobs/spiderPublicInstagram/submit"
headers = {
    "Authorization": "Bearer <your_token>",
    "Content-Type": "application/json"
}

data = {
    "payload": {
        "username": "natgeo",
        "extract_contact_from_bio": True,
        "store_profile_image": True
    }
}

response = requests.post(url, headers=headers, json=data)
job = response.json()
print(f"Job ID: {job['job_id']}")

const response = await fetch(
  'https://spideriq.ai/api/v1/jobs/spiderPublicInstagram/submit',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer <your_token>',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      payload: {
        username: 'natgeo',
        extract_contact_from_bio: true,
        store_profile_image: true
      }
    })
  }
);

const job = await response.json();
console.log('Job ID:', job.job_id);

Example Response

{
  "job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "type": "spiderPublicInstagram",
  "status": "queued",
  "created_at": "2026-01-18T14:30:00.000000",
  "message": "Job submitted successfully"
}

Results Structure

When the job completes, results include:

Profile Data

usernamestring

Instagram username.

full_namestring

Display name on profile.

biostring

Profile biography text.

profile_pic_urlstring

Original Instagram CDN profile image URL.

Note: This URL may expire. Use profile_pic_url_hosted for permanent access.

profile_pic_url_hostedstring

SpiderMedia hosted profile image URL (permanent).

Format: https://media.spideriq.ai/client-{id}/instagram_profile_{username}.jpg

external_urlstring

Website link in profile bio.

Engagement Metrics

follower_countinteger

Number of followers.

following_countinteger

Number of accounts following.

post_countinteger

Total number of posts.

Account Type

is_business_accountboolean

Whether this is a business account.

is_professional_accountboolean

Whether this is a professional/creator account.

is_privateboolean

Whether the profile is private.

Note: Private profiles return limited data.

is_verifiedboolean

Whether the account has a verified badge.

Business Information

business_categorystring

Business category (e.g., "Media/News Company", "Restaurant").

Only available for business accounts.

business_emailstring

Business contact email from profile settings.

Only available for business accounts with email configured.

business_phonestring

Business contact phone from profile settings.

Only available for business accounts with phone configured.

Extracted Contacts

bio_emailsarray

Email addresses extracted from bio text using regex.

Example: ["contact@company.com", "sales@company.com"]

bio_phonesarray

Phone numbers extracted from bio text using regex.

Supports US format, international format, and raw digits.

Metadata

metadataobject

Processing metadata.

metadata properties

instagram_idstring

Internal Instagram user ID

sourcestring

Always instagram_web_api

has_hosted_imageboolean

Whether image was uploaded to SpiderMedia

Complete Results Example

{
  "success": true,
  "job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "type": "spiderPublicInstagram",
  "status": "completed",
  "processing_time_seconds": 4.52,
  "data": {
    "username": "natgeo",
    "full_name": "National Geographic",
    "bio": "Experience the world through the eyes of National Geographic photographers. Contact: partnerships@natgeo.com",
    "profile_pic_url": "https://scontent-iad3-1.cdninstagram.com/v/t51.2885-19/...",
    "profile_pic_url_hosted": "https://media.spideriq.ai/client-cli_abc123/instagram_profile_natgeo.jpg",
    "external_url": "https://natgeo.com",
    "follower_count": 283000000,
    "following_count": 150,
    "post_count": 32000,
    "is_business_account": true,
    "is_professional_account": true,
    "is_private": false,
    "is_verified": true,
    "business_category": "Media/News Company",
    "business_email": "contact@natgeo.com",
    "business_phone": "+12025551234",
    "bio_emails": ["partnerships@natgeo.com"],
    "bio_phones": [],
    "metadata": {
      "instagram_id": "787132",
      "source": "instagram_web_api",
      "has_hosted_image": true
    }
  }
}

Processing Time

Configuration	Typical Time
Basic profile extraction	3-5 seconds
With profile image upload	5-8 seconds
With mobile proxy	Add 2-5 seconds

Rate Limiting

Instagram has strict rate limits:

Limit Type	Threshold
Requests per hour per IP	~200
Built-in delay between requests	3-10 seconds (randomized)

warning

Mobile Proxies Recommended

Datacenter IPs are quickly blocked by Instagram. For production use, mobile proxies from SpiderProxy are automatically assigned to provide carrier-grade IP addresses.

Error Cases

Invalid Input

{
  "detail": "Either 'username' or 'instagram_url' must be provided"
}

Profile Not Found

{
  "success": false,
  "status": "failed",
  "error": "Instagram profile not found: invalidusername123"
}

Rate Limited

{
  "success": false,
  "status": "failed",
  "error": "Instagram rate limit exceeded. Retry after 300s"
}

IP Blocked

{
  "success": false,
  "status": "failed",
  "error": "Instagram blocked the request. Mobile proxy required."
}

Private Profiles

Private profiles will return limited data:

{
  "username": "private_user",
  "full_name": "Private User",
  "bio": "",
  "is_private": true,
  "follower_count": 500,
  "following_count": 200,
  "post_count": 50
}

info

Private Profile Limitations:

No bio content
No business information
No external URL
Profile image may still be available

Next Steps

Monitor job progress

Retrieve profile data

Complete Instagram workflow

Scrape Instagram link websites

Submit SpiderPublicInstagram Job

Overview

Best For

Request Body

Response

Example Request

Example Response

Results Structure

Profile Data

Engagement Metrics

Account Type

Business Information

Extracted Contacts

Metadata

Complete Results Example

Processing Time

Rate Limiting

Error Cases

Invalid Input

Profile Not Found

Rate Limited

IP Blocked

Private Profiles

Next Steps

Check Status

Get Results

Instagram Guide

SpiderSite

Overview​

Best For​

Request Body​

Response​

Example Request​

Example Response​

Results Structure​

Profile Data​

Engagement Metrics​

Account Type​

Business Information​

Extracted Contacts​

Metadata​

Complete Results Example​

Processing Time​

Rate Limiting​

Error Cases​

Invalid Input​

Profile Not Found​

Rate Limited​

IP Blocked​

Private Profiles​

Next Steps​

Check Status

Get Results

Instagram Guide

SpiderSite

Overview

Best For

Request Body

Response

Example Request

Example Response

Results Structure

Profile Data

Engagement Metrics

Account Type

Business Information

Extracted Contacts

Metadata

Complete Results Example

Processing Time

Rate Limiting

Error Cases

Invalid Input

Profile Not Found

Rate Limited

IP Blocked

Private Profiles

Next Steps