Date di nascita per sviluppatori e IA
API pubblica e MCP
WhoWasBorn offre un’API REST pubblica di sola lettura e un server Model Context Protocol senza stato. Entrambi usano lo snapshot Wikidata del sito. Nessuna chiave API richiesta. La copertura comprende persone note registrate in Wikidata e non è esaustiva.
API REST
Gli endpoint GET coprono compleanni, date complete, persone, ricerca, anni di nascita, segni e metadati. Gli elenchi accettano limit (1–100) e offset; la ricerca restituisce fino a 20 candidati. GET tra origini diverse è consentito. Limite: 60 richieste al minuto per IP. Rispetta HTTP 429 e Retry-After. Usa data_version dai metadati per i profili con versione. Le risposte legate alla data scadono alla prossima mezzanotte pertinente; calcola le età per la data richiesta.
Sviluppatori: REST API · OpenAPI 3.1
curl 'https://whowasborn.com/api/v1/birthdays/12-13?limit=10&lang=it'
curl 'https://whowasborn.com/api/v1/people/wikidata/Q26876?lang=it'
curl 'https://whowasborn.com/api/v1/meta'MCP per client IA
Collega un client MCP a https://whowasborn.com/mcp tramite Streamable HTTP. L’endpoint usa POST; aprirlo nel browser restituisce 405. Includi Accept: application/json, text/event-stream. Nessuna sessione o autenticazione richiesta. Limite: 30 richieste al minuto per IP; corpo massimo di 32 KiB.
{"mcpServers":{"whowasborn":{"url":"https://whowasborn.com/mcp"}}}Strumenti e risorse
Strumenti: birthdays_on_date, birthdays_today, person_birth_date, search_people e age_on_date. Risorse: whowasborn://meta e whowasborn://methodology. Prompt: who_shares_birthday. Chiama person_birth_date con query Q26876 oppure birthdays_on_date con month 12 e day 13. Se un nome corrisponde a più persone, scegli un QID prima di riportare una data.
{"name":"person_birth_date","arguments":{"query":"Q26876","lang":"it"}}Lingue e ripiego
Tutte le rotte dati e gli strumenti accettano lang: en, de, pt, es, fr, it (predefinito en). Nomi, descrizioni, professioni e luoghi usano la lingua richiesta, poi mul, poi en. Le descrizioni assenti restano null; nessuna traduzione automatica. Gli URL usano la lingua richiesta quando la pagina esiste, altrimenti l’inglese. Snapshot grezzi e identificatori restano invariati. Un profilo localizzato richiede un’etichetta locale o mul; l’indicizzazione richiede anche una descrizione nella lingua e i consueti criteri di qualità.
Dati citabili e incertezza
Una dichiarazione canonica Wikidata è una scelta di visualizzazione, non una verifica indipendente. Conserva birth_date.status, source_kind, uncertainty, sources e alternatives. Date contestate o imprecise non permettono un’età esatta. Una morte non registrata non prova che la persona sia viva. I luoghi conservano edificio o quartiere originale accanto alla città e al paese risolti. Non ricostruiamo confini storici. Per le nascite del 29 febbraio, negli anni non bisestili l’età aumenta il 1° marzo. I segni seguono intervalli fissi del calendario.
Licenza e attribuzione
I dati Wikidata sono CC0 1.0. Le immagini conservano licenze e crediti Commons individuali; controllali prima del riuso. L’attribuzione a WhoWasBorn è apprezzata: collega la persona o data pertinente e conserva fonti e alternative discordanti. Il testo MCP include un URL per la citazione.
Privacy e contatti
Il sito conta richieste solo per giorno UTC, tipo di pagina con lingua e famiglia dichiarata del crawler. I limiti API usano gli IP temporaneamente in memoria; i contatori non salvano IP né user agent grezzi. Domande e correzioni: hello@whowasborn.com.