Recherche Entreprise - Italie

Recherche Entreprise est un outil de recherche puissant et efficace, permettant d'obtenir la liste de toutes les entreprises correspondant à ces critères à partir de plus de 15 paramètres.

Les paramètres disponibles pour les requêtes de Search sont :

Ces paramètres peuvent être combinés librement pour obtenir une liste de contacts d'entreprises plus pertinente.

De plus, en utilisant Search, il est possible d'identifier les entreprises dans lesquelles un individu ou une entité légale est associé, en utilisant simplement le code fiscal comme référence.

Un autre aspect intéressant est le paramètre "dataEnrichment", qui permet de spécifier le type de dataset souhaité dans la réponse :

Search est identifié par le point de terminaison : GET https://company.openapi.com/IT-search .

EXEMPLE DE REQUÊTE

GET /IT-search

Ceci est un exemple d'appel où les paramètres suivants ont été utilisés :

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

EXEMPLE DE RÉPONSE

GET /IT-search

La réponse retourne une liste d'entreprises compatibles avec les paramètres indiqués et le jeu de données sélectionné (start) :

Cette réponse est donnée à titre d'exemple et les données ne correspondent pas aux paramètres indiqués dans la demande :

{
"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": "ACTIF",
  "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": "ENREGISTRÉ",
  "creationTimestamp": 1676878023,
  "lastUpdateTimestamp": 1676878023,
  "sdiCode": "USAL8PV",
  "sdiCodeTimestamp": 1624358855,
  "id": "45d1bfc788174b9u092cdtr5",
  "registrationDate": "2016-08-29"
    }
 ],
 "success":  true,
 "message": "",
 "error":  null
 }

Le coût est facturé en fonction du nombre d'entreprises présentes dans la réponse et il est possible, avant d'effectuer l'appel, d'obtenir le compte des résultats disponibles via le paramètre "dry_run".

La recherche sans paramètre ou avec le paramètre dry run a un nombre de requêtes gratuites par jour de 100. Au-delà de cette limite, le coût sera de 0,01€ par requête.

Pour éviter d'éventuelles erreurs, le service prévoit également une limite maximale de résultats par défaut : 1000 résultats. Il est possible de réduire davantage le nombre de résultats avec le paramètre "limit" où le nombre de résultats souhaités sera indiqué.

Si la réponse comprend plus de 1000 entreprises, il est possible d'obtenir tous les résultats avec plusieurs appels et en utilisant le paramètre "skip" qui indique le nombre de résultats à "sauter".

En pratique, si une demande prévoit 1500 entreprises comme résultat, le premier appel permettra d'en obtenir les 1000 premiers, le second, avec le paramètre skip et la valeur 1000 (pour sauter les 1000 déjà obtenus avec le premier appel), permettra d'obtenir les 500 restants.

Search est utilisé, par exemple, pour des enquêtes et des analyses de marché sectoriel ou pour des activités de marketing.