{"openapi":"3.1.0","info":{"title":"Baby Names API","version":"1.0.0","description":"US given-name popularity from 1880 to 2008 as an API — the top 1,000 names per year for each sex (SSA-derived dataset, 6,782 names). Pull a name's full popularity trend (e.g. Emma → girls: rank #1 in 2008, peaked again in 1881), get the top names for any year (e.g. 1990 → Jessica, Ashley, Brittany), or search names by prefix/substring. Each data point carries the year, the share of births (percent and per-million) and the rank. Ideal for name-trend visualisations, baby-name apps, nostalgia/genealogy tools and data journalism.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/babynames-api","description":"oanor gateway"}],"tags":[{"name":"Baby Names"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/name":{"get":{"operationId":"get_v1_name","tags":["Baby Names"],"summary":"A name's popularity profile + yearly trend","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"Given name, e.g. Emma","schema":{"type":"string"},"example":"Emma"},{"name":"sex","in":"query","required":false,"description":"boy | girl (omit for both)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Emma","results":[{"sex":"boy","name":"Emma","peak":{"rank":466,"year":1890,"percent":0.000134},"latest":{"rank":738,"year":1910,"percent":8.2e-5},"series":[{"rank":613,"year":1880,"percent":8.4e-5,"per_million":84},{"rank":618,"year":1881,"percent":8.3e-5,"per_million":83},{"rank":778,"year":1882,"percent":5.7e-5,"per_million":57},{"rank":750,"year":1883,"percent":6.2e-5,"per_million":62},{"rank":675,"year":1884,"percent":7.3e-5,"per_million":73},{"rank":509,"year":1885,"percent":0.000121,"per_million":121},{"rank":582,"year":1886,"percent":9.2e-5,"per_million":92},{"rank":467,"year":1887,"percent":0.000128,"per_million":128},{"rank":473,"year":1888,"percent":0.000131,"per_million":131},{"rank":640,"year":1889,"percent":8.4e-5,"per_million":84},{"rank":466,"year":1890,"percent":0.000134,"per_million":134},{"rank":503,"year":1891,"percent":0.000119,"per_million":119},{"rank":613,"year":1892,"percent":9.1e-5,"per_million":91},{"rank":516,"year":1893,"percent":0.000116,"per_million":116},{"rank":525,"year":1894,"percent":0.00012,"per_million":120},{"rank":616,"year":1895,"percent":9.5e-5,"per_million":95},{"rank":688,"year":1896,"percent":8.5e-5,"per_million":85},{"rank":830,"year":1898,"percent":6.1e-5,"per_million":61},{"rank":675,"year":1899,"percent":8.7e-5,"per_million":87},{"rank":522,"year":1900,"percent":0.000129,"per_million":129},{"rank":796,"year":1901,"percent":6.9e-5,"per_million":69},{"rank":704,"year":1902,"percent":8.3e-5,"per_million":83},{"rank":748,"year":1903,"percent":7.7e-5,"per_million":77},{"rank":699,"year":1904,"percent":8.7e-5,"per_million":87},{"rank":956,"year":1906,"percent":5.6e-5,"per_million":56},{"rank":832,"year":1907,"percent":6.9e-5,"per_million":69},{"rank":738,"year":1910,"percent":8.2e-5,"per_million":82}],"last_year":1910,"first_year":1880,"years_in_top1000":27},{"sex":"girl","name":"Emma","peak":{"rank":3,"year":1881,"percent":0.020574},"latest":{"rank":1,"year":2008,"percent":0.009043},"series":[{"rank":3,"year":1880,"percent":0.020521,"per_million":20521},{"rank":3,"year":1881,"percent":0.020574,"per_million":20574},{"rank":3,"year":1882,"percent":0.019905,"per_million":19905},{"rank":3,"year":1883,"percent":0.019714,"per_million":19714},{"rank":3,"year":1884,"percent":0.018803,"per_million":18803},{"rank":3,"year":1885,"percent":0.019217,"per_million":19217},{"rank":3,"year":1886,"percent":0.017978,"per_million":17978},{"rank":4,"year":1887,"percent":0.017031,"per_million":17031},{"rank":4,"year":1888,"percent":0.016294,"per_million":16294},{"rank":5,"year":1889,"percent":0.015241,"per_million":15241},{"rank":5,"year":1890,"percent":0.014777,"per_million":14777},{"rank":5,"year":1891,"percent":0.014671,"per_million":14671},{"rank":7,"year":1892,"percent":0.013907,"per_million":13907},{"rank":9,"year":1893,"percent":0.013177,"per_million":13177},{"rank":9,"year":1894,"percent":0.012446,"per_million":12446},{"rank":10,"year":1895,"percent":0.011946,"per_million":11946},{"rank":10,"year":1896,"percent":0.011397,"per_million":11397},{"rank":10,"year":1897,"percent":0.010867,"per_million":10867},{"rank":13,"year":1898,"percent":0.010169,"per_million":10169},{"rank":13,"year":1899,"percent":0.009879,"per_million":9879},{"rank":13,"year":1900,"percent":0.009736,"per_million":9736},{"rank":17,"year":1901,"percent":0.009338,"per_million":9338},{"rank":18,"year":1902,"percent":0.008968,"per_million":8968},{"rank":23,"year":1903,"percent":0.008296,"per_million":8296},{"rank":22,"year":1904,"percent":0.007909,"per_million":7909},{"rank":26,"year":1905,"percent":0.007412,"per_million":7412},{"rank":28,"year":1906,"percent":0.007093,"per_million":7093},{"rank":27,"year":1907,"percent":0.006991,"per_million":6991},{"rank":30,"year":1908,"percent":0.00665,"per_million":6650},{"rank":34,"year":1909,"percent":0.006354,"per_million":6354},{"rank":34,"year":1910,"percent":0.006215,"per_million":6215},{"rank":35,"year":1911,"percent":0.005921,"per_million":5921},{"rank":35,"year":1912,"percent":0.005719,"per_million":5719},{"rank":38,"year":1913,"percent":0.005301,"per_million":5301},{"rank":39,"year":1914,"percent":0.004984,"per_million":4984},{"rank":40,"year":1915,"percent":0.004926,"per_million":4926},{"rank":41,"year":1916,"percent":0.004806,"per_million":4806},{"rank":46,"year":1917,"percent":0.004559,"per_million":4559},{"rank":46,"year":1918,"percent":0.004428,"per_million":4428},{"rank":45,"year":1919,"percent":0.00433,"per_million":4330},{"rank":46,"year":1920,"percent":0.00421,"per_million":4210},{"rank":52,"year":1921,"percent":0.003962,"per_million":3962},{"rank":50,"year":1922,"percent":0.004021,"per_million":4021},{"rank":54,"year":1923,"percent":0.003969,"per_million":3969},{"rank":57,"year":1924,"percent":0.00378,"per_million":3780},{"rank":57,"year":1925,"percent":0.003731,"per_million":3731},{"rank":60,"year":1926,"percent":0.003641,"per_million":3641},{"rank":65,"year":1927,"percent":0.003502,"per_million":3502},{"rank":67,"year":1928,"percent":0.003363,"per_million":3363},{"rank":69,"year":1929,"percent":0.003288,"per_million":3288},{"rank":73,"year":1930,"percent":0.003047,"per_million":3047},{"rank":76,"year":1931,"percent":0.002998,"per_million":2998},{"rank":76,"year":1932,"percent":0.003007,"per_million":3007},{"rank":75,"year":1933,"percent":0.003014,"per_million":3014},{"rank":85,"year":1934,"percent":0.002716,"per_million":2716},{"rank":89,"year":1935,"percent":0.002579,"per_million":2579},{"rank":85,"year":1936,"percent":0.002625,"per_million":2625},{"rank":89,"year":1937,"percent":0.002495,"per_million":2495},{"rank":96,"year":1938,"percent":0.002339,"per_million":2339},{"rank":89,"year":1939,"percent":0.002368,"per_million":2368},{"rank":94,"year":1940,"percent":0.002205,"per_million":2205},{"rank":99,"year":1941,"percent":0.002045,"per_million":2045},{"rank":108,"year":1942,"percent":0.00187,"per_million":1870},{"rank":114,"year":1943,"percent":0.001687,"per_million":1687},{"rank":118,"year":1944,"percent":0.001647,"per_million":1647},{"rank":122,"year":1945,"percent":0.001527,"per_million":1527},{"rank":131,"year":1946,"percent":0.001284,"per_million":1284},{"rank":141,"year":1947,"percent":0.001177,"per_million":1177},{"rank":138,"year":1948,"percent":0.001204,"per_million":1204},{"rank":147,"year":1949,"percent":0.001137,"per_million":1137},{"rank":154,"year":1950,"percent":0.001078,"per_million":1078},{"rank":174,"year":1951,"percent":0.000936,"per_million":936},{"rank":179,"year":1952,"percent":0.000902,"per_million":902},{"rank":195,"year":1953,"percent":0.000824,"per_million":824},{"rank":202,"year":1954,"percent":0.000767,"per_million":767},{"rank":211,"year":1955,"percent":0.000726,"per_million":726},{"rank":224,"year":1956,"percent":0.000654,"per_million":654},{"rank":243,"year":1957,"percent":0.000579,"per_million":579},{"rank":266,"year":1958,"percent":0.000526,"per_million":526},{"rank":270,"year":1959,"percent":0.000509,"per_million":509},{"rank":297,"year":1960,"percent":0.000471,"per_million":471},{"rank":307,"year":1961,"percent":0.000427,"per_million":427},{"rank":332,"year":1962,"percent":0.000392,"per_million":392},{"rank":352,"year":1963,"percent":0.000366,"per_million":366},{"rank":343,"year":1964,"percent":0.000392,"per_million":392},{"rank":360,"year":1965,"percent":0.000348,"per_million":348},{"rank":364,"year":1966,"percent":0.000354,"per_million":354},{"rank":385,"year":1967,"percent":0.000328,"per_million":328},{"rank":427,"year":1968,"percent":0.000288,"per_million":288},{"rank":426,"year":1969,"percent":0.000292,"per_million":292},{"rank":422,"year":1970,"percent":0.000286,"per_million":286},{"rank":444,"year":1971,"percent":0.000268,"per_million":268},{"rank":428,"year":1972,"percent":0.000282,"per_million":282},{"rank":448,"year":1973,"percent":0.000269,"per_million":269},{"rank":408,"year":1974,"percent":0.000314,"per_million":314},{"rank":423,"year":1975,"percent":0.000305,"per_million":305},{"rank":462,"year":1976,"percent":0.000265,"per_million":265},{"rank":423,"year":1977,"percent":0.00029,"per_million":290},{"rank":458,"year":1978,"percent":0.000264,"per_million":264},{"rank":432,"year":1979,"percent":0.000278,"per_million":278},{"rank":417,"year":1980,"percent":0.000298,"per_million":298},{"rank":413,"year":1981,"percent":0.000297,"per_million":297},{"rank":410,"year":1982,"percent":0.000308,"per_million":308},{"rank":399,"year":1983,"percent":0.000307,"per_million":307},{"rank":342,"year":1984,"percent":0.000372,"per_million":372},{"rank":267,"year":1985,"percent":0.000507,"per_million":507},{"rank":211,"year":1986,"percent":0.00068,"per_million":680},{"rank":177,"year":1987,"percent":0.000843,"per_million":843},{"rank":160,"year":1988,"percent":0.000927,"per_million":927},{"rank":151,"year":1989,"percent":0.000965,"per_million":965},{"rank":130,"year":1990,"percent":0.001171,"per_million":1171},{"rank":123,"year":1991,"percent":0.001263,"per_million":1263},{"rank":104,"year":1992,"percent":0.001591,"per_million":1591},{"rank":81,"year":1993,"percent":0.002074,"per_million":2074},{"rank":76,"year":1994,"percent":0.002431,"per_million":2431},{"rank":67,"year":1995,"percent":0.00262,"per_million":2620},{"rank":53,"year":1996,"percent":0.003195,"per_million":3195},{"rank":36,"year":1997,"percent":0.004048,"per_million":4048},{"rank":22,"year":1998,"percent":0.005382,"per_million":5382},{"rank":17,"year":1999,"percent":0.006021,"per_million":6021},{"rank":17,"year":2000,"percent":0.006287,"per_million":6287},{"rank":13,"year":2001,"percent":0.006721,"per_million":6721},{"rank":4,"year":2002,"percent":0.008377,"per_million":8377},{"rank":2,"year":2003,"percent":0.011327,"per_million":11327},{"rank":2,"year":2004,"percent":0.010721,"per_million":10721},{"rank":2,"year":2005,"percent":0.010033,"per_million":10033},{"rank":2,"year":2006,"percent":0.009153,"per_million":9153},{"rank":3,"year":2007,"percent":0.008688,"per_million":8688},{"rank":1,"year":2008,"percent":0.009043,"per_million":9043}],"last_year":2008,"first_year":1880,"years_in_top1000":129}]},"meta":{"timestamp":"2026-05-31T05:48:02.973Z","request_id":"c3edeba0-ea8b-4a47-bb8a-fa18e59abf76"},"status":"ok","message":"Name profile retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Baby Names"],"summary":"Search names by prefix/substring","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Name fragment, e.g. emm","schema":{"type":"string"},"example":"emm"},{"name":"sex","in":"query","required":false,"description":"boy | girl","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results per page (1-100, default 20)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":19,"limit":20,"query":"emm","total":19,"offset":0,"results":[{"sex":"girl","name":"Emma","peak_year":1881,"peak_percent":0.020574,"years_in_top1000":129},{"sex":"boy","name":"Emmanuel","peak_year":2008,"peak_percent":0.001311,"years_in_top1000":64},{"sex":"boy","name":"Emmett","peak_year":1895,"peak_percent":0.00109,"years_in_top1000":129},{"sex":"boy","name":"Emmet","peak_year":1880,"peak_percent":0.000287,"years_in_top1000":52},{"sex":"girl","name":"Emmalee","peak_year":2005,"peak_percent":0.000216,"years_in_top1000":10},{"sex":"girl","name":"Emmie","peak_year":1896,"peak_percent":0.00019,"years_in_top1000":53},{"sex":"boy","name":"Emmitt","peak_year":1905,"peak_percent":0.000182,"years_in_top1000":85},{"sex":"girl","name":"Clemmie","peak_year":1892,"peak_percent":0.000169,"years_in_top1000":42},{"sex":"girl","name":"Emmer","peak_year":1885,"peak_percent":0.000162,"years_in_top1000":42},{"sex":"girl","name":"Gemma","peak_year":2008,"peak_percent":0.00015,"years_in_top1000":1},{"sex":"girl","name":"Emmaline","peak_year":1880,"peak_percent":0.000143,"years_in_top1000":12},{"sex":"girl","name":"Emmy","peak_year":2008,"peak_percent":0.000135,"years_in_top1000":3},{"sex":"boy","name":"Emma","peak_year":1890,"peak_percent":0.000134,"years_in_top1000":27},{"sex":"boy","name":"Emmit","peak_year":1886,"peak_percent":0.000126,"years_in_top1000":45},{"sex":"boy","name":"Lemmie","peak_year":1903,"peak_percent":8.5e-5,"years_in_top1000":2},{"sex":"boy","name":"Clemmie","peak_year":1894,"peak_percent":5.6e-5,"years_in_top1000":1},{"sex":"girl","name":"Lemma","peak_year":1882,"peak_percent":5.2e-5,"years_in_top1000":3},{"sex":"boy","name":"Emmons","peak_year":1894,"peak_percent":4.8e-5,"years_in_top1000":1},{"sex":"girl","name":"Clemma","peak_year":1887,"peak_percent":4.5e-5,"years_in_top1000":1}]},"meta":{"timestamp":"2026-05-31T05:48:03.054Z","request_id":"8e5de084-1424-498a-8b6c-456a15a98119"},"status":"ok","message":"Names listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/year":{"get":{"operationId":"get_v1_year","tags":["Baby Names"],"summary":"Top names for a year","description":"","parameters":[{"name":"year","in":"query","required":true,"description":"Year 1880-2008, e.g. 2000","schema":{"type":"string"},"example":"2000"},{"name":"sex","in":"query","required":false,"description":"boy | girl (omit for both)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Top N (1-100, default 20)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"boy":[{"name":"Jacob","rank":1,"percent":0.016514,"per_million":16514},{"name":"Michael","rank":2,"percent":0.015346,"per_million":15346},{"name":"Matthew","rank":3,"percent":0.013695,"per_million":13695},{"name":"Joshua","rank":4,"percent":0.013194,"per_million":13194},{"name":"Christopher","rank":5,"percent":0.01199,"per_million":11990},{"name":"Nicholas","rank":6,"percent":0.011815,"per_million":11815},{"name":"Andrew","rank":7,"percent":0.011324,"per_million":11324},{"name":"Joseph","rank":8,"percent":0.01093,"per_million":10930},{"name":"Daniel","rank":9,"percent":0.010681,"per_million":10681},{"name":"Tyler","rank":10,"percent":0.010305,"per_million":10305},{"name":"William","rank":11,"percent":0.009896,"per_million":9896},{"name":"Brandon","rank":12,"percent":0.009745,"per_million":9745},{"name":"Ryan","rank":13,"percent":0.009715,"per_million":9715},{"name":"John","rank":14,"percent":0.009617,"per_million":9617},{"name":"Zachary","rank":15,"percent":0.009516,"per_million":9516},{"name":"David","rank":16,"percent":0.009454,"per_million":9454},{"name":"Anthony","rank":17,"percent":0.009416,"per_million":9416},{"name":"James","rank":18,"percent":0.008613,"per_million":8613},{"name":"Justin","rank":19,"percent":0.00852,"per_million":8520},{"name":"Alexander","rank":20,"percent":0.008282,"per_million":8282}],"girl":[{"name":"Emily","rank":1,"percent":0.013017,"per_million":13017},{"name":"Hannah","rank":2,"percent":0.011569,"per_million":11569},{"name":"Madison","rank":3,"percent":0.010017,"per_million":10017},{"name":"Ashley","rank":4,"percent":0.009027,"per_million":9027},{"name":"Sarah","rank":5,"percent":0.008865,"per_million":8865},{"name":"Alexis","rank":6,"percent":0.008837,"per_million":8837},{"name":"Samantha","rank":7,"percent":0.00866,"per_million":8660},{"name":"Jessica","rank":8,"percent":0.007876,"per_million":7876},{"name":"Taylor","rank":9,"percent":0.007564,"per_million":7564},{"name":"Elizabeth","rank":10,"percent":0.007561,"per_million":7561},{"name":"Lauren","rank":11,"percent":0.00711,"per_million":7110},{"name":"Alyssa","rank":12,"percent":0.006798,"per_million":6798},{"name":"Kayla","rank":13,"percent":0.006677,"per_million":6677},{"name":"Abigail","rank":14,"percent":0.006564,"per_million":6564},{"name":"Brianna","rank":15,"percent":0.006458,"per_million":6458},{"name":"Olivia","rank":16,"percent":0.006446,"per_million":6446},{"name":"Emma","rank":17,"percent":0.006287,"per_million":6287},{"name":"Megan","rank":18,"percent":0.005737,"per_million":5737},{"name":"Grace","rank":19,"percent":0.00566,"per_million":5660},{"name":"Victoria","rank":20,"percent":0.005477,"per_million":5477}],"year":2000,"limit":20},"meta":{"timestamp":"2026-05-31T05:48:03.129Z","request_id":"91ebbdaf-ab95-4d2d-a374-e77d9a909473"},"status":"ok","message":"Top names listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Year range & totals","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Top 1000 names per year per sex, 1880-2008. percent = fraction of births that year; per_million = percent×1,000,000.","years":129,"fields":["name","sex","year","percent","per_million","rank"],"source":"US given-name popularity (SSA-derived, hadley/data-baby-names)","last_year":2008,"first_year":1880,"unique_names":6782,"per_year_per_sex":1000},"meta":{"timestamp":"2026-05-31T05:48:03.208Z","request_id":"6f6d6353-24d6-43ec-8997-362a5720e4da"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":6000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":400,"monthly_call_quota":70000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1200,"monthly_call_quota":350000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3000,"monthly_call_quota":1600000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/babynames-api"}