ScraperCity logo

Mobile Finder API Documentation

Mobile Finder

Find mobile phone numbers from social profile URLs or work email addresses.

$0.25 per number found (FREE if not found)POST /api/v1/scrape/mobile-finder

Parameters

NameTypeRequiredDescription
inputsstring[]RequiredArray of social profile URLs or email addresses (auto-detected)Example: ["<profile_url>", "[email protected]"]

Examples

Find mobile from a social profile URL

curl -X POST https://app.scrapercity.com/api/v1/scrape/mobile-finder \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": ["<profile_url>"]
  }'

Bulk lookup with mixed inputs

curl -X POST https://app.scrapercity.com/api/v1/scrape/mobile-finder \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": [
      "<profile_url>",
      "[email protected]",
      "<profile_url>"
    ]
  }'

Check status

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

Use Cases

  • Get direct mobile numbers for high-priority prospects
  • Enrich social-profile leads with phone numbers for cold calling
  • Build call lists from email-only contact databases
  • Skip the gatekeeper with direct mobile numbers

Best Practices

  • Social profile URLs and emails can be mixed in the same request
  • Input type is auto-detected - no need to specify which is which
  • You only pay for found numbers - no-result lookups are free
  • CSV upload supported in the dashboard for bulk lookups
  • Trial users limited to 3,500 lookups per search
  • Download results within 48 hours before expiration

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.