Overview

LeadScraper360 API

The LeadScraper360 REST API lets you programmatically extract verified B2B lead intelligence — including emails, founder details, tech stacks, and DNS metadata — directly from any public business domain. All responses are returned as structured JSON.

API Key Auth

All requests authenticated via Bearer token in the Authorization header.

REST + JSON

Standard REST architecture. All request and response payloads are JSON.

Credit-Based

Each extraction consumes credits. Unused credits roll forward every month.

Base URL

https://api.leadscraper360.com/v1

Authentication

Every API request must include your secret API key in the Authorization header using the Bearer scheme. You can generate and manage your API keys from the Settings page after signing in.

Keep your API key secret. Never commit it to version control or expose it in client-side code. Rotate your key immediately if it is ever compromised.

Authorization Header

Required on all requests

Authorization: Bearer xxxxxxxxxxxxxxxxxxxx

cURL — Authenticated request example

Shell

curl -X POST https://api.leadscraper360.com/v1/extract \
  -H "Authorization: Bearer xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://stripe.com"}'

Authentication Error Responses

401 Unauthorized

Missing or malformed Authorization header.

403 Forbidden

API key is invalid, revoked, or belongs to an inactive account.

Extract

Extract Leads

The core endpoint of the API. Submit a business domain URL and receive a fully structured JSON object with 30+ data fields including company info, contact details, social profiles, AI lead scoring, sales intelligence, and SEO analysis. Each successful extraction consumes 1 credit.

POST/v1/extract

Request Body Parameters

Parameter	Type	Required	Description
url	string	Required	The full public domain URL to extract leads from (e.g. https://stripe.com).

cURL — Extraction request

Shell

curl -X POST https://api.leadscraper360.com/v1/extract \
  -H "Authorization: Bearer xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://stripe.com"}'

Request Body (JSON)

application/json

{
  "url": "https://stripe.com"
}

Response Payload (JSON)

200 OK

{
  "status": "success",
  "credits_used": 1,
  "credits_remaining": 498,
  "data": {
    "url": "https://stripe.com",
    "company_info": {
      "name": "Stripe, Inc.",
      "tagline": "Financial Infrastructure for the Internet",
      "founded": "2010",
      "industry": "Financial Services & Software",
      "founder_name": "Patrick Collison & John Collison",
      "business_type": "Fintech / B2B SaaS",
      "company_size": "5,000 - 10,000 employees",
      "company_type": "Private Company",
      "description": "Stripe is a suite of APIs powering online payment processing.",
      "address": "354 Oyster Point Blvd, South San Francisco, CA 94080, United States"
    },
    "contact": {
      "emails": ["support@stripe.com", "sales@stripe.com"],
      "phone": ["+1 650-555-0100"],
      "working_hours": "24/7 Support"
    },
    "social": {
      "linkedin": "linkedin.com/company/stripe",
      "facebook": "facebook.com/stripe",
      "instagram": "instagram.com/stripe",
      "twitter": "twitter.com/stripe",
      "tiktok": ""
    },
    "provide_services": ["Payment Processing", "Subscription Billing", "Financial Services"],
    "target_markets": ["Developers", "SaaS Founders", "E-commerce Brands"],
    "lead": {
      "score": 95,
      "priority": "High",
      "decision_maker_probability": "High"
    },
    "sales": {
      "score": 92,
      "recommended_services": ["Custom Integration", "Enterprise Solutions"],
      "gaps": ["Alternative payment methods", "Localized payment options"],
      "summary": "Stripe has excellent payment infrastructure and strong developer tools."
    },
    "seo": {
      "title": true,
      "meta": true,
      "schema": true
    }
  }
}

Response Field Reference

Field	Type	Description
status	string	"success" or "error"
credits_used	integer	Credits consumed by this request (always 1 per extraction).
credits_remaining	integer	Remaining credits on your account after this request.
data	object	Complete extracted data object with 30+ fields.
data.url	string	Target website URL that was scraped.
data.company_info	object	Company details: name, tagline, founded, industry, founder_name, business_type, company_size, company_type, description, address.
data.contact	object	Contact information: emails array, phone array, working_hours.
data.social	object	Social media profiles: linkedin, facebook, instagram, twitter, tiktok URLs.
data.provide_services	array	List of services offered by the company.
data.target_markets	array	Target customer segments and markets.
data.lead	object	AI lead intelligence: score (0-100), priority, decision_maker_probability.
data.sales	object	AI sales intelligence: score, recommended_services, gaps, summary.
data.seo	object	SEO analysis: title, meta, schema (boolean flags).

Credits

Every successful extraction call consumes exactly 1 credit. Credits are purchased as one-time packs and never expire — use them whenever you need with no monthly commitments or recurring fees.

Check Credit Balance

GET/v1/credits

Retrieve the current credit balance and total purchased credits for your account.

cURL — Check credit balance

Shell

curl -X GET https://api.leadscraper360.com/v1/credits \
  -H "Authorization: Bearer xxxxxxxxxxxxxxxxxxxx"

Response Payload (JSON)

200 OK

{
  "status": "success",
  "data": {
    "account": {
      "email": "you@company.com"
    },
    "credits": {
      "available": 500,
      "total_purchased": 47,
      "total_bonus": 20
    }
  }
}

Error Codes

All errors return a JSON object with a status of "error", an HTTP status code, and a human-readable message field.

Error Response Structure

application/json

{
  "status": "error",
  "code": 402,
  "error": "insufficient_credits",
  "message": "Your account has 0 credits remaining. Please upgrade your plan or wait for the next billing cycle."
}

HTTP Code	Error	Description
400	bad_request	Missing or invalid request parameters (e.g., malformed URL).
401	unauthorized	Missing Authorization header or Bearer token.
403	forbidden	API key is invalid, expired, or has been revoked.
402	insufficient_credits	Account has 0 credits remaining. Upgrade or wait for next billing cycle.
422	unprocessable_url	Target URL is inaccessible, private, or not a valid business domain.
429	rate_limited	Too many requests in a short window. Back off and retry after 60 seconds.
500	server_error	Internal server error. Contact support@leadscraper360.com if the issue persists.

Need help integrating?

Our team responds to API queries within one business day.

Contact Support →