We analyze the anonymised information of our users to better match our offer and website content to your needs. This site also uses cookies to, for example, analyze traffic on the site. You can specify the conditions for storage or access of cookies in your browser. Learn more.

API:
Documentation

Tags

List tags
Get tag
List tag photos

List tags

Get most popular tags.

GET /tags
Response
{
    "data": [
        {
            "id": 18,
            "name": "Afternoon",
            "slug": "afternoon",
            "count": 33684
        }
    ],
    "meta": {
        "pagination": {
            "total": 30601,
            "count": 10,
            "per_page": 10,
            "current_page": 1,
            "total_pages": 3061,
            "links": {
                "next": "https://api.tookapic.com/tags?page=2"
            }
        }
    }
}

Get tag

GET /tags/:slug
Response
{
    "data": {
        "id": 18,
        "name": "Afternoon",
        "slug": "afternoon",
        "count": 33684
    }
}

List tag photos

Get photos with given :slug.

GET /tags/:slug/photos
Parameters
NameTypeDescription
sortstring Can be one of: recent, popular. Default: popular
filterstringCan be one of: all, premium. Default: all
curatedbooleanCan be one of: true, false.
includestringFetch additional data using one or more includes separated by comma. Available includes: user, colors, comments
Response
{
    "data": [
        {
            "id": 16186,
            "title": "Dog In The Backyard ",
            "url": "https://tookapic.com/photos/16186",
            "description": "I followed one of my dogs down to the backyard. He's a Maltese - Shih Tzu mix and also a great model. // Day #2",
            "image_thumb": "https://cdn.tookapic.com/photos/2015/159/1/7/17a2ba9ee420b5925506826caf37a4f4.jpg?w=430&h=430&q=85&sharp=3&s=e3bce1793ba28850bf01bb110ab71b04",
            "image_large": "https://cdn.tookapic.com/photos/2015/159/1/7/17a2ba9ee420b5925506826caf37a4f4.jpg?q=85&sharp=3&w=730&fit=crop&s=7adcbfa7fa0a9e6160de6e4d59779562",
            "width": 4512,
            "height": 3008,
            "tags": [
                "dog",
                "evening",
                "backyard",
                "home",
                "afternoon",
                "tuesday",
                "june"
            ],
            "count_likes": 6,
            "count_comments": 0,
            "is_premium": 0,
            "is_liked": 0,
            "took_at": "2015-06-09T19:52:57+0200",
            "created_at": "2015-06-10T01:21:40+0200"
        },
    ]
}
Pawel from Tookapic

Hi, I’m happy to help you with any tookapic subject, however, before you send me a message, please look at Help section where you can find answers for most questions.

We’ll reply shortly!

Please note that answers for most questions about tookapic can be found in the Help section.