Do I need a different plan to use the API?

No. The API uses your existing LeadsFriday account and the same credit balance as the dashboard. There is no separate API subscription, plan, or wallet to manage.

Which tools are available through the API?

Our supported scraping and enrichment tools are available through the API. They follow the same request workflow, with inputs depending on the scraper or enrichment service you’re using.

How do I authenticate?

Create an API key from your LeadsFriday dashboard and send it as a bearer token with your requests. Keep your key on a trusted backend and never expose it in frontend code, public repositories, or client-side applications.

How am I charged for API requests?

API requests use the same credit balance as your dashboard. Each tool has its own rate, and for result-based enrichment, you’re charged for successful matches where applicable. You’ll always use the same LeadsFriday balance.

Can I rotate or revoke an API key?

Yes. You can manage your API keys from the dashboard. If a key is exposed, no longer needed, or you simply want to rotate your credentials, revoke it and create a replacement.

How do I know when a request is complete?

You have two options. Check the request status through the API, or provide a callback URL and let us notify your application automatically when the request reaches a final state.

Should I poll or use webhooks?

Either works. Polling is simple for occasional requests. For automated or higher-volume workflows, webhooks are usually better because your application doesn’t need to keep checking whether a request is finished.

What happens if my webhook endpoint is down?

If your endpoint returns a non-2xx response, we’ll retry delivery so a temporary outage doesn’t cause you to immediately lose the event. Keep the order ID returned at submission as well, so you can check the request status if needed.

Can I get help with the integration?

Yes. If you need help with authentication, submitting requests, handling webhooks, or collecting completed exports, contact us. We’re a founder-led team, so you’ll get help from someone who understands both the API and the scraping and enrichment workflows behind it.

Automate Your Scraping and Enrichment

Connect LeadsFriday to your existing workflow. Submit scraping and enrichment requests through the API, and receive completed exports without using the dashboard.

Get Your API Key Read the Guides

Same credit balanceNo extra planRotate keys any time

bash

curl -X POST https://api.leadsfriday.com/v1/orders \
  -H "Authorization: Bearer $LEADSFRIDAY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "apollo_company_scraper",
    "search_url": "https://app.apollo.io/#/companies?...",
    "limit": 20000,
    "callback_url": "https://your-app.com/hooks/leadsfriday"
  }'

# 202 Accepted
# { "order_id": "ord_9f2c41", "status": "queued" }

Built for Automated Workflows

Everything you can do from the dashboard, available through the API.

Bearer token authentication

Connect securely from your backend using a bearer token. Create, rotate, or revoke your API key from the dashboard whenever you need to.

One account, one credit balance

API requests use the same credits as your dashboard. No separate API plan, wallet, or monthly subscription to manage.

Poll or use webhooks

Check request status through the API, or add a callback URL and we’ll send the download link as soon as your CSV is ready.

The Request Lifecycle

Submit, process, deliver. Everything runs on our infrastructure, so your application never depends on an open browser.

1Queued
You submit
Send the tool name and your search URL or input file through the API. We validate the request and return an order ID you can use to track it.
2Processing
We process
Your request runs on our servers. Nothing runs in your browser, and you don’t need to keep your computer or application waiting for it to finish.
3Completed
We notify
Once the request is complete, we’ll send the completion event to your callback URL with the download link. You can also check the request status through the API.
4Charged
You pay for results
Credits are deducted from your balance based on the results delivered. For result-based enrichment, records where we don’t find a match don’t use a credit.

Endpoints at a Glance

Use the same API structure across every LeadsFriday scraper and enrichment tool. Submit a request, track its status, and retrieve the completed data from one consistent workflow.

Method	Endpoint	What it does
POST	`/v1/orders`	Submit a scraping or enrichment request.
GET	`/v1/orders/{id}`	Check the status and progress of one order.
GET	`/v1/orders`	List your recent orders with filters and paging.
GET	`/v1/orders/{id}/file`	Download the finished CSV.
GET	`/v1/tools`	List available tools with their current rates.
GET	`/v1/balance`	Read your remaining credit balance.
POST	`/v1/webhooks`	Register or update a callback URL.

Paths are illustrative. Check the API reference in your dashboard for the current endpoint names, parameters and response shapes.

Webhooks

Stop Asking "Is It Done Yet?"

Add a callback URL and we’ll notify your application when a request is finished. Your workflow can pick up the file, import the data, and move to the next step without constantly checking the status.

Fires when a request is completed, failed, or cancelled.
Signed payloads help you verify the event came from LeadsFriday.
Failed deliveries are retried when your endpoint returns a non-2xx response.
Includes the order ID from submission, so you can match each event to the right request.

Read the webhook guide

POST https://your-app.com/hooks/leadsfriday

{
  "event": "order.completed",
  "order_id": "ord_9f2c41",
  "tool": "apollo_company_scraper",
  "status": "completed",
  "rows": 20000,
  "credits_charged": 50,
  "download_url": "https://api.leadsfriday.com/files/...",
  "expires_at": "2026-09-08T11:04:00Z"
}

Frequently Asked Questions

1,000 free leads on signup

Bring LeadsFriday Into Your Workflow

Create your API key, submit your first request, and connect LeadsFriday to the tools you already use. Need help along the way? Talk directly with our team.

Get Your API Key Contact Support