Matchplat API Docs

POST /explore/simple-semantic

Cerca aziende utilizzando parole chiave e filtri strutturati. Permette di specificare keyword (OR), must (AND) e mustNot (NOT) per la ricerca semantica, oltre ai filtri classici. La risposta è paginata e include il searchContextId e i parametri di input.

Request Body

Campo Tipo Descrizione
filters ExploreFilters Oggetto filtri per la ricerca aziende (vedi dettagli sotto). Vedi dettagli oggetto ExploreFilters sotto.
semantic SemanticSearchInput Oggetto per la ricerca semantica (vedi dettagli sotto). Vedi dettagli oggetto SemanticSearchInput sotto.
page Int Numero pagina (opzionale, default 1)

ExploreFilters

Campo Tipo Descrizione
countriesIso2 String[] Codici ISO2 della nazione (obbligatorio). I valori disponibili sono quelli supportati dall'API. Il limite di nazioni è 1 per Lite e Plus, 5 per Simple Semantic.
regions String[] Elenco delle regioni da includere nel filtro. I valori disponibili si ottengono da un endpoint dedicato passando il country.. Vedi qui
cities String[] Elenco delle città da includere nel filtro. I valori disponibili si ottengono da un endpoint dedicato passando il country.. Vedi qui
postcode String[] Elenco di codici postali da includere nel filtro
dateOfIncorporationGte DateTime Data di costituzione azienda (maggiore o uguale a)
dateOfIncorporationLte DateTime Data di costituzione azienda (minore o uguale a)
operatingRevenueGte Int Fatturato minimo (in valuta locale)
operatingRevenueLte Int Fatturato massimo (in valuta locale)
numberOfEmployeesLte Int Numero massimo di dipendenti
numberOfEmployeesGte Int Numero minimo di dipendenti
standardisedLegalForm String[] Elenco di forme giuridiche standardizzate
nationalSectors String[] Codici settoriali nazionali. I valori disponibili si ottengono da un endpoint dedicato passando il country.. Vedi qui
naceCodes String[] Codici NACE da includere nel filtro. I valori disponibili si ottengono da un endpoint dedicato.. Vedi qui
naicsCodes String[] Codici NAICS da includere nel filtro. I valori disponibili si ottengono da un endpoint dedicato.. Vedi qui
sicCodes String[] Codici SIC da includere nel filtro. I valori disponibili si ottengono da un endpoint dedicato.. Vedi qui
isPrimaryCodes Boolean Filtra codici primari (true/false)
isSecondaryCodes Boolean Filtra codici secondari (true/false)
categories String[] Categorie personalizzate da includere nel filtro. I valori corrispondono a categoryOfTheCompany dell'oggetto company.. Vedi Oggetto Azienda (categoryOfTheCompany)
status String[] Status aziendali da includere. I valori corrispondono a status dell'oggetto company.. Vedi Oggetto Azienda (status)
listedDelistedUnlisted String[] Stato di quotazione (quotata, delistata, non quotata)

SemanticSearchInput

Field Type Description
keywords String[] Parole chiave (logica OR) almeno 1 obbligatoria
must String[] Parole che devono essere presenti (logica AND)
mustNot String[] Parole che non devono essere presenti (logica NOT)

Risposta 200

Campo Tipo Descrizione
companies Company[] Array di aziende trovate (max 25 per pagina)
totalCompanies Int Numero totale di aziende trovate
totalPages Int Numero totale di pagine
page Int Numero pagina corrente
pageSize Int Dimensione pagina (fisso 25)
searchContextId String Identificativo del contesto di ricerca
input Object Parametri di input ricevuti

Company

Vedi la sezione Oggetto Azienda per la descrizione dettagliata dei campi company.

Esempio

{
  "companies": [],
  "totalCompanies": 0,
  "totalPages": 1,
  "page": 1,
  "pageSize": 25,
  "searchContextId": "b7e6a2c1-4f3d-4e2a-9c1a-2b3e4d5f6a7b",
  "input": {
    "filters": { "country": "IT" },
    "semantic": { "keyword": ["AI", "machine learning"], "must": ["software"], "mustNot": ["agricoltura"] },
    "page": 1
  }
}

Esempio chiamata curl

curl -X POST "/explore/simple-semantic" \
  -H "x-api-key: <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "countriesIso2": ["IT"],
    },
    "semantic": {
      "keywords": ["AI", "machine learning"],
      "must": ["software"],
      "mustNot": ["agricoltura"]
    },
    "page": 1
  }'

Altri codici