Bases de données d'entreprises Postontarget

L'API Postontarget vous permet de construire et d'obtenir une base de données d'entreprises internationale sur mesure pour répondre à vos besoins.

Vous pouvez accéder à plus de 8 critères pour concevoir votre base de données :

À partir d'un filtre géographique (Pays, Région, Province), vous pouvez sélectionner une tranche de chiffre d'affaires, le nombre d'employés, plus de 300 macrocatégories et 1900 catégories.

Pour chaque paramètre de recherche, un point de terminaison est disponible pour savoir à l'avance combien de contacts sont disponibles et obtenir l'ID de chaque exigence souhaitée, qui peut ensuite être utilisée dans le payload de la demande de base de données.

DEMANDE DE BASE DE DONNÉES

Comme mentionné, avant de procéder à l'achat, il sera possible de vérifier le nombre de contacts disponibles en fonction des paramètres définis et d'obtenir l'ID de la demande pour finaliser l'achat de la base de données.

EXEMPLE DE DEMANDE

Le payload de la demande doit inclure les références aux exigences de la base de données :

POST/search

{
        "query": {
          "country_code": "IT",
          "admin1_code": "IT.15",
          "macro_id": 1
        }
      }

EXEMPLE DE RÉPONSE

POST/search

La réponse renverra le nombre de contacts disponibles, le nombre de contacts correspondant à la demande, les paramètres indiqués précédemment et l'ID de la demande.

  {
    "data": {
      "total_records": 5379918,
      "records_found": 51,
      "query": {
        "country_code": "IT",
        "admin1_code": "IT.15",
        "macro_id": 1
      },
      "state": "recherche_terminée",
      "owner": "test@api.altravia.com",
      "id_request": "5d4d77b80eb46d074e55ce19"
    },
    "success": true,
    "message": "OK",
    "error": null
  }
  
  

ACHAT DE BASE DE DONNÉES

Une fois le code de demande obtenu, vous pouvez procéder à l'achat.

EXEMPLE DE DEMANDE

POST /buying

Dans le payload de la demande, il est nécessaire de passer l'ID et le nombre de contacts que vous souhaitez acheter.

{
    {
      "id_request": "5d4d799c0eb46d074f01947f",
      "records": "5"
    }

EXEMPLE DE RÉPONSE

POST /buying

La réponse retourne plusieurs informations, y compris le statut (par exemple, accepté), l'ID de la demande, les paramètres précédemment indiqués, le coût par contact, le total facturé, la date de la demande, le numéro de commande, et le lien pour le téléchargement.

    {
      "data": {
        "_id": "5d4d799c0eb46d074f01947f",
        "total_records": 5379918,
        "records_found": 51,
        "query": {
          "country_code": "IT",
          "admin1_code": "IT.15",
          "macro_id": 1
        },
        "state": "accepté",
        "owner": "test@api.altravia.com",
        "base_price": 0.24,
        "credit": 3.5599999999999996,
        "date": "09/08/2019",
        "download": "https://test.postontarget.com/download/4D7736",
        "order_id": "4D7736",
        "price": 1.2,
        "records_purchased": "5"
      },
      "success": true,
      "message": "OK",
      "error": null
    }

Télécharger la base de données

GET/state/{_id}

Il est possible de vérifier l'état de la demande via l'endpoint dédié.

EXEMPLE DE DEMANDE

GET/state/{_id}

Ceci est un exemple de demande effectuée en utilisant l'ID précédemment obtenu.

https:/postontarget.com/state/5d4d799c0eb46d074f01947f 

La réponse sera identique à celle de la demande précédente (buying) mais avec le statut de traitement mis à jour.

Le traitement de la base de données prend en moyenne 48-72 heures ouvrables. Lorsque le statut de la demande est "recherche_effectuée", vous pourrez télécharger le document via le lien fourni dans la réponse.

Le service Postontarget permet d'obtenir des contacts premium avec les informations suivantes :

Les données marquées d'un astérisque peuvent ne pas être présentes dans tous les enregistrements.

Tous les contacts présents dans notre base de données respectent la législation en vigueur au niveau européen et national. Toutes les données sont quotidiennement mises à jour par une équipe dédiée.