Filtering uploads

You can supply different parameters to the filter argument to filter the query response accordingly:

query {
allUploads(filter: { type: { eq: image } }) {
url
copyright
exifInfo
}
}

If you specify multiple conditions, they will be combined as if it was a logical AND expression:

query {
allUploads(filter: { type: { eq: image }, resolution: { eq: large }}) {
blurUpThumb
url(imgixParams: { w: 100, h: 100, fit: crop })
}
}

You can also combine AND and OR logical expressions. For example, the following query will return all large images together with any video tagged with "fun":

query {
allUploads(
filter: {
OR: [
{ type: { eq: image }, resolution: { eq: large }},
{ type: { eq: video }, tags: { contains: "fun" }}
]
}
) {
blurUpThumb
url(imgixParams: {w: 100, h: 100, fit: crop})
}
}

Available filters

Filter by type

Search uploads with the specified type
query {
allUploads(filter: { type: { eq: image } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Exclude uploads with the specified type
query {
allUploads(filter: { type: { neq: image } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search uploads with the specified types
query {
allUploads(filter: { type: { in: [image] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search uploads without the specified types
query {
allUploads(filter: { type: { notIn: [image] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}

Filter by inUse

Search uploads that are currently used by some record or not
query {
allUploads(filter: { inUse: { eq: true } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}

Filter by resolution

Search uploads with the specified resolution
query {
allUploads(filter: { resolution: { eq: icon } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Exclude uploads with the specified resolution
query {
allUploads(filter: { resolution: { neq: icon } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search uploads with the specified resolutions
query {
allUploads(filter: { resolution: { in: [icon] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search uploads without the specified resolutions
query {
allUploads(filter: { resolution: { notIn: [icon] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}

Filter by size

Search all assets larger than the specified size (in bytes)
query {
allUploads(filter: { size: { gt: 3 } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search all assets smaller than the specified size (in bytes)
query {
allUploads(filter: { size: { lt: 3 } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search all assets larger or equal to the specified size (in bytes)
query {
allUploads(filter: { size: { gte: 3 } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search all assets larger or equal to the specified size (in bytes)
query {
allUploads(filter: { size: { lte: 3 } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search assets with the specified size (in bytes)
query {
allUploads(filter: { size: { eq: 3 } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search assets that do not have the specified size (in bytes)
query {
allUploads(filter: { size: { neq: 3 } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}

Filter by tags

Filter uploads linked to the specified tag
query {
allUploads(filter: { tags: { contains: "bike" } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Filter uploads linked to all of the specified tags
query {
allUploads(filter: { tags: { allIn: ["bike"] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Filter uploads linked to at least one of the specified tags
query {
allUploads(filter: { tags: { anyIn: ["bike"] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Filter uploads not linked to any of the specified tags
query {
allUploads(filter: { tags: { notIn: ["bike"] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search for uploads with an exact match
query {
allUploads(filter: { tags: { eq: ["bike"] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}

Filter by smartTags

Filter uploads linked to the specified tag
query {
allUploads(filter: { smartTags: { contains: "bike" } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Filter uploads linked to all of the specified tags
query {
allUploads(filter: { smartTags: { allIn: ["bike"] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Filter uploads linked to at least one of the specified tags
query {
allUploads(filter: { smartTags: { anyIn: ["bike"] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Filter uploads not linked to any of the specified tags
query {
allUploads(filter: { smartTags: { notIn: ["bike"] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search for uploads with an exact match
query {
allUploads(filter: { smartTags: { eq: ["bike"] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}

Filter by colors

Filter uploads that have the specified colors
query {
allUploads(filter: { colors: { contains: red } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Filter uploads that have all of the specified colors
query {
allUploads(filter: { colors: { allIn: [red] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Filter uploads that have at least one of the specified colors
query {
allUploads(filter: { colors: { anyIn: [red] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Filter uploads that do not have any of the specified colors
query {
allUploads(filter: { colors: { notIn: [red] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search for uploads with an exact match
query {
allUploads(filter: { colors: { eq: [red] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}

Filter by orientation

Search uploads with the specified orientation
query {
allUploads(filter: { orientation: { eq: landscape } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Exclude uploads with the specified orientation
query {
allUploads(filter: { orientation: { neq: landscape } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}

Filter by id

Search the asset with the specified ID
query {
allUploads(filter: { id: { eq: "123" } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Exclude the asset with the specified ID
query {
allUploads(filter: { id: { neq: "123" } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search assets with the specified IDs
query {
allUploads(filter: { id: { in: ["123"] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search assets that do not have the specified IDs
query {
allUploads(filter: { id: { notIn: ["123"] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}

Filter by mimeType

Filter uploads based on a regular expression
query {
allUploads(
filter: {
mimeType: {
matches: { pattern: "bi(cycl|k)e", caseSensitive: false }
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Exclude uploads based on a regular expression
query {
allUploads(
filter: {
mimeType: {
notMatches: { pattern: "bi(cycl|k)e", caseSensitive: false }
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search the asset with the specified mime type
query {
allUploads(filter: { mimeType: { eq: "bike" } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Exclude the asset with the specified mime type
query {
allUploads(filter: { mimeType: { neq: "bike" } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search assets with the specified mime types
query {
allUploads(filter: { mimeType: { in: ["bike"] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search assets that do not have the specified mime types
query {
allUploads(filter: { mimeType: { notIn: ["bike"] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}

Filter by format

Search the asset with the specified format
query {
allUploads(filter: { format: { eq: "bike" } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Exclude the asset with the specified format
query {
allUploads(filter: { format: { neq: "bike" } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search assets with the specified formats
query {
allUploads(filter: { format: { in: ["bike"] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search assets that do not have the specified formats
query {
allUploads(filter: { format: { notIn: ["bike"] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}

Filter by height

Search all assets larger than the specified height
query {
allUploads(filter: { height: { gt: 3 } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search all assets smaller than the specified height
query {
allUploads(filter: { height: { lt: 3 } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search all assets larger or equal to the specified height
query {
allUploads(filter: { height: { gte: 3 } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search all assets larger or equal to the specified height
query {
allUploads(filter: { height: { lte: 3 } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search assets with the specified height
query {
allUploads(filter: { height: { eq: 3 } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search assets that do not have the specified height
query {
allUploads(filter: { height: { neq: 3 } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}

Filter by width

Search all assets larger than the specified width
query {
allUploads(filter: { width: { gt: 3 } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search all assets smaller than the specified width
query {
allUploads(filter: { width: { lt: 3 } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search all assets larger or equal to the specified width
query {
allUploads(filter: { width: { gte: 3 } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search all assets larger or equal to the specified width
query {
allUploads(filter: { width: { lte: 3 } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search assets with the specified width
query {
allUploads(filter: { width: { eq: 3 } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search assets that do not have the specified width
query {
allUploads(filter: { width: { neq: 3 } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}

Filter by alt

Filter uploads based on a regular expression
query {
allUploads(
filter: {
alt: {
matches: { pattern: "bi(cycl|k)e", caseSensitive: false }
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Exclude uploads based on a regular expression
query {
allUploads(
filter: {
alt: {
notMatches: { pattern: "bi(cycl|k)e", caseSensitive: false }
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search the uploads with the specified alt
query {
allUploads(filter: { alt: { eq: "bike" } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Exclude the uploads with the specified alt
query {
allUploads(filter: { alt: { neq: "bike" } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search uploads with the specified values as default alt
query {
allUploads(filter: { alt: { in: ["bike"] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search uploads that do not have the specified values as default alt
query {
allUploads(filter: { alt: { notIn: ["bike"] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Filter uploads with the specified field defined (i.e. with any value) or not
query {
allUploads(filter: { alt: { exists: true } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}

Filter by title

Filter uploads based on a regular expression
query {
allUploads(
filter: {
title: {
matches: { pattern: "bi(cycl|k)e", caseSensitive: false }
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Exclude uploads based on a regular expression
query {
allUploads(
filter: {
title: {
notMatches: { pattern: "bi(cycl|k)e", caseSensitive: false }
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search the asset with the specified title
query {
allUploads(filter: { title: { eq: "bike" } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Exclude the asset with the specified title
query {
allUploads(filter: { title: { neq: "bike" } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search assets with the specified as default title
query {
allUploads(filter: { title: { in: ["bike"] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search assets that do not have the specified as default title
query {
allUploads(filter: { title: { notIn: ["bike"] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Filter assets with the specified field defined (i.e. with any value) or not
query {
allUploads(filter: { title: { exists: true } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}

Filter by notes

Filter uploads based on a regular expression
query {
allUploads(
filter: {
notes: {
matches: { pattern: "bi(cycl|k)e", caseSensitive: false }
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Exclude uploads based on a regular expression
query {
allUploads(
filter: {
notes: {
notMatches: { pattern: "bi(cycl|k)e", caseSensitive: false }
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Filter records with the specified field defined (i.e. with any value) or not
query {
allUploads(filter: { notes: { exists: true } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}

Filter by md5

Search the asset with the specified MD5
query {
allUploads(filter: { md5: { eq: "bike" } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Exclude the asset with the specified MD5
query {
allUploads(filter: { md5: { neq: "bike" } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search assets with the specified MD5s
query {
allUploads(filter: { md5: { in: ["bike"] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Search assets that do not have the specified MD5s
query {
allUploads(filter: { md5: { notIn: ["bike"] } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}

Filter by author

Filter uploads based on a regular expression
query {
allUploads(
filter: {
author: {
matches: { pattern: "bi(cycl|k)e", caseSensitive: false }
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Exclude uploads based on a regular expression
query {
allUploads(
filter: {
author: {
notMatches: { pattern: "bi(cycl|k)e", caseSensitive: false }
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Filter uploads with the specified field defined (i.e. with any value) or not
query {
allUploads(filter: { author: { exists: true } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}

Filter by copyright

Filter uploads based on a regular expression
query {
allUploads(
filter: {
copyright: {
matches: { pattern: "bi(cycl|k)e", caseSensitive: false }
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Exclude uploads based on a regular expression
query {
allUploads(
filter: {
copyright: {
notMatches: { pattern: "bi(cycl|k)e", caseSensitive: false }
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Filter records with the specified field defined (i.e. with any value) or not
query {
allUploads(filter: { copyright: { exists: true } }) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}

Filter by basename

Filter uploads based on a regular expression
query {
allUploads(
filter: {
basename: {
matches: { pattern: "bi(cycl|k)e", caseSensitive: false }
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Exclude uploads based on a regular expression
query {
allUploads(
filter: {
basename: {
notMatches: { pattern: "bi(cycl|k)e", caseSensitive: false }
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}

Filter by filename

Filter uploads based on a regular expression
query {
allUploads(
filter: {
filename: {
matches: { pattern: "bi(cycl|k)e", caseSensitive: false }
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Exclude uploads based on a regular expression
query {
allUploads(
filter: {
filename: {
notMatches: { pattern: "bi(cycl|k)e", caseSensitive: false }
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}

Filter by _createdAt

Search for uploads with an exact match
query {
allUploads(
filter: {
_createdAt: {
eq: "2018-02-13T14:30:00+00:00"
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Exclude uploads with an exact match
query {
allUploads(
filter: {
_createdAt: {
neq: "2018-02-13T14:30:00+00:00"
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Filter uploads with a value that's less than the one specified
query {
allUploads(
filter: {
_createdAt: {
lt: "2018-02-13T14:30:00+00:00"
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Filter uploads with a value that's less or equal than the one specified
query {
allUploads(
filter: {
_createdAt: {
lte: "2018-02-13T14:30:00+00:00"
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Filter uploads with a value that's strictly greater than the one specified
query {
allUploads(
filter: {
_createdAt: {
gt: "2018-02-13T14:30:00+00:00"
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Filter uploads with a value that's greater than or equal to the one specified
query {
allUploads(
filter: {
_createdAt: {
gte: "2018-02-13T14:30:00+00:00"
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}

Filter by _updatedAt

Search for uploads with an exact match
query {
allUploads(
filter: {
_updatedAt: {
eq: "2018-02-13T14:30:00+00:00"
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Exclude uploads with an exact match
query {
allUploads(
filter: {
_updatedAt: {
neq: "2018-02-13T14:30:00+00:00"
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Filter uploads with a value that's less than the one specified
query {
allUploads(
filter: {
_updatedAt: {
lt: "2018-02-13T14:30:00+00:00"
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Filter uploads with a value that's less or equal than the one specified
query {
allUploads(
filter: {
_updatedAt: {
lte: "2018-02-13T14:30:00+00:00"
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Filter uploads with a value that's strictly greater than the one specified
query {
allUploads(
filter: {
_updatedAt: {
gt: "2018-02-13T14:30:00+00:00"
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}
Filter uploads with a value that's greater than or equal to the one specified
query {
allUploads(
filter: {
_updatedAt: {
gte: "2018-02-13T14:30:00+00:00"
}
}
) {
blurUpThumb
url(imgixParams: { auto: format, w: 100, h: 100, fit: crop })
}
}