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, comments, exif, palette
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, comments, exif, palette
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, comments, exif, palette
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.