ScraperCity logo

Instagram Leads API Documentation

Instagram Leads

Find Instagram profiles by keyword or hashtag, or read your own list of usernames, with each profile's public business email and phone, website, category, account type, followers, following, posts, bio and city. About half of the profiles found show a public email. Profiles with their own website also get a decision maker contact from the Lead Database where one matches. Profiles with an email come first in the file.

$0.0023 per profile found by keyword or hashtag, $0.0006 per profile from your own listPOST /api/v1/scrape/instagram-leads

Parameters

NameTypeRequiredDescription
modestringOptionalkeyword, hashtag or profiles (default: whichever of keywords, hashtags or profiles you send)Example: keyword
keywordsstring[]Optionalmode keyword: find profiles whose name or username matches, like Instagram's own search (up to 20)Example: ["coffee shop", "hair salon miami"]
hashtagsstring[]Optionalmode hashtag: find the profiles posting with these hashtags, with or without the # (up to 20)Example: ["funeralhome", "bakery"]
profilesstring[]Optionalmode profiles: Instagram usernames or profile links to read (up to 5,000)Example: ["natgeo", "https://www.instagram.com/nike/"]
maxResultsnumberOptionalThe most profiles to return (default 500, up to 5,000)Default: 500Example: 500

Examples

Coffee shops on Instagram with their emails

curl -X POST https://app.scrapercity.com/api/v1/scrape/instagram-leads \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keywords": ["coffee shop"],
    "maxResults": 500
  }'

Profiles posting with a hashtag

curl -X POST https://app.scrapercity.com/api/v1/scrape/instagram-leads \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "hashtags": ["funeralhome"],
    "maxResults": 200
  }'

Emails and phones for your own list of profiles

curl -X POST https://app.scrapercity.com/api/v1/scrape/instagram-leads \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profiles": ["natgeo", "https://www.instagram.com/nike/"]
  }'

Check status and download

curl -X GET https://app.scrapercity.com/api/v1/scrape/status/{runId} \
  -H "Authorization: Bearer YOUR_API_KEY"

# When status is SUCCEEDED, download the CSV
curl -L https://app.scrapercity.com/api/downloads/{runId} -o instagram-leads.csv

Use Cases

  • •Local businesses and shops that sell through Instagram: cafes, salons, boutiques, gyms, contractors
  • •Influencer and creator outreach by niche keyword or hashtag
  • •Brands posting with a hashtag in your market
  • •Fill in the email and phone for Instagram handles you already have

Best Practices

  • •Charged per profile returned; a search is charged at least what it cost to run, shown as a minimum charge
  • •Most searches finish in 1-5 minutes
  • •Use specific keywords (coffee shop austin rather than coffee): the search matches profile names and usernames
  • •Profiles that were deleted, renamed or are not found are skipped and not charged
  • •CSV columns: username, profile_url, full_name, email, phone, website, category, account_type, followers, following, posts, biography, is_verified, is_private, city, address, zip, found_by and contact_* columns

Every scrape returns a runId. Poll GET /api/v1/scrape/status/{runId} until it completes, then download via GET /api/downloads/{runId}?format=csv.

Authenticate every request with Authorization: Bearer YOUR_API_KEY. See the full API reference for authentication, rate limits and error codes.