The New York Social Diary is a website that tracks the parties of New York's well-to-do. Each party has a page, for example this party from 2014. The captions of these images give a view into their social network - two people that appear in a picture together are connected. Given the unreliability and slowness of the Internet Archive that hosts these pages, this API has been created to provide the captions without having to scrape the pages in the Archive.
The API is a set of endpoints that will take query parameters and return the requested information as JSON
Each page is a different party. The full list of party names can be retrieved
by a GET
request to /parties
. This endpoint takes
two paramters
limit
: How many party names to return at a time. Valid
values are between 1 and 100. Anything outside this range will return
100 partiesoffset
: Which party to start with. Valid values are between
0 (start with the first party) and the number of parties (only get the
last one)As an example, to get the first 20 parties, send the GET
request to /parties?limit=20
To get the next 20 parties after
that, send a request to /parties?limit=20&offset=20
It returns a JSON of the form:
{
"message": "Reports issues",
"next": "optional string, indicates url for next set of parties",
"parties": [
{
"date": "date of first party",
"name": "name of first party"
},
{
"date": "date of second party",
"name": "name of second party"
},
...
]
}
The list of captions for an individual party can be retrieved by a
GET
request to /captions
. This endpoint takes
one parameter
party
: Which party to retrieveAs an example, to get the captions for the party named
"2007-friends-and-tastemakers", send the request to
/captions?party=2007-friends-and-tastemakers
It returns a JSON of the form:
{
"message": "Reports issues",
"name": "name of party requested",
"captions": [
"first caption",
"second caption",
...
]
}