POST
https://spideriq.ai
/
api
/
v1
/
jobs
/
spiderFacebookPage
/
submit
Submit SpiderFacebookPage Job
curl --request POST \
  --url https://spideriq.ai/api/v1/jobs/spiderFacebookPage/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "payload": {
    "url": "<string>",
    "test": true
  },
  "priority": 123
}
'
{
  "job_id": "<string>",
  "type": "<string>",
  "status": "<string>",
  "created_at": "<string>",
  "message": "<string>",
  "data": {
    "name": "<string>",
    "facebook_id": "<string>",
    "facebook_url": "<string>",
    "profile_picture_url": "<string>",
    "profile_picture_stored": "<string>",
    "email": "<string>",
    "phone": "<string>",
    "address": "<string>",
    "website": "<string>",
    "category": "<string>",
    "followers": "<string>",
    "likes": "<string>",
    "rating": "<string>",
    "business_hours": {},
    "price_range": "<string>",
    "services": [
      {}
    ],
    "social_accounts": {},
    "is_business_page": true
  },
  "metadata": {
    "url": "<string>",
    "proxy_used": true,
    "profile_picture_stored": true
  }
}

​
Overview

SpiderFacebookPage extracts business information from Facebook pages including contact details, operating hours, ratings, and social links. Profile pictures are automatically stored in SpiderMedia.
Best For:
  • Enriching leads with Facebook business data
  • Extracting contact info (email, phone, address)
  • Getting social proof (followers, likes, rating)
  • Downloading and hosting profile pictures

​
Best For

  • Extracting business contact information from Facebook
  • Enriching Google Maps data with Facebook profiles
  • Building comprehensive business directories
  • Competitive analysis via follower/rating data
  • Profile picture collection and hosting

​
Request Body

​
payload
object
required
Job configuration payload
​
priority
integer
default:"5"
Job priority (0-10, higher = processed first).

​
Response

​
job_id
string
Unique job identifier (UUID format).
​
type
string
Always spiderFacebookPage.
​
status
string
Initial status: queued.
​
created_at
string
Job creation timestamp (ISO 8601).
​
message
string
Confirmation message.

​
Example Request

curl -X POST https://spideriq.ai/api/v1/jobs/spiderFacebookPage/submit \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "payload": {
      "url": "https://www.facebook.com/McDonalds"
    }
  }'

​
Example Response

201 Created
{
  "job_id": "ef89341d-1a55-401f-8eb0-ebce5b565f0a",
  "type": "spiderFacebookPage",
  "status": "queued",
  "created_at": "2026-01-18T14:30:00.000000",
  "message": "Job submitted successfully"
}

​
Results Structure

When the job completes, results include:

​
Business Information

​
data
object
Extracted Facebook page data.

​
Metadata

​
metadata
object
Processing metadata.

​
Complete Results Example

{
  "success": true,
  "job_id": "ef89341d-1a55-401f-8eb0-ebce5b565f0a",
  "type": "spiderFacebookPage",
  "status": "completed",
  "processing_time_seconds": 18.5,
  "data": {
    "data": {
      "name": "McDonald's",
      "facebook_id": "50245567013",
      "facebook_url": "https://www.facebook.com/McDonalds",
      "profile_picture_url": "https://scontent.xx.fbcdn.net/...",
      "profile_picture_stored": "https://media.spideriq.ai/client-cli_xxx/facebook-profiles/50245567013.jpg",
      "email": null,
      "phone": "(806) 445-0333",
      "address": null,
      "website": null,
      "category": "Page · Burger Restaurant",
      "followers": "82M followers",
      "likes": null,
      "rating": "32% recommend (38,574 Reviews)",
      "business_hours": null,
      "price_range": "Price Range · $",
      "services": null,
      "social_accounts": null,
      "is_business_page": true
    },
    "metadata": {
      "url": "https://www.facebook.com/McDonalds",
      "proxy_used": true,
      "profile_picture_stored": true
    }
  }
}

​
Data Extracted

FieldDescriptionExample
namePage/business name”McDonald’s”
facebook_idNumeric page ID”50245567013”
phoneContact phone”(806) 445-0333”
emailBusiness email”contact@example.com”
websiteExternal website”https://mcdonalds.com”
addressPhysical location”123 Main St, City”
categoryBusiness category”Burger Restaurant”
followersFollower count”82M followers”
ratingRating with reviews”32% recommend (38K Reviews)“
price_rangePrice level”$”, ”$$”, ”$$$“
business_hoursOperating hours{"Monday": "9AM-9PM", ...}
profile_picture_storedHosted image URLSpiderMedia URL

​
SpiderMedia Integration

Profile pictures are automatically uploaded to your client’s SpiderMedia bucket:
  • Original URL: Facebook CDN (may expire)
  • Stored URL: https://media.spideriq.ai/client-{client_id}/facebook-profiles/{facebook_id}.jpg
The stored URL is permanent and won’t expire, making it suitable for long-term storage and display.

​
SpiderProxy Integration

SpiderFacebookPage uses mobile proxies from the SpiderProxy pool for IP rotation:
  1. Job submitted with proxy assignment from available pool
  2. Worker attempts scraping with assigned proxy
  3. If proxy fails, worker retries without proxy as fallback
  4. metadata.proxy_used indicates which method succeeded

​
Processing Time

ScenarioTypical Time
Public business page10-20 seconds
With SpiderMedia upload15-25 seconds
Proxy fallback needed25-40 seconds

​
Error Cases

​
Invalid URL

{
  "detail": "Facebook page URL is required in payload"
}

​
Page Not Found / Private

{
  "success": false,
  "status": "failed",
  "error": "Library exited with code 1"
}
Private Pages: Some Facebook pages have privacy settings that prevent data extraction. These will return an error with “Library exited with code 1”. This commonly occurs with:
  • Personal profiles (not business pages)
  • Pages with restricted visibility
  • Newly created pages
  • Region-restricted pages

​
Limitations

  • Public pages only: Private or restricted pages cannot be scraped
  • Rate limiting: Facebook may block requests if too many jobs are submitted rapidly
  • Data availability: Not all pages have all fields (email, phone, hours, etc.)
  • Single URL: One Facebook page per job (no bulk submission)

​
Next Steps

Check Status

Monitor job progress

Get Results

Retrieve scraped data

Facebook Scraping Guide

Complete usage guide

SpiderMedia

Per-client media storage