Listings
Historypin uses the same feed for most of the listings.
URL
http://www.historypin.org/en/api/{project-path}/{TYPE}/listing.json{?parameters}
- project-path (slugs, optional) - A value representing the project slug or a hierarchical path of project slugs.
Types
- pin
- user
- projects
- places
Parameters
- search (search) - Search Parameter (Read More)
-
sort (string) - possible sortings:
- -recent - Recently added content first
- date_taken - Oldest content first
- -date_taken - Newest content first
- popular - Most popular content first
-
limit (integer, default: 24) - A value representing the content per page served
- page (integer) - A value representing the current page of served content
Pin Specific Parameters
- user (integer) - A value representing the User Identification Number (ID)
- places (string) - A value representing the country slug or country/area slug pair.
http://www.historypin.org/en/api/pin/listing.json?limit=6&page=1&sort=-recent&user=11
{
"limit" : 6,
"count" : 27,
"page" : 1,
"search": "",
"sort" : "-recent",
"results": [
{
"node_type" : "pin",
"url" : "/en/explore/pin/66310",
"class" : "",
"id" : 66310,
"type" : "photo",
"pin_class" : "",
"image" : "//photos-cdn.historypin.org/services/thumb/phid/66310/dim/611x315/quality/80/",
"media_url" : "",
"text" : "",
"caption" : "Island Lake Cottage",
"user" :
{
"id" : 11,
"url" : "/channels/view/11/",
"name" : "Mary Ellen Daley",
"image" : "/channels/img/11/logo/1/dim/50x50/crop/1/"
},
"desc" : "A photo of my cousin Dennis, Me, Arlene, Bruna and cousins Barbara and Bonnie enjoying our time at the cottage. There were many happy times we spent together there.",
"project" : "Mary Ellen Daley's Collection",
"project_slug" : "mary-ellen-daley-s-collection",
"streetview" : "",
"counts" :
{
"viewed" : 24,
"comments" : 0
},
"complete" : 1,
"edit_url" : "/en/pinner/66310/",
"is_owned_by_user" : 1
},
...
]
}
User Specific Parameters
- places (string) - A value representing the country slug or country/area slug pair.
http://www.historypin.org/en/api/user/listing.json?limit=24&page=1&search=&sort=most_popular
{
"limit" : 24,
"count" : 67565,
"page" : 1,
"search" : "",
"sort" : "most_popular",
"results": [
{
"id" : 11417,
"url" : "/en/person/11417/",
"image" "/channels/img/11417/logo/1/dim/225x225/crop/1/",
"name" "SFMTA Photo Archive",
"counts" :
{
"pins_count" : 4085,
"times_viewed" : 34863
}
},
...
]
}
Projects Specific Parameters
- user (integer) - A value representing the Project Identification Number (ID)
- places (string) - A value representing the country slug or country/area slug pair.
- featured (string, optional) - possible values:
- true
- parents (integer, optional) - possible values:
- 1
- type (string, optional) - possible values:
- collection
- tour
{
"limit" : 24,
"count" : 19399,
"page" : 1,
"search": "",
"sort" : "popular",
"results": [
{
"node_type" : "project",
"class" : "",
"image" : "//photos-cdn.historypin.org/projects/img/pid/227/type/project_image,banner,logo/dim/1920x2000/c/1428593449",
"id" : 227,
"type" : 0,
"title" : "Plumpton and East Chiltington in 1914 -1918",
"slug" : "plumpton-and-east-chiltington-in-1914",
"desc" : "This project was set up to mark the centenary of the outbreak of the First World War in Plumpton and East Chiltington",
"position" : "50.933918,-0.06144,11",
"pins_count" : "25",
"sponsored" : { },
"times_viewed" : 123383,
"on_explore" : 1,
"classic_url" : "/project/227-plumpton-and-east-chiltington-in-1914/",
"edit_url" : "/en/plumpton-and-east-chiltington-in-1914/collection/edit",
"parent" : "Heritage Lottery Funded Projects",
"owner":
{
"id" : "58020",
"url" : "/channels/view/58020/",
"name" : "Plumpton and East Chiltington in 1914",
"image" : "//resources-cdn.historypin.org/resources/avatars/200x200/avatar_5.png"
},
"images" :
[
{
"id" : "i.id",
"url" : "//photos-cdn.historypin.org/projects/img/pid/227/type/project_image,banner,logo/dim/280x255/crop/1/c/1428593449"
},
{
"id" : "277808",
"url" : "//photos-cdn.historypin.org/services/thumb/phid/277808/dim/280x225/crop/1/",
"pin_class" : "",
"media_url" : ""
},
{
"id" : "277807",
"url" : "//photos-cdn.historypin.org/services/thumb/phid/277807/dim/280x225/crop/1/",
"pin_class" : "",
"media_url" : ""
},
{
"id" : "277806",
"url" : "//photos-cdn.historypin.org/services/thumb/phid/277806/dim/280x225/crop/1/",
"pin_class" : "",
"media_url" : ""
},
{
"id" : "277805",
"url" : "//photos-cdn.historypin.org/services/thumb/phid/277805/dim/280x225/crop/1/",
"pin_class" : "",
"media_url" : ""
}
],
"users" :
[
]
},
...
]
}
Places Specific Parameters
No sort params for places.
- id (integer) - country id to get all the places/areas in it.
- geo (string) - //TO-DO
- country (string) - possible values:
- true
- false
http://www.historypin.org/en/api/places/listing.json?limit=12&page=1
{
"limit" : 12,
"count" : 5024,
"page" : 1,
"results" : [
{
"id" : 110,
"parent_id" : 0,
"level" : "0",
"title" : "Afghanistan",
"slug" : "afghanistan",
"path" : "afghanistan",
"center" : "33.9339750000,67.6828155000",
"zoom" : "5"
},
...
]
}