Photos

Get a photo

Retrieve the full details of a single photo by its Pexafy photo_id (the identifier returned by every search result).

You get everything search returns, plus extra metadata when available: exact width and height, the original source_image_url, the photographer's full_name and profile url, and the upload date (uploaded_on). The urls object gives you the image in five ready-to-use sizes.

get/api/v1/photos/{photo_id}

Request

  • Base URL: https://api.pexafy.com
  • URL: https://api.pexafy.com/api/v1/photos/{photo_id}
  • Auth: API key in header x-api-key

Path parameters

photo_idstring required

The photo's unique Pexafy identifier (a UUID), as returned by search.

Query parameters

fieldsstring nullable

Comma-separated list to return only the fields you need (e.g. photo_id,urls,attribution). Omit to get everything.

Valid values: photo_id, source_photo_id, image_url, urls, source_image_url, width, height, orientation, blur_hash, color_name, color_hex, source, license_type, photographer_username, photographer_full_name, photographer_url, source_description, description, alt_description, relevance_score, uploaded_on, attribution. There is no photographer field — the credit is carried by photographer_username, photographer_full_name and photographer_url. An unknown name returns 400 INVALID_FIELDS listing the values your plan accepts.

Response

Successful Response

successboolean

Changes

No recorded changes to this operation across all 1 revision of this API.