Welcome to this documentation

Get A Topic's Photo

GET

https://api.unsplash.com/topics/{id_or_slug}/photos

Request

Path Params

id_or_slug

string

required

Example:

WdChqlsJN9c

Query Params

page

string

required

Example:

client_id

string

required

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

array of:

string

required

slug

string

required

alternative_slugs

object

required

string

required

string

required

string

required

string

required

string

required

string

required

string

required

string

required

created_at

string

required

updated_at

string

required

promoted_at

string | null

required

width

integer

required

height

integer

required

color

string

required

blur_hash

string

required

description

string | null

required

alt_description

string

required

breadcrumbs

array[string]

required

urls

object

required

raw

string

required

full

string

required

regular

string

required

small

string

required

thumb

string

required

small_s3

string

required

links

object

required

self

string

required

html

string

required

download

string

required

download_location

string

required

likes

integer

required

liked_by_user

boolean

required

current_user_collections

array[string]

required

sponsorship

null

required

topic_submissions

object

required

black-and-white

object

required

architecture-interior

object

optional

street-photography

object

optional

film

object

optional

wallpapers

object

optional

nature

object

optional

animals

object

required

textures-patterns

object

optional

spirituality

object

optional

cool-tones

object

optional

spring

object

optional

sports

object

optional

people

object

optional

health

object

optional

earth-hour

object

optional

travel

object

optional

monochromatic

object

required

asset_type

string

required

user

object

required

string

required

updated_at

string

required

username

string

required

name

string

required

first_name

string

required

last_name

string

required

twitter_username

string | null

required

portfolio_url

string | null

required

bio

string | null

required

location

string | null

required

links

object

required

profile_image

object

required

instagram_username

string

required

total_collections

integer

required

total_likes

integer

required

total_photos

integer

required

total_promoted_photos

integer

required

accepted_tos

boolean

required

for_hire

boolean

required

social

object

required

Example

[
  {
    "id": "string",
    "slug": "string",
    "alternative_slugs": {
      "en": "string",
      "es": "string",
      "ja": "string",
      "fr": "string",
      "it": "string",
      "ko": "string",
      "de": "string",
      "pt": "string"
    },
    "created_at": "string",
    "updated_at": "string",
    "promoted_at": "string",
    "width": 0,
    "height": 0,
    "color": "string",
    "blur_hash": "string",
    "description": "string",
    "alt_description": "string",
    "breadcrumbs": [
      "string"
    ],
    "urls": {
      "raw": "string",
      "full": "string",
      "regular": "string",
      "small": "string",
      "thumb": "string",
      "small_s3": "string"
    },
    "links": {
      "self": "string",
      "html": "string",
      "download": "string",
      "download_location": "string"
    },
    "likes": 0,
    "liked_by_user": true,
    "current_user_collections": [
      "string"
    ],
    "sponsorship": null,
    "topic_submissions": {
      "black-and-white": {
        "status": "string",
        "approved_on": "string"
      },
      "architecture-interior": {
        "status": "string"
      },
      "street-photography": {
        "status": "string"
      },
      "film": {
        "status": "string"
      },
      "wallpapers": {
        "status": "string",
        "approved_on": "string"
      },
      "nature": {
        "status": "string"
      },
      "animals": {
        "status": "string"
      },
      "textures-patterns": {
        "status": "string"
      },
      "spirituality": {
        "status": "string"
      },
      "cool-tones": {
        "status": "string"
      },
      "spring": {
        "status": "string"
      },
      "sports": {
        "status": "string"
      },
      "people": {
        "status": "string",
        "approved_on": "string"
      },
      "health": {
        "status": "string"
      },
      "earth-hour": {
        "status": "string"
      },
      "travel": {
        "status": "string"
      },
      "monochromatic": {
        "status": "string"
      }
    },
    "asset_type": "string",
    "user": {
      "id": "string",
      "updated_at": "string",
      "username": "string",
      "name": "string",
      "first_name": "string",
      "last_name": "string",
      "twitter_username": "string",
      "portfolio_url": "string",
      "bio": "string",
      "location": "string",
      "links": {
        "self": "string",
        "html": "string",
        "photos": "string",
        "likes": "string",
        "portfolio": "string",
        "following": "string",
        "followers": "string"
      },
      "profile_image": {
        "small": "string",
        "medium": "string",
        "large": "string"
      },
      "instagram_username": "string",
      "total_collections": 0,
      "total_likes": 0,
      "total_photos": 0,
      "total_promoted_photos": 0,
      "accepted_tos": true,
      "for_hire": true,
      "social": {
        "instagram_username": "string",
        "portfolio_url": "string",
        "twitter_username": "string",
        "paypal_email": null
      }
    }
  }
]

Modified at 2024-04-08 17:57:23

Get A Topic