New Public API for LeadGen.tools connect with AI and your own Apps

by

We’re excited to announce the launch of the LeadGen.tools Public API v1 — giving you full programmatic access to our lead generation, web scraping, ad intelligence, and Google Places tools. Build custom integrations, automate your workflows, and pull lead data directly into your own applications.

View the full API Documentation →

What Can You Do With the API?

The API exposes five powerful endpoints — the same tools you already use in the LeadGen.tools dashboard, now available as simple HTTP requests:

1. Lead Search

GET /api/v1/search.php

Search Google, Bing, Yahoo, or DuckDuckGo for leads. The API returns page titles, links, descriptions, and any emails or phone numbers found directly in the search results. You can pass raw search dorks or use saved recipe codes for pre-configured queries.

  • 4 search engines — Google, Bing, Yahoo, DuckDuckGo
  • Email & phone extraction directly from SERP snippets
  • Recipe support — use pre-built dork templates by code
  • Pagination — fetch multiple pages of results

2. Website Crawler

GET /api/v1/crawl.php

Point the crawler at any website and it will automatically follow internal links (up to 15 pages) to extract emails, phone numbers, social media profiles, and page metadata. Junk emails from website builders and placeholder domains are filtered out automatically.

  • Deep crawl — up to 15 pages per domain
  • Social media detection — Facebook, Twitter/X, LinkedIn, Instagram, YouTube, TikTok, Pinterest, Telegram, and more
  • Smart filtering — blacklists junk domains (wix, squarespace, example.com) and placeholder emails (noreply, admin, test)
  • Page metadata — title, description, keywords, Open Graph image

3. Ad Spy (with Historical Tracking)

GET /api/v1/ads.php

This is our most powerful endpoint. Search for Google and Bing ads, and the API will:

  1. Perform a live SERP search to find currently running ads
  2. Store every ad permanently in a historical database
  3. Crawl each ad’s landing page to extract contact data (emails, phones, social links, page metadata)
  4. Return both fresh ads (currently running) and historical ads (previously seen)

Every time you search the same keyword, newly discovered ads are added to the pool. Over time, you build a comprehensive database of every ad that has ever run for that keyword. Each result includes:

  • first_seen / last_seen timestamps to track ad lifespan
  • is_active flag — true if the ad is currently running
  • contact_data — emails, phones, social links, and metadata from the landing page

4. Places Search

GET /api/v1/places/search.php

Search Google Places for businesses by keyword. Returns detailed listings including name, address, phone, website, rating, review count, business hours, business type tags, and operational status. Results are cached for 30 days to save credits on repeated queries.

5. Place Reviews

GET /api/v1/places/reviews.php

Fetch Google reviews for any business using its place_id (returned by the Places Search endpoint). Returns reviewer names, ratings, review text, and timestamps. Cached for 7 days.

How It Works

Authentication

Every request requires your API key and user ID — the same credentials from your LeadGen.tools account. Pass them as query parameters:

curl "https://leadgen.tools/v2/api/v1/search.php?api_key=YOUR_KEY&user_id=123&query=marketing+agency"

Credit-Based Billing

API calls use the same credit system as the dashboard. Each endpoint has its own pricing:

EndpointCredits
Lead Search0 – 10 per search
Website Crawler0 – 15 per domain
Ad Spy0 – 10 per search (historical ads & crawl enrichment are free)
Places Search10 per place (0 if cached)
Place Reviews5 per place (0 if cached)

Automatic Caching

Responses are cached automatically — repeated identical queries return instantly with 0 credits charged. Cache durations range from 7 days (search) to 30 days (places) to permanent (ad history).

JSON Responses

Every response is clean JSON with a consistent structure:

{
  "status": "success",
  "credits_used": 10,
  "data": {
    "query": "marketing agency",
    "results_count": 8,
    "results": [...]
  }
}

Use Cases

  • CRM enrichment — Automatically crawl your lead websites for contact data and update your CRM
  • Competitor ad monitoring — Track competitor ads over time, see when ads start and stop running, and extract their landing page contacts
  • Local business prospecting — Pull Google Places data for any niche + location and build targeted outreach lists
  • Custom dashboards — Feed API data into your own analytics and reporting tools
  • Automated pipelines — Chain Search → Crawl → CRM in a scheduled workflow
  • Zapier / Make integrations — Use webhooks to trigger API calls from other tools

Get Started

  1. Get your API key from your account dashboard
  2. Read the docs at leadgen.tools/v2/api/v1/
  3. Make your first call — try the Lead Search endpoint with a simple keyword
  4. Build something — integrate the API into your existing tools and workflows

The full documentation includes example requests and responses for every endpoint, parameter reference tables, error code explanations, and credit calculation details.

Explore the API Documentation →

Questions or feedback? Reach out to our support team — we’d love to hear what you’re building with the API.

Leave a Comment