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.