API:
Documentation

Users

List users
Get user
List user photos
List user likes
List user followers
List user following
Follow user
Unfollow user

List users

GET /users
Parameters
NameTypeDescription
sortstring Can be one of new, popular, photos, streak. Default: popular
Response
{
    "data": [
        {
            "id": 1,
            "name": "Paweł Kadysz",
            "username": "pawelkadysz",
            "location": "Białystok, Poland",
            "bio": "It was August 14th 2013.",
            "avatar": "https://cdn.tookapic.com/avatars/2014/322/e/3/e32b5a9133b8370d6137328bc182ccc6.png?w=128&h=128&fit=crop&q=85&sharp=3&s=ee77785b8ffd22a91c2fe156512997d5",
            "level": 10,
            "streak": 549,
            "is_hero": 1,
            "is_followed": 1,
            "website_url": "http://tookapic.com",
            "count_missed": 51,
            "count_completed": 150,
            "count_photo_views": 434376,
            "count_photos": 549,
            "count_followers": 814,
            "count_following": 348,
            "count_comments": 1065,
            "count_downloads": 43050,
            "created_at": "2014-10-09T12:55:44+0200"
        }
    ],
    "meta": {
        "pagination": {
            "total": 2325,
            "count": 10,
            "per_page": 10,
            "current_page": 1,
            "total_pages": 233,
            "links": {
                "next": "https://api.tookapic.com/users?page=2"
            }
        }
    }
}

Get user

GET /users/:username
Response
{
    "data": {
        "id": 1,
        "name": "Paweł Kadysz",
        "username": "pawelkadysz",
        "location": "Białystok, Poland",
        "bio": "It was August 14th 2013.",
        "avatar": "https://cdn.tookapic.com/avatars/2014/322/e/3/e32b5a9133b8370d6137328bc182ccc6.png?w=128&h=128&fit=crop&q=85&sharp=3&s=ee77785b8ffd22a91c2fe156512997d5",
        "level": 10,
        "streak": 549,
        "is_hero": 1,
        "is_followed": 1,
        "website_url": "http://tookapic.com",
        "count_missed": 51,
        "count_completed": 150,
        "count_photo_views": 434376,
        "count_photos": 549,
        "count_followers": 814,
        "count_following": 348,
        "count_comments": 1065,
        "count_downloads": 43050,
        "created_at": "2014-10-09T12:55:44+0200"
    }
}

List user photos

List published user photos.

GET /users/:username/photos
Parameters
NameTypeDescription
sortstringCan be one of oldest, popular, recent. 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": 69493,
            "title": "Swimming banana",
            "url": "https://tookapic.com/photos/69493",
            "description": "I need to write down all the ideas for the minimal still life series. This idea was pretty cool. The execution - not so good. But 've already eaten the banana, so I guess it'll have to do for today's pic.",
            "image_thumb": "https://cdn.tookapic.com/photos/2016/38/7/b/7b505682a5878ebbd9a39e7351ea822c.jpg?w=430&h=430&q=85&sharp=3&s=68cd066ebe7919b4ea55c9bdbcdfd438",
            "image_large": "https://cdn.tookapic.com/photos/2016/38/7/b/7b505682a5878ebbd9a39e7351ea822c.jpg?q=85&sharp=3&w=730&fit=crop&s=e93a4aceebe82b6ce81ecb2e506cda60",
            "width": 4178,
            "height": 3135,
            "tags": [
                "banana",
                "still-life",
                "minimal",
                "minimalis",
                "swimming",
                "blue",
                "yellow",
                "fruit",
                "fresh",
                "evening",
                "monday",
                "february"
            ],
            "count_likes": 171,
            "count_comments": 19,
            "is_premium": 1,
            "is_liked": 0,
            "took_at": "2016-02-08T20:44:28+0000",
            "created_at": "2016-02-08T21:28:40+0100"
        }
    ],
    "meta": {
        "pagination": {
            "total": 549,
            "count": 10,
            "per_page": 10,
            "current_page": 1,
            "total_pages": 55,
            "links": {
                "next": "https://api.tookapic.com/users/pawelkadysz/photos?page=2"
            }
        }
    }
}

List user likes

