Levida logo Levida Lead generation, dashboard, exports, and automation
Tutorial

Levida Tutorial: Generate Leads in the App, API, and CLI

This tutorial covers the regular browser workflow, the terminal CLI workflow, curl-based API usage, common mistakes, and next steps.

What you can do with Levida

Levida can generate leads by region and city, by country and postal code, or by US ZIP code. After generation, you can review, filter, annotate, and export the results, or automate the same flow with the API and CLI.

Browser app tutorial

  1. Log in.
  2. Open Generate Leads.
  3. Choose region and city search or country plus postal code search.
  4. Enter one keyword.
  5. Click Generate Leads.
  6. Watch the progress panel.
  7. Open the dashboard.
  8. Filter leads.
  9. Add notes and update status.
  10. Export selected, filtered, or all leads.
Log In Dashboard FAQ

CLI tutorial

The CLI is for authenticated users who want to run Levida from the terminal, whether they prefer the guided wizard or JSON request files.

python3 scripts/levida_cli.py --base-url https://levida.ai login
python3 scripts/levida_cli.py generate-leads
python3 scripts/levida_cli.py generate-leads examples/generate_leads_postal_code.json --wait
python3 scripts/levida_cli.py generate-leads examples/generate_leads_bulk.json --no-wait

generate-leads runs new Levida searches. import-leads imports existing lead rows.

API tutorial with curl

curl -X POST https://levida.ai/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"YOUR_EMAIL","password":"YOUR_PASSWORD"}'

curl -X POST https://levida.ai/api/v1/lead-generation/jobs \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "search_method": "postal_code",
    "country": "Spain",
    "postal_code": "15005",
    "keyword": "fisioterapeuta"
  }'

curl https://levida.ai/api/v1/lead-generation/jobs/JOB_ID \
  -H "Authorization: Bearer YOUR_TOKEN"

Common mistakes

  • Use https://levida.ai, not https:levida.ai.
  • Keep tokens private.
  • Use one keyword phrase per request.
  • Start the worker for local development.
  • Use generate-leads for new searches and import-leads for existing rows.