Documentation API Officielle

Intégrez Linkiw
dans vos propres outils.

Connectez votre CRM, automatisez la création de vos listes, ou lancez des extractions à grande échelle grâce à notre API REST performante.

Obtenir ma clé API

Haute performance

Temps de réponse moyen inférieur à 200ms.

Authentification sécurisée

Authentification via Bearer Token.

Réponses JSON

Toutes les réponses sont au format JSON standardisé.

Données actualisées

Scraping en direct pour contourner la base de données.

Principes de base

Comprenez comment vous connecter au serveur et authentifier vos requêtes.

Base URL

Toutes les requêtes de l'API sont effectuées sur cette URL de base sécurisée :

https://linkiw-api.fly.dev/api/v1

Authentification (Bearer)

Ajoutez votre clé API dans le header Authorization de chaque requête :

Authorization: Bearer lw_live_votre_cle_secrete

Endpoints disponibles

Référence rapide de tous les chemins d'accès de notre API publique.

EndpointMéthodeDescriptionCrédits
/v1/meGETConsulter son profil, ses limites et son solde de crédits restants.0
/v1/entreprisesGETRechercher et filtrer les entreprises dans la base Linkiw existante.0
/v1/scraping/runPOSTLancer un scraping en temps réel sur le web.1 / entreprise avec contact
/v1/listsGETRécupérer vos listes de prospection et leurs leads.0

1. GET /v1/entreprises

Recherche des entreprises dans notre base de données existante. Cette requête est 100% gratuite et ne consomme aucun crédit.

Paramètres de requête (Query) :

  • query (string) : Nom de l'entreprise ou mot clé.
  • wilayas (array) : ID des wilayas ciblées (ex: ?wilayas=16&wilayas=31).
  • secteurs (array) : Noms des secteurs d'activité ciblés.
  • score_min (number) : Score de qualité minimum (0-100).
  • page (number) : Numéro de la page (défaut: 1).
  • per_page (number) : Nombre de résultats par page (défaut: 20).

Exemple de réponse :

{
  "total": 1420,
  "page": 1,
  "pages": 71,
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "nom": "SARL Tech Algérie",
      "wilaya": "Alger",
      "activite": "Développement logiciel",
      "email": "contact@tech-algerie.dz",
      "telephone": "+213 550 00 00 00",
      "score_qualite": 85
    }
  ]
}

2. POST /v1/scraping/run

Lance une extraction en temps réel sur le web et les annuaires. Parfait pour trouver de nouvelles données qui ne sont pas encore dans la base.

Attention (Crédits) : 1 crédit est déduit de votre solde pour chaque entreprise unique trouvée avec au moins un moyen de contact (Email ou Téléphone).

Corps de la requête (JSON) :

{
  "secteur": "Bâtiment et travaux publics",
  "wilaya": "Oran",
  "max_results": 50 // Optionnel, par défaut 20
}

Exemple de réponse :

{
  "task_id": "scrap_987654321",
  "status": "completed",
  "results_found": 34,
  "credits_used": 28, // Seulement 28 avaient des contacts
  "entreprises": [
    // Liste complète des entreprises trouvées
  ]
}

Limites de taux (Rate Limits)

Pour garantir la stabilité de notre infrastructure, l'API est soumise à des limites selon votre plan.

Plan Équipe Commerciale
150 req / minute
Plan Entreprise
500 req / minute

Prêt à connecter vos outils ?

Créez votre compte, obtenez votre clé API secrète, et accédez à la base de données B2B.

Obtenir ma Clé API