Search Company è un potente ed efficace strumento di ricerca e consente, a partire da oltre 15 parametri, di ottenere la lista di tutte le aziende corrispondenti a quei criteri.

I parametri disponibili per le richieste di Search sono:

• Denominazione sociale (o parte dei termini in essa presente), 
• Provincia
• Longitudine
• Latitudine
• Raggio
• Codice Catastale 
• CCCIA
• Codice ATECO
• Camera di Commercio
• REA
• Fatturato (min. / max.)
• Dipendenti (min. / max.) 
• Codice Sdi
• Codice Forma Legale
• PEC
• Codice Fiscale socio

Questi parametri possono essere combinati liberamente per ottenere un elenco di contatti aziendali più pertinente.

Inoltre, utilizzando Search, è possibile identificare le aziende in cui un individuo o un'entità legale è socio, utilizzando semplicemente il codice fiscale come riferimento.

Un altro aspetto interessante è il parametro "dataEnrichment", che consente di specificare il tipo di dataset desiderato nella risposta:

• Nessun parametro: viene specificato verrà restituito un elenco di id delle aziende che possono essere usati per richiedere informazioni tramite gli altri endpoint di Company
• Start: restituirà per ogni impresa corrispondente ai parametri tutte le informazioni dell'endpoint start: denominazione, codice fiscale, partita iva, indirizzo, sede, stato attività, sdi
• Advanced: si comporterà nella stessa modalità di start ma offrirà informazioni arricchite come ad esempio  PEC codice SdI, REA, Natura Giuridica, ATECO, fatturato, utili, dipendenti, soci

Search è identificato dall’endpoint: GET https://company.openapi.com/IT-search. 

ESEMPIO RICHIESTA GET /IT-search

Questo è un esempio di chiamata in cui sono stati utilizzati i seguenti parametri:

• Arrichimento Dati di tipo Start
• Provincia di Roma
• Codice ATECO 62.01
• Fatturato minimo 500.000 e massimo 2.000.000
• Dipendenti minimo 5 e massimo 20 

https://company.openapi.com/IT-Search?dataEnrichment=start&province=RM&atecoCode=6201&cciaa=RM&minTurnover=500000&maxTurnover=2000000&minEmployees=5&maxEmployees=20

 
ESEMPIO RISPOSTA GET /IT-search

La risposta restituisce un elenco di aziende compatibili con i parametri indicati e il dataset selezionato (start):

• Codice Fiscale
• Denominazione
• Partita IVA
• Sede Legale (toponimo, via, indirizzo, comune, frazione, provincia, CAP)
• Coordinate Geografiche Sede Legale (longitudine e latitudine)
• Codice Catastale sede
• Codice Sdi e aggiornamento
• Stato Attività
• Timestamp creation (data creazione azienda in database)
• Timestamp last update (data ultima variazione dell’impresa)
• Data iscrizione alla Camera di Commercio
• Identificativo azienda interno (ID)

Questa risposta è a titolo di esempio ed i dati non sono corrispondenti ai parametri indicati nella richiesta: 

{
"data": [
  {
    "taxCode": "12485671007",
    "companyName": "OPENAPI S.R.L.",
    "vatCode": "12485671007",
    "address":{
      "registeredOffice": {
      "toponym": "VIALE",
      "street": "F TOMMASO MARINETTI",
      "streetNumber": "221",
      "streetName": "VIALE F TOMMASO MARINETTI 221",
      "town": "ROMA",
      "hamlet":  null,
      "province": "RM",
      "zipCode": "00143",
      "gps": {
        "coordinates": [
          12.47843,
          41.8071
       ]
      },
      "townCode": "H501"
    }
  },
  "activityStatus": "ATTIVA",
  "creationTimestamp": 1676878023,
  "lastUpdateTimestamp": 1676878023,
  "sdiCode": "MJ1OYNU",
  "sdiCodeTimestamp": 1624358855,
  "id": "60b4a85585e34e615c569ef5",
  "registrationDate: "2013-07-19"
  },
{
  "taxCode": "12345678910",
  "companyName": "OPENAPI TEST S.P.A.",
  "vatCode": "12345678910",
  "address":{
    "registeredOffice": {
    "toponym": "VIALE",
    "street": "ROMA",
    "streetNumber": "221",
    "streetName": "VIALE ROMA 221",
    "town": "ROMA",
    "hamlet":  null,
    "province": "RM",
    "zipCode": "00143",
      "gps": {
        "coordinates": [
         13.47866,
          41.9072
        ]
      },
      "townCode": "H501",
    }
  },
  "activityStatus": "REGISTRATA",
  "creationTimestamp": 1676878023,
  "lastUpdateTimestamp": 1676878023,
  "sdiCode": "USAL8PV",
  "sdiCodeTimestamp": 1624358855,
  "id": "45d1bfc788174b9u092cdtr5",
  "registrationDate: "2016-08-29"
    }
 ],
 "success":  true,
 "message": "",
 "error":  null
 }

Il costo viene addebitato in base al numero delle imprese presenti nella risposta ed è possibile prima di effettuare la chiamata avere il conteggio dei risultati disponibili tramite il parametro “dry_run”. 

Per prevenire eventuali errori il servizio prevede inoltre un limite massimo di risultati di default: 100 risultati. È possibile ridurre ulteriormente il numero di risultati con il parametro “limit” dove verrà appunto indicato il numero di risultati desiderati.

Nel caso la risposta preveda oltre 100 aziende è possibile ottenere tutti i risultati con più chiamate e tramite il parametro “skip” che indica il numero di risultati che devono essere “saltati”. 

In pratica, se per una richiesta sono previste 150 aziende come risultato, la prima chiamata consentirà di ottenerne le prime 100, la seconda, in cui verrà indicato il parametro skip ed il valore 100 (quindi di saltare le prime 100 già ottenute con la prima chiamata), permetterà di ottenere le restanti 50.

Search viene utilizzato ad esempio per indagini e analisi di mercato settoriale o per attività di marketing.