SearchRequest

Parameters for searching Depositphotos stock asset catalog

Stock PhotosImagesVideosVectorsMediaCreative AssetsGenerative AI

Properties

Name	Type	Description
dp_command	string	API command identifier
dp_apikey	string	API key issued to the registered developer
dp_session_id	string	Session identifier (optional for search)
dp_search_query	string	Search query text (at least one of query, user, or username required)
dp_search_user	string	Filter by contributor user ID
dp_search_username	string	Filter by contributor username
dp_search_limit	integer	Number of results per page
dp_search_offset	integer	Offset for pagination
dp_search_photo	integer	Include photographs (1=yes, 0=no)
dp_search_vector	integer	Include vector illustrations (1=yes, 0=no)
dp_search_video	integer	Include video clips (1=yes, 0=no)
dp_search_nudity	integer	Include adult content (1=yes, 0=no)
dp_search_imagesize	string	Minimum image size filter
dp_search_orientation	string	Orientation filter
dp_search_color	string	Dominant color filter (hex without #, e.g. ff0000)
dp_search_sort	string	Sort order for results
dp_lang	string	Language code for localized response content
dp_search_correction	integer	Apply spelling correction to search query (1=yes, 0=no)
dp_affiliate_id	integer	Affiliate partner identifier for tracking
dp_last_update_time	string	Unix timestamp to filter content updated since this time
dp_search_gender	string	Filter by depicted subject gender
dp_search_age	string	Filter by depicted subject age range
dp_search_ethnicity	string	Filter by depicted subject ethnicity
dp_search_people	integer	Filter by number of people depicted
dp_domain	string	Domain for generating preview URLs

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api.depositphotos.com/schema/search-request",
  "title": "SearchRequest",
  "description": "Parameters for searching Depositphotos stock asset catalog",
  "type": "object",
  "required": ["dp_apikey", "dp_command"],
  "properties": {
    "dp_command": {
      "type": "string",
      "enum": ["search"],
      "description": "API command identifier"
    },
    "dp_apikey": {
      "type": "string",
      "description": "API key issued to the registered developer"
    },
    "dp_session_id": {
      "type": "string",
      "description": "Session identifier (optional for search)"
    },
    "dp_search_query": {
      "type": "string",
      "description": "Search query text (at least one of query, user, or username required)"
    },
    "dp_search_user": {
      "type": "string",
      "description": "Filter by contributor user ID"
    },
    "dp_search_username": {
      "type": "string",
      "description": "Filter by contributor username"
    },
    "dp_search_limit": {
      "type": "integer",
      "description": "Number of results per page",
      "minimum": 1,
      "maximum": 200,
      "default": 100
    },
    "dp_search_offset": {
      "type": "integer",
      "description": "Offset for pagination",
      "minimum": 0,
      "default": 0
    },
    "dp_search_photo": {
      "type": "integer",
      "enum": [0, 1],
      "description": "Include photographs (1=yes, 0=no)"
    },
    "dp_search_vector": {
      "type": "integer",
      "enum": [0, 1],
      "description": "Include vector illustrations (1=yes, 0=no)"
    },
    "dp_search_video": {
      "type": "integer",
      "enum": [0, 1],
      "description": "Include video clips (1=yes, 0=no)"
    },
    "dp_search_nudity": {
      "type": "integer",
      "enum": [0, 1],
      "description": "Include adult content (1=yes, 0=no)"
    },
    "dp_search_imagesize": {
      "type": "string",
      "enum": ["s", "m", "l", "xl", "xxl", "xxxl"],
      "description": "Minimum image size filter"
    },
    "dp_search_orientation": {
      "type": "string",
      "enum": ["horizontal", "vertical", "square"],
      "description": "Orientation filter"
    },
    "dp_search_color": {
      "type": "string",
      "description": "Dominant color filter (hex without #, e.g. ff0000)"
    },
    "dp_search_sort": {
      "type": "string",
      "enum": ["best_match", "newest", "popular", "undiscovered"],
      "description": "Sort order for results",
      "default": "best_match"
    },
    "dp_lang": {
      "type": "string",
      "description": "Language code for localized response content"
    },
    "dp_search_correction": {
      "type": "integer",
      "enum": [0, 1],
      "description": "Apply spelling correction to search query (1=yes, 0=no)",
      "default": 1
    },
    "dp_affiliate_id": {
      "type": "integer",
      "description": "Affiliate partner identifier for tracking"
    },
    "dp_last_update_time": {
      "type": "string",
      "description": "Unix timestamp to filter content updated since this time"
    },
    "dp_search_gender": {
      "type": "string",
      "enum": ["male", "female", "both"],
      "description": "Filter by depicted subject gender"
    },
    "dp_search_age": {
      "type": "string",
      "description": "Filter by depicted subject age range"
    },
    "dp_search_ethnicity": {
      "type": "string",
      "description": "Filter by depicted subject ethnicity"
    },
    "dp_search_people": {
      "type": "integer",
      "description": "Filter by number of people depicted"
    },
    "dp_domain": {
      "type": "string",
      "description": "Domain for generating preview URLs"
    }
  },
  "anyOf": [
    { "required": ["dp_search_query"] },
    { "required": ["dp_search_user"] },
    { "required": ["dp_search_username"] }
  ]
}