Saldo de créditos y estado de la suscripción de ExtractorLead.

Úsalo antes de lanzar cualquier trabajo para saber si hay saldo suficiente.

Busca leads nuevos de un nicho en una zona. Consume créditos.

• channel: "linkedin" para B2B (cargos, empresas), "instagram"/"tiktok" para creadores y negocios locales.

• contact: "emails" o "phones".

• niche: a quién buscas, p.ej. "directores de marketing de SaaS" o "clínicas dentales".

• location: ciudad, región o país, p.ej. "Madrid".

• lead_count: 1..500 (por defecto 25).

• country: código ISO de 2 letras, solo para linkedin+phones (p.ej. "es").

Devuelve un task_id; recoge los leads con get_task_result. Pide confirmación al usuario antes de llamarla.

Obtiene email, teléfono y datos profesionales de UN perfil de LinkedIn.

linkedin_url: https://www.linkedin.com/in// Devuelve un task_id; el resultado se recoge con get_task_result.

Analiza una web: contactos (emails, teléfonos, redes), negocio y servicios.

url debe incluir http:// o https://. Devuelve un task_id para get_task_result.

Estado y resultado de search_leads, lookup_linkedin_profile o analyze_website.

• wait_seconds: espera hasta 50s a que termine antes de responder.

• offset/limit: paginación de la lista de leads cuando es larga. status: PENDING | PROCESSING | COMPLETED | FAILED | CANCELLED.

Valida una lista de personas y calcula el coste máximo. NO cobra nada.

Úsalo SIEMPRE antes de start_bulk_enrichment y enseña al usuario
rows_accepted, max_credits y available_credits.

Entrada (una de las dos):
- leads: lista de filas, cada una con los campos que tenga: first_name,
  last_name, full_name, company, domain, title, linkedin_url, email,
  location. También valen cabeceras en español (Nombre, Apellido, Cargo,
  Empresa, LinkedIn...). Máx. 5000 filas.
- file_path: ruta a un CSV/XLSX local (solo servidor local; un export de
  Sales Navigator vale tal cual).
Opciones:
- contact_info: "all_contact_info" (por defecto: pide el teléfono y entrega
  el email solo de quien tiene teléfono), "phone_info" o "email_info".
- match_mode: "strict" (la persona exacta) o "related" (además otros
  contactos análogos de la misma empresa, usando el cargo como semilla).
- related_per_company: 1..10 contactos análogos por empresa (con related).
- require_mobile: true para contar solo móviles, no centralitas.
Precio por contacto ENTREGADO: solo email 2, solo teléfono 3, ambos 4,
nada 0 créditos.

Lanza el enriquecimiento de una lista de personas. Consume créditos.

Solo tras preview_bulk_enrichment y con la confirmación del usuario.
Devuelve un task_id; sigue el trabajo con get_bulk_status.

Entrada (una de las dos):
- leads: lista de filas, cada una con los campos que tenga: first_name,
  last_name, full_name, company, domain, title, linkedin_url, email,
  location. También valen cabeceras en español (Nombre, Apellido, Cargo,
  Empresa, LinkedIn...). Máx. 5000 filas.
- file_path: ruta a un CSV/XLSX local (solo servidor local; un export de
  Sales Navigator vale tal cual).
Opciones:
- contact_info: "all_contact_info" (por defecto: pide el teléfono y entrega
  el email solo de quien tiene teléfono), "phone_info" o "email_info".
- match_mode: "strict" (la persona exacta) o "related" (además otros
  contactos análogos de la misma empresa, usando el cargo como semilla).
- related_per_company: 1..10 contactos análogos por empresa (con related).
- require_mobile: true para contar solo móviles, no centralitas.
Precio por contacto ENTREGADO: solo email 2, solo teléfono 3, ambos 4,
nada 0 créditos.

Contadores de un trabajo masivo (nunca la lista).

phase: processing | awaiting_phones | completed. Con partial=true ya se pueden leer los leads decididos con get_bulk_results. Los teléfonos pueden tardar hasta ~1 hora: si phase es awaiting_phones, avisa al usuario y vuelve a consultar más tarde en lugar de esperar en bucle.

Leads enriquecidos de un trabajo masivo, paginados (per_page máx. 200).

Para listas grandes ofrece al usuario get_bulk_download_link en vez de paginar todo en la conversación.

Enlace temporal (15 min) para descargar todos los leads del trabajo en JSON.

Analiza una lista propia (CRM, Excel) y cotiza rellenar sus huecos. NO cobra.

A diferencia del enriquecimiento masivo, conserva las columnas del usuario y devuelve su mismo Excel con columnas nuevas. Devuelve columnas detectadas, huecos (sin_telefono, sin_email...), coste y tope_sugerido.

• phone_for_all: true para buscar teléfono también en filas que ya traen uno (p.ej. cuando son centralitas).

Lanza el relleno de huecos de una lista. Consume créditos hasta credit_cap.

credit_cap: tope de gasto que el usuario ha aprobado (usa el tope_sugerido de preview_list_enrichment si no dice otro). Sigue el trabajo con get_list_enrichment.

Estado del relleno de lista; al terminar, resumen y enlace al Excel editado.

include_rows=true añade las filas (paginadas con offset/limit, máx. 200).