Postontarget Database Aziendali

L'API Postontarget Database Aziendali consente di costruire ed ottenere un database aziende internazionale su misura delle proprie esigenze.

Per disegnare il proprio database è possibile accedere ad oltre 8 criteri:

A partire da un filtro geografico (Paese, Regione, Provincia) si può selezionare una fascia di fatturato, numero dipendenti, oltre 300 macrocategorie e 1900 categorie.

Per ogni parametro di ricerca è disponibile un endpoint per sapere in anticipo quanti contatti sono disponibili e soprattutto ottenere l'id di ciascun requisito desiderato, da utilizzare in un secondo momento nel payload della richiesta del database.

RICHIESTA DEL DATABASE

Come anticipato, prima di procedere all'acquisto, è possibile verificare il numero dei contatti disponibili, in base ai parametri impostati, ed ottenere l'id della richiesta per finalizzare l'acquisto del database.

ESEMPIO RICHIESTA

POST/search

Nel payload della richiesta dovranno essere presenti i riferimenti ai requisiti del database:

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

ESEMPIO RISPOSTA

POST/search

La risposta restituirà il numero di contatti disponibili, il numero di contatti compatibili con la richiesta, i parametri indicati precedentemente e l'id di richiesta .

  {
    "data": {
      "total_records": 5379918,
      "records_found": 51,
      "query": {
        "country_code": "IT",
        "admin1_code": "IT.15",
        "macro_id": 1
      },
      "state": "ricerca_evasa",
      "owner": "[email protected]",
      "id_request": "5d4d77b80eb46d074e55ce19"
    },
    "success": true,
    "message": "OK",
    "error": null
  }
  
  

ACQUISTO DEL DATABASE

Un volta ottenuto il codice richiesta, sarà possibile procedere all'acquisto del database.

ESEMPIO RICHIESTA

POST /buying

Nel payload della richiesta bisogna passare l'id ed il numero di contatti che si desidera acquistare:

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

ESEMPIO RISPOSTA

POST /buying

La risposta restituisce diverse informazioni tra cui lo stato (ad esempio accettato), l'ID della richiesta, parametri indicati precedentemente, il costo per singolo contatto, il totale addebitato, la data di richiesta, il numero ordine, il link per il download:

    {
      "data": {
        "_id": "5d4d799c0eb46d074f01947f",
        "total_records": 5379918,
        "records_found": 51,
        "query": {
          "country_code": "IT",
          "admin1_code": "IT.15",
          "macro_id": 1
        },
        "state": "accettato",
        "owner": "[email protected]",
        "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
    }

SCARICARE IL DATABASE

È possibile verificare lo stato della richiesta tramite l'endpoint dedicato.

ESEMPIO RICHIESTA

GET/state/{_id}

Questo è un esempio di richiesta effettuata utilizzando l'ID precedentemente ottenuto:

https:/postontarget.com/state/5d4d799c0eb46d074f01947f 

La risposta sarà identica a quella della richiesta precedente (buying) ma con lo stato di evasione aggiornato.

L'evasione del database richiede in media 48-72 ore lavorative. Nel momento in cui lo stato della richiesta è "ricerca_evasa" sarà possibile scaricare il documento al link indicato nella risposta.

Il servizio Postontarget consente di ottenere contatti premium con i seguenti dati:

I dati segnalati da asterisco potrebbero non essere presenti in tutte le anagrafiche.

Tutti i contatti presenti nel nostro Database rispettano la normativa vigente a livello europeo e nazionale. I dati vengono quotidianamente aggiornati da un reparto dedicato.