generect (Python SDK)

pip install generect

from generect import Generect

g = Generect(api_key="YOUR_API_TOKEN")  # or env GENERECT_API_KEY

count = g.search.database_leads_count(job_titles=["marketing manager"], locations=["Germany"])
leads = g.search.database_leads(job_titles=["marketing manager"], locations=["Germany"], per_page=10)
print(len(leads.data), "leads for", leads.amount_charged, "USD")

email = g.email.find(lead_id=leads.data[0]["id"])   # billed only if a valid email is found

job = g.enrich.database_leads_bulk(items=[{"linkedin_url": u} for u in urls])  # ≤50 items
done = g.enrich.wait_leads_bulk(job.job_id)          # polls until completed / error

• Automatic retries with exponential backoff on 429/5xx (configurable max_retries).
• Typed errors: InsufficientBalanceError (402), RateLimitError (429), AuthenticationError (401)…
• Every response exposes its real USD cost: resp.amount_charged.
• Any endpoint, even future ones: g.request("POST", "/search/database/leads/", json={...}).

Docs: https://docs.generect.com · Errors: https://docs.generect.com/api-reference/errors