API Documentation

Build powerful integrations with LeadsRanc using our comprehensive REST API.

Quick Start

1. Get Your API Key

Log into your LeadsRanc account and navigate to Settings → API Keys to generate your API key.

2. Base URL

https://api.leadsranc.com/v1

3. Authentication

Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

4. Make Your First Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.leadsranc.com/v1/leads/company/?query=technology

RESTful Design

Clean, intuitive API following REST principles

JSON Responses

All responses in easy-to-parse JSON format

Rate Limiting

Fair usage limits to ensure service quality

Authentication

Secure API key-based authentication

Webhooks

Real-time notifications for events

SDKs

Official SDKs for popular languages

API Endpoints

GET/api/v1/leads/company

Search for company leads

Parameters: query, location, industry, size

Example: GET /api/v1/leads/company/?query=technology&location=ghana

GET/api/v1/leads/person

Search for person leads

Parameters: query, location, title, company

Example: GET /api/v1/leads/person/?query=ceo&location=accra

POST/api/v1/verification/verify

Verify email addresses

Parameters: email

Example: POST /api/v1/verification/verify

GET/api/v1/collections

Get user collections

Parameters: page, limit

Example: GET /api/v1/collections/?page=1&limit=10

Response Example

{
  "success": true,
  "data": {
    "results": [
      {
        "id": "12345",
        "name": "TechCorp Ghana",
        "industry": "Technology",
        "location": "Accra, Ghana",
        "website": "https://techcorp.gh",
        "email": "contact@techcorp.gh",
        "phone": "+233 24 123 4567",
        "employees": "50-100",
        "revenue": "GH₵1M - GH₵5M"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 150,
      "pages": 15
    }
  },
  "meta": {
    "query_time": "0.234s",
    "total_results": 150
  }
}

Rate Limits

Free Plan

100

requests per hour

Pro Plan

1,000

requests per hour

Enterprise

10,000

requests per hour

Official SDKs

JavaScript

Node.js & Browser

Python

3.7+

PHP

7.4+

Ruby

2.7+

Ready to Build?

Start building powerful integrations with LeadsRanc API today. Get your API key and start making requests in minutes.