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

Photos

List photos
Get photo
Get random photo

List photos

List published photos.

GET /photos
Parameters
NameTypeDescription
sortstringCan 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": 96497,
            "title": "Infinity Pool",
            "url": "https://tookapic.com/photos/96497",
            "description": "The infinity pool at the American war memorial at Omaha Beach, Normandy",
            "image_thumb": "https://cdn.tookapic.com/photos/2016/101/2/3/238e456943cb998079e0c560dcf19f75.jpg?w=430&h=430&q=85&sharp=3&s=13e901540d756d4ab11178294d9dc53e",
            "image_large": "https://cdn.tookapic.com/photos/2016/101/2/3/238e456943cb998079e0c560dcf19f75.jpg?q=85&sharp=3&w=730&fit=crop&s=652cf520c126e455db47a5cd93910775",
            "width": 5184,
            "height": 3456,
            "tags": [
                "omaha-beach",
                "american-war-memorial",
                "infinity-pool",
                "clouds",
                "reflection",
                "water",
                "pebbles",
                "theme-calm",
                "afternoon",
                "sunday",
                "october"
            ],
            "count_likes": 14,
            "count_comments": 0,
            "is_premium": 0,
            "is_liked": 0,
            "took_at": "2016-04-11T12:42:20+0000",
            "created_at": "2016-04-11T08:23:39+0200",
            "user": {
                "data": {
                    "id": 6699,
                    "name": "Jon Scott",
                    "username": "jpscott",
                    "avatar": "https://cdn.tookapic.com/avatars/2016/8/d/d/ddc73607011a27d1b18236bdd0b404a2.jpg?w=128&h=128&fit=crop&q=85&sharp=3&s=c56f7d616ba5d89442718db721ee7f46",
                    "level": 7,
                    "is_hero": 0
                }
            },
            "exif": {
                "data": {
                    "width": 5184,
                    "height": 3456,
                    "extension": "jpg",
                    "mime_type": "image/jpeg",
                    "size": 19628159,
                    "exposure_time": "1/6400th",
                    "iso": 400,
                    "focal_length": "34mm",
                    "aperture": "f/4.5",
                    "orientation": 0,
                    "manufacturer": "Canon",
                    "model": "Canon EOS 7D",
                    "dpi": 240
                }
            }
        }
    ],
    "meta": {
        "pagination": {
            "total": 89413,
            "count": 10,
            "per_page": 10,
            "current_page": 1,
            "total_pages": 8942,
            "links": {
                "next": "https://api.tookapic.com/photos?page=2"
            }
        }
    }
}

Get photo

GET /photos/:id
Parameters
NameTypeDescription
includestringFetch additional data using one or more includes separated by comma. Available includes: user, colors, comments
Response
{
    "data": {
        "id": 96497,
        "title": "Infinity Pool",
        "url": "https://tookapic.com/photos/96497",
        "description": "The infinity pool at the American war memorial at Omaha Beach, Normandy",
        "image_thumb": "https://cdn.tookapic.com/photos/2016/101/2/3/238e456943cb998079e0c560dcf19f75.jpg?w=430&h=430&q=85&sharp=3&s=13e901540d756d4ab11178294d9dc53e",
        "image_large": "https://cdn.tookapic.com/photos/2016/101/2/3/238e456943cb998079e0c560dcf19f75.jpg?q=85&sharp=3&w=730&fit=crop&s=652cf520c126e455db47a5cd93910775",
        "width": 5184,
        "height": 3456,
        "tags": [
            "omaha-beach",
            "american-war-memorial",
            "infinity-pool",
            "clouds",
            "reflection",
            "water",
            "pebbles",
            "theme-calm",
            "afternoon",
            "sunday",
            "october"
        ],
        "count_likes": 14,
        "count_comments": 0,
        "is_premium": 0,
        "is_liked": 0,
        "took_at": "2016-04-11T12:42:20+0000",
        "created_at": "2016-04-11T08:23:39+0200"
    }
}

Get random photo

GET /photos/random
Parameters
NameTypeDescription
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": 96497,
        "title": "Infinity Pool",
        "url": "https://tookapic.com/photos/96497",
        "description": "The infinity pool at the American war memorial at Omaha Beach, Normandy",
        "image_thumb": "https://cdn.tookapic.com/photos/2016/101/2/3/238e456943cb998079e0c560dcf19f75.jpg?w=430&h=430&q=85&sharp=3&s=13e901540d756d4ab11178294d9dc53e",
        "image_large": "https://cdn.tookapic.com/photos/2016/101/2/3/238e456943cb998079e0c560dcf19f75.jpg?q=85&sharp=3&w=730&fit=crop&s=652cf520c126e455db47a5cd93910775",
        "width": 5184,
        "height": 3456,
        "tags": [
            "omaha-beach",
            "american-war-memorial",
            "infinity-pool",
            "clouds",
            "reflection",
            "water",
            "pebbles",
            "theme-calm",
            "afternoon",
            "sunday",
            "october"
        ],
        "count_likes": 14,
        "count_comments": 0,
        "is_premium": 0,
        "is_liked": 0,
        "took_at": "2016-04-11T12:42:20+0000",
        "created_at": "2016-04-11T08:23:39+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.