API Documentation

Quickstart

Le API anonime (CORS aperto) sono usabili da qualsiasi browser/server senza autenticazione. Per rate limit più alti registra una API key gratuita in 1 minuto:

curl -X POST https://trustinsider.ai/api/sign-up \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","use_case":"research"}'

Authentication

Header X-TI-API-Key: ti_live_... oppure query ?key=ti_live_...(sconsigliato in produzione, finisce nei log).

Endpoints

Country Trust

• GET /api/v2/countries/preview — paesi con aziende giudicate: banda mediana + distribuzione (scala ordinale dichiarata).
• GET /api/v2/countries/{slug} — dettaglio paese a bande (pilastri + settori).

Intelligence

• GET /api/v2/intelligence/country-rankings — classifica paesi per banda mediana.
• GET /api/v2/intelligence/country-sector-matrix — matrice paesi × settori a bande.
• GET /api/v2/intelligence/country-data.csv — dataset a bande CSV (CC-BY 4.0).

Le corrispondenti rotte /api/v1/* restano attive ma sono deprecate (header Deprecation + Sunset): rispondono con il gemello a bande e i campi numerici storici a null.

Geocoding

• GET /api/v1/geocoding/reverse?lat=...&lng=... — point-in-polygon ISO2 lookup.

Search

• GET /api/v1/search?q=... — full-text companies/products.

Account

• POST /api/sign-up — crea nuova API key.
• GET /api/dashboard — usage stats (last hour, last day, totale).

Rate limits

Code examples

cURL

curl -H "X-TI-API-Key: ti_live_xxx" \
  "https://trustinsider.ai/api/v1/countries/italia"

JavaScript (fetch)

const res = await fetch('https://trustinsider.ai/api/v1/countries/italia', {
  headers: { 'X-TI-API-Key': process.env.TI_API_KEY },
});
const data = await res.json();
console.log(data.metrics);

Python (requests)

import requests, os
r = requests.get(
  'https://trustinsider.ai/api/v1/countries/italia',
  headers={'X-TI-API-Key': os.environ['TI_API_KEY']},
)
print(r.json()['metrics'])

Go (net/http)

req, _ := http.NewRequest("GET",
    "https://trustinsider.ai/api/v1/countries/italia", nil)
req.Header.Set("X-TI-API-Key", os.Getenv("TI_API_KEY"))
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

R (httr)

library(httr)
r <- GET(
  "https://trustinsider.ai/api/v1/countries/italia",
  add_headers("X-TI-API-Key" = Sys.getenv("TI_API_KEY"))
)
content(r)

Postman collection

Postman collection scaricabile a /api/postman-collection.json.

Citation

I dataset sono CC-BY 4.0. Citazione consigliata:

TrustInsider (2026). Country Trust Bands Dataset. NEURALWORD S.r.l.
https://trustinsider.ai/api  ·  CC-BY 4.0

BibTeX:

@dataset{trustinsider2026country,
  author    = {{TrustInsider}},
  publisher = {NEURALWORD S.r.l.},
  title     = {Country Trust Bands Dataset},
  year      = {2026},
  url       = {https://trustinsider.ai/api},
  license   = {CC-BY 4.0}
}

Changelog

• v1 (2026-04) — release iniziale: countries, intelligence, geocoding, search.