Item Details

This API call returns the metadata associated with a Pin, the primary data object within the Historypin repository. This data structure includes everything that we store about Pins. This call also includes enough information to build the full user interface for a Pin, which includes some information about the Collections which this Pin is associated with (or "Repinned" to).

URL

http://www.historypin.org/en/api/pin/get.json{?parameters}

Parameters

Example JSON

http://www.historypin.org/en/api/pin/get.json?id=160180

{
    "id"                : 160180,
    "caption"           : "Bulgarian Army Theater",
    "description"       : "This is a photo of the famous Bulgarian Army Theater .",
    "pinner_type"       : "photo",
    "type"              : "photo",
    "type_id"           : 0,
    "times_viewed"      : 118,
    "times_favourited"  : 0,
    "order_index"       : 0,

    "display"           : {
        "content"   : "/services/thumb/phid/160180/dim/1000x1000/quality/90/",
        "class"     : "image-pin"
    },

    "oembeded"          : false,
    "date"              : "2014-02-02",
    "date_added"        : "Mon 03 Jun 2013",
    "date_taken"        : "2 February 2014",
    "date_taken_range"  : "2014:2014",

    "location" : {
        "lat"               : 42.694653,
        "lng"               : 23.328998,
        "zoom"              : 15,
        "range"             : 0,
        "raw"               : "",
        "geo_tags"          : "ulitsa "Georgi. S. Rakovski" 98-100, 1000 Sofia, Bulgaria",
        "for_streetview"    : true,
        "streetview" :
        {

            "heading"   : -448.966,
            "pitch"     : -0.642857,
            "zoom"      : 0.0,
            "opacity"   : 1,
            "params"    : {"i":{"x":325,"y":207,"w":480,"h":322},"c":{"x":0,"y":0,"w":480,"h":322}}
        }
    },

    "geo_tags"          : "ulitsa "Georgi. S. Rakovski" 98-100, 1000 Sofia, Bulgaria",
    "license_key"       : "no-copyright",
    "license"           : "No known copyright restrictions.",
    "author"            : "Unknown",
    "link"              : "http://novini.bg",
    "repository"        : " Test",
    "notes"             : "Test Notes",
    "rights_statement"  : " Test",
    "user_id"           : 35019,
    "user_image"        : "/resources/avatars/200x200/avatar_3.png",
    "user_name"         : "Gabriela Ananieva",
    "edit_url"          : "/project/1-historypin/upload-item/pin/phid/160180/edit/1/?from=/en/explore/pin/160180",
    "contact_us"        : "/contact-us/?report/#!/dialog:160180",
    "count_comments"    : "2",
    "tags"              : [
            { "id": 1734820, "text": "theater" },
            { "id": 1734822, "text": "theatre" },
            { "id": 2771935, "text": "bulgarian army" }
    ],

    "remote": {
        "id" : "/2021613/tracks_48226240"
    },

    "places"            : [
        {
            "id"                    : 293,
            "title"                 : "Bulgaria",
            "slug"                  : "bulgaria",
            "path"                  : "bulgaria",
            "center"                : "42.7270330000,25.4820355000",
            "zoom"                  : "6",
            "parent_title"          : ""
        },

        {
            "id"                    : 1244,
            "title"                 : "Sofia",
            "slug"                  : "sofia",
            "path"                  : "bulgaria/sofia",
            "center"                : "42.6543950000,23.3648820000",
            "zoom"                  : "10",
            "parent_title"          : "Bulgaria"
        }
    ],

    "repinned_projects" : [
            {
                "id"            : "7580",
                "node_type"     : "project",
                "class"         : "",
                "card_tpl"      : "/en/api/cards/project.tpl",

                "position"      : "",

                "title"         : "Gabriela Ananieva\u0027s Collection",
                "desc"          : "",
                "slug"          : "gabriela-ananieva-s-collection",
                "pins_count"    : "1",
                "parent"        : "",
                "times_viewed"  : 757,
                "on_explore"    : 1,

                "sponsored"     : {  },
                    "owner" :
                    {
                        "id"    : "35019",
                        "name"  : "Gabriela Ananieva",
                        "image" : "//resources-cdn.historypin.org/resources/avatars/200x200/avatar_3.png"
                    },

                "images":
                [
                    { "id": "160180", "url": "//photos-cdn.historypin.org/services/thumb/phid/160180/dim/280x225/crop/1/", "pin_class": "", "media_url": "" },
                    { "id": "", "url": "//photos-cdn.historypin.org/services/thumb/phid//dim/280x225/crop/1/", "pin_class": "", "media_url": "" },
                    { "id": "", "url": "//photos-cdn.historypin.org/services/thumb/phid//dim/280x225/crop/1/", "pin_class": "", "media_url": "" },
                    { "id": "", "url": "//photos-cdn.historypin.org/services/thumb/phid//dim/280x225/crop/1/", "pin_class": "", "media_url": "" }
                ]

            },

            {
                "id"            : "18986",
                "node_type"     : "project",
                "class"         : "",
                "card_tpl"      : "/en/api/cards/project.tpl",
                "position"      : "",
                "title"         : "Theaters in Bulgaria",
                "desc"          : "Collection for famous theaters in Bulgaria",
                "slug"          : "theaters-in-bulgaria",
                "pins_count"    : "2",
                "parent"        : "",
                "times_viewed"  : 241,
                "on_explore"    : 1,
                "sponsored"     : {  },

                "owner" :
                {
                    "id"    : "35019",

                    "name"  : "Gabriela Ananieva",
                    "image" : "//resources-cdn.historypin.org/resources/avatars/200x200/avatar_3.png"
                },

                "images":
                [
                    { "id": "160180", "url": "//photos-cdn.historypin.org/services/thumb/phid/160180/dim/280x225/crop/1/", "pin_class": "", "media_url": "" },
                    { "id": "", "url": "//photos-cdn.historypin.org/services/thumb/phid//dim/280x225/crop/1/", "pin_class": "", "media_url": "" },
                    { "id": "", "url": "//photos-cdn.historypin.org/services/thumb/phid//dim/280x225/crop/1/", "pin_class": "", "media_url": "" },
                    { "id": "", "url": "//photos-cdn.historypin.org/services/thumb/phid//dim/280x225/crop/1/", "pin_class": "", "media_url": "" }
                ]

            },

            {
                "id"            : "22175",
                "node_type"     : "tour",
                "class"         : "",
                "card_tpl"      : "/en/api/cards/tour.tpl",
                "position"      : "",
                "title"         : "Beautiful buildings in Bulgaria",
                "desc"          : "Tour about beautiful buildings in Bulgaria",
                "slug"          : "beautiful-buildings-in-bulgaria",
                "pins_count"    : "2",
                "parent"        : "",
                "times_viewed"  : 504,
                "on_explore"    : 1,
                "sponsored"     : {  },

                    "owner" :
                    {
                        "id"    : "35019",

                        "name"  : "Gabriela Ananieva",
                        "image" : "//resources-cdn.historypin.org/resources/avatars/200x200/avatar_3.png"
                    },

                "images":
                [
                    { "id": "160180", "url": "//photos-cdn.historypin.org/services/thumb/phid/160180/dim/280x225/crop/1/", "pin_class": "", "media_url": "" },
                    { "id": "", "url": "//photos-cdn.historypin.org/services/thumb/phid//dim/280x225/crop/1/", "pin_class": "", "media_url": "" },
                    { "id": "", "url": "//photos-cdn.historypin.org/services/thumb/phid//dim/280x225/crop/1/", "pin_class": "", "media_url": "" }
                ]
            }
    ]
}