https://github.com/danasilver/baby-names-service
Query the US Census Names 1880-2012 dataset.
https://github.com/danasilver/baby-names-service
Last synced: 12 months ago
JSON representation
Query the US Census Names 1880-2012 dataset.
- Host: GitHub
- URL: https://github.com/danasilver/baby-names-service
- Owner: danasilver
- License: mit
- Created: 2016-07-08T06:02:48.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2016-07-22T02:45:07.000Z (almost 10 years ago)
- Last Synced: 2025-02-24T02:30:38.106Z (over 1 year ago)
- Language: JavaScript
- Homepage: http://baby-names-service.danasilver.org/Dana/M
- Size: 8.24 MB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Baby Names Service
[](https://travis-ci.org/danasilver/baby-names-service)
Run queries on the [baby names](https://github.com/danasilver/baby-names-service/blob/master/data/names1880-2012.csv) dataset.
### API
#### Lookup
```
GET /:name/:gender
```
Where `:name` is a name in the dataset and `:gender` is one of `F` or `M`.
Responds with JSON containing ordered data points between the years 1880 and
2012, inclusive. `count` is the number of babies born that year with the
specified name and gender.
```
[
{
"name": "Dana",
"gender": "F",
"count": "6",
"year": "1882"
},
...
{
"name": "Dana",
"gender": "F",
"count": "452",
"year": "2012"
}
]
```
#### Index
```
GET /index
```
Responds with JSON containing an index of the names and genders in the
dataset.
```
[
{
"name": "Mary",
"gender":"F"
},
{
"name": "Anna",
"gender": "F"
},
...
]
```
#### Health Check
```
GET /ok
```
Health check endpoint. Response with a HTTP `200 OK` status.