Escaping reserved charactersIf you need to use any of the characters which function as operators in your query itself (and not as operators), then you should escape them with a leading backslash. For instance, to search for (1+1)=2, you would need to write your query as (1+1)=2.
The reserved characters are:
+ - = && || > < ! ( ) { } [ ] ^ " ~ * ? : \ /Failing to escape these special characters correctly could lead to a syntax error which prevents your query from running.
The filters are divided into 4 groups:
- Common Filters - The fields that are common for all protocols.
- iptc Filters - IPTC protocol-specific fields.
- xmp Filters - XMP protocol-specific fields.
- exif Filters - EXIF protocol-specific fields.
Below are details on the common filters, and other filters can be used with the following method:
[protocol name in small letters].[field name]:[value]
Example: exif.software:Adobe*
Common Filters
| Parameter | Description | Example |
|---|---|---|
| label | Filter by object labels identified in the image. For a complete list refer to: Image Labels] "text" as a label indicates that the image contains text | label:person |
| width | Filter the image width | width:>500 ( Default unit is pixels) |
| height | Filter the image height | height:>250 ( Default unit is pixels) |
| description | Filter the textual description of the image. It may include camera characteristics. | description:sky |
| creation_date | The ts (timestamp) parameter returns results that were crawled after this timestamp (ts is a Unix timestamp in milliseconds). Here is a Timestamp/Date converter When not specified the default is the past 3 days.
| creation_date:>1546293600000 Return Images created after Tuesday, January 1, 2019 12:00:00 AM GMT+02:00 |
| modify_date | The ts (timestamp) parameter returns results that were crawled after this timestamp (ts is a Unix timestamp in milliseconds). Here is a Timestamp/Date converter When not specified the default is the past 3 days.
| modify_date:>1546293600000 Return Images changed after Tuesday, January 1, 2019 12:00:00 AM GMT+02:00 |
| bits_pixel | Filter by the number of bits compressed per pixel | bits_pixel:>0 |
| compression | Filter by the image compression algorithm. | Filter by no compression. compression:1 |
| mime_type | Filter by list of image types. See this reference for a list of possible values: Common MIME types | Filter by jpg mime type images. mime_type:jpeg |
| endianness | Filter by storage format: big endian or little endian | Filter by images that stored in "big endian" format. endianness:"Big endian" |
| artist | Filter by the name of the image owner, such as:
| artist:Picasa |
| copyright | Filter by copyright value | copyright:"x-default" |
| related_docs | ||
| crawled | The ts (timestamp) parameter returns results that were crawled after this timestamp (ts is a Unix timestamp in milliseconds). Here is a Timestamp/Date converter When not specified the default is the past 3 days. | Return Image records crawled after Thu, 30 Mar 2017 09:16:28 GMT: crawled:>1490865388000 |