Default Scraper

ICP Company Followers Scraper

Create an ICP-filtered Company Followers order from a LinkedIn company page. LeadsFriday exports the company followers, then applies the ICP criteria supplied with the request.

POST/api/linkedin-export/

Request parameters

NameTypeDescription

search_url*stringLinkedIn company page URL whose followers should be exported and filtered.

results_file_name*stringThe file name users will see in order history and delivery emails.

contact_count*numberNumber of records requested for this scraper order.

scraper_type*stringMust be icp so the order uses ICP Company Followers pricing and processing.

icp_filters*stringNonempty description of the people or company criteria to apply to the followers export.

notestringOptional delivery instructions. When omitted, the backend copies icp_filters into the order note.

verify_emailsstringLeave as no or omit it. ICP email verification is unavailable while its configured add-on price is zero.

callback_urlstringPublic HTTPS webhook URL notified when the order moves to in_progress, delivered, or cancelled.

Response

Accepted orders return a stable ID, current status, credit charge, and status URL.

{
  "message": "ICP Company Followers Scraper order created successfully",
  "credits_deducted": "4.50",
  "new_balance": "173.90",
  "order_id": 2037,
  "service": "linkedin_followers_icp",
  "status": "pending",
  "status_url": "https://api.leadsfriday.com/api/linkedin-export/2037/",
  "order_url": "https://api.leadsfriday.com/api/orders/2037/?service=linkedin_followers_icp",
  "results_file_name": "example-company-icp-followers.csv",
  "requested_count": 1000,
  "scraper_type": "icp",
  "icp_filters": "US-based founders and VP Sales at B2B SaaS companies with 50-500 employees",
  "verify_emails": "no",
  "verification_status": null,
  "verification_billable_count": null,
  "verification_error": null,
  "download_url": null,
  "callback_url": "https://example.com/webhooks/leadsfriday",
  "callback_signing_secret": "store-this-secret-returned-at-creation"
}

Good to know

Set scraper_type to icp and provide a nonempty icp_filters value. Requests missing either requirement are rejected with HTTP 400.

curl -X POST "https://api.leadsfriday.com/api/linkedin-export/" \ -H "Authorization: Bearer $LEADSFRIDAY_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "search_url": "your_search_url", "results_file_name": "your_results_file_name", "contact_count": 500, "scraper_type": "your_scraper_type", "icp_filters": "your_icp_filters" }'

{ "message": "ICP Company Followers Scraper order created successfully", "credits_deducted": "4.50", "new_balance": "173.90", "order_id": 2037, "service": "linkedin_followers_icp", "status": "pending", "status_url": "https://api.leadsfriday.com/api/linkedin-export/2037/", "order_url": "https://api.leadsfriday.com/api/orders/2037/?service=linkedin_followers_icp", "results_file_name": "example-company-icp-followers.csv", "requested_count": 1000, "scraper_type": "icp", "icp_filters": "US-based founders and VP Sales at B2B SaaS companies with 50-500 employees", "verify_emails": "no", "verification_status": null, "verification_billable_count": null, "verification_error": null, "download_url": null, "callback_url": "https://example.com/webhooks/leadsfriday", "callback_signing_secret": "store-this-secret-returned-at-creation" }