GET /users/:username/likes
Parameters
NameTypeDescription
includestringFetch additional data using one or more includes separated by comma. Available includes: user, colors, comments
Response
{
    "data": [
        {
            "id": 96544,
            "title": "Water...",
            "url": "https://tookapic.com/photos/96544",
            "description": "",
            "image_thumb": "https://cdn.tookapic.com/photos/2016/101/7/3/737cc09191bb34fe5a832620cbfa7e9c.jpg?w=430&h=430&q=85&sharp=3&s=7085dc9cb9e99f10cd5604356cdc01c3",
            "image_large": "https://cdn.tookapic.com/photos/2016/101/7/3/737cc09191bb34fe5a832620cbfa7e9c.jpg?q=85&sharp=3&w=730&fit=crop&s=66f496d43aaa1fac127fcc61ec437dff",
            "width": 4288,
            "height": 2848,
            "tags": [
                "morning",
                "monday",
                "april"
            ],
            "count_likes": 2,
            "count_comments": 3,
            "is_premium": 1,
            "is_liked": 0,
            "took_at": "2016-04-11T11:54:15+0000",
            "created_at": "2016-04-11T12:03:04+0200"
        }
    ],
    "meta": {
        "pagination": {
            "total": 16550,
            "count": 10,
            "per_page": 10,
            "current_page": 1,
            "total_pages": 1655,
            "links": {
                "next": "https://api.tookapic.com/users/pawelkadysz/likes?page=2"
            }
        }
    }
}

List user followers

GET /users/:username/followers
Response
{
    "data": [
        {
            "id": 8,
            "name": "agnieszka bladzik",
            "username": "abladzik",
            "location": "Poland",
            "bio": "",
            "avatar": "https://cdn.tookapic.com/avatars/2015/258/7/6/768c32c97e5960c7c34608dd3a6987e7.jpg?w=128&h=128&fit=crop&q=85&sharp=3&s=ce1ce39d4966723ab40c9a24bb10d77e",
            "level": 10,
            "streak": 549,
            "is_hero": 0,
            "is_followed": 0,
            "website_url": "http://agnieszkabladzik.tookapic.com/",
            "count_missed": 50,
            "count_completed": 150,
            "count_photo_views": 175228,
            "count_photos": 549,
            "count_followers": 399,
            "count_following": 35,
            "count_comments": 497,
            "count_downloads": 5451,
            "created_at": "2014-10-10T13:11:54+0200"
        }
    ],
    "meta": {
        "pagination": {
            "total": 814,
            "count": 10,
            "per_page": 10,
            "current_page": 1,
            "total_pages": 82,
            "links": {
                "next": "https://api.tookapic.com/users/pawelkadysz/followers?page=2"
            }
        }
    }
}

List user following

GET /users/:username/following
Response
{
    "data": [
        {
            "id": 5,
            "name": "Michał Kulesza",
            "username": "michalkulesza",
            "location": "Białystok",
            "bio": "Graphic designer, photographer and filmmaker.",
            "avatar": "https://cdn.tookapic.com/avatars/2016/32/c/6/c6a78e8563690f4aebe73e5a75e48099.jpg?w=128&h=128&fit=crop&q=85&sharp=3&s=5526dd34bbe677ee49c368f4f421f98e",
            "level": 10,
            "streak": 515,
            "is_hero": 0,
            "is_followed": 0,
            "website_url": "http://www.trzyzmiany.com",
            "count_missed": 51,
            "count_completed": 150,
            "count_photo_views": 185092,
            "count_photos": 548,
            "count_followers": 365,
            "count_following": 26,
            "count_comments": 118,
            "count_downloads": 15119,
            "created_at": "2014-10-09T23:52:21+0200"
        }
    ],
    "meta": {
        "pagination": {
            "total": 348,
            "count": 10,
            "per_page": 10,
            "current_page": 1,
            "total_pages": 35,
            "links": {
                "next": "https://api.tookapic.com/users/pawelkadysz/following?page=2"
            }
        }
    }
}

Follow user

POST /users/:username/follow
Response
{
    "data": {
        "count_followers": 1
    }
}

Unfollow user

DELETE /users/:username/follow
Response
{
    "data": {
        "count_followers": 0
    }
}

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.