API Documentation

Integrate LiScrapo's powerful lead generation capabilities into your applications

Getting Started

Authentication

All API requests require authentication using an API key. You can generate an API key from your dashboard settings.

curl -X GET "https://api.liscrapo.com/v1/leads" \
    -H "Authorization: Bearer YOUR_API_KEY"

Rate Limits

Basic Plan

1,000 requests/day

Pro Plan

5,000 requests/day

Enterprise Plan

Custom limits

Base URL

All API requests should be made to:

https://api.liscrapo.com/v1

API Reference

Leads

GET /leads/search

Search for leads using various filters and criteria.

Parameters

Parameter Type Description
query string Search query string
filters object Filter criteria
limit integer Number of results (max: 100)

Example Request

curl -X GET "https://api.liscrapo.com/v1/leads/search?query=software&limit=10" \
    -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
    "results": [
        {
            "id": "lead_123",
            "name": "John Doe",
            "company": "Tech Corp",
            "title": "Software Engineer",
            "email": "john@techcorp.com",
            "confidence_score": 0.95
        }
    ],
    "total": 1,
    "page": 1
}
POST /leads

Create a new lead in the system.

Request Body

{
    "name": "Jane Smith",
    "company": "Innovation Inc",
    "title": "CTO",
    "email": "jane@innovation.com",
    "phone": "+1234567890",
    "linkedin_url": "https://linkedin.com/in/janesmith"
}

Example Request

curl -X POST "https://api.liscrapo.com/v1/leads" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"name":"Jane Smith","company":"Innovation Inc","title":"CTO"}'

Data Enrichment

POST /leads/enrich

Enrich lead data with additional information.

Request Body

{
    "email": "john@techcorp.com",
    "enrich_fields": ["company_info", "social_profiles", "contact_details"]
}

Example Response

{
    "email": "john@techcorp.com",
    "company_info": {
        "name": "Tech Corp",
        "size": "51-200",
        "industry": "Software",
        "founded": 2015
    },
    "social_profiles": {
        "linkedin": "https://linkedin.com/in/johndoe",
        "twitter": "@johndoe"
    },
    "contact_details": {
        "phone": "+1234567890",
        "location": "San Francisco, CA"
    }
}

SDKs & Libraries

JavaScript

JavaScript

Official JavaScript/Node.js SDK for LiScrapo API

npm install liscrapo-sdk
View Documentation →
Python

Python

Official Python SDK for LiScrapo API

pip install liscrapo
View Documentation →
PHP

PHP

Official PHP SDK for LiScrapo API

composer require liscrapo/sdk
View Documentation →

Need Help?

Having trouble with our API? Get in touch with our developer support team.