GET
/
v1
/
resources
{
  "data": [
    {
      "id": 770011,
      "title": "Sports car",
      "url": "https://www.freepik.com/free-icon/sports-car_770011.htm",
      "filename": "sports-car.zip",
      "licenses": [
        {
          "type": "freemium",
          "url": "https://www.freepik.com/profile/license/pdf/770011?lang=en"
        }
      ],
      "products": [],
      "meta": {
        "published_at": "2022-01-14T20:45:28.000Z",
        "is_new": true,
        "available_formats": {
          "jpg": {
            "total": 2,
            "items": [
              {
                "id": 444,
                "name": "Sports car",
                "colorspace": "RGB",
                "size": 100
              },
              {
                "id": 555,
                "name": "Sports car",
                "colorspace": "RGB",
                "size": 200
              }
            ]
          }
        }
      },
      "image": {
        "type": "photo",
        "orientation": "square",
        "source": {
          "url": "https://img.flaticon.com/icons/png/512/67/67994.png",
          "key": "large",
          "size": "128x128"
        }
      },
      "related": {
        "serie": [],
        "others": [],
        "keywords": []
      },
      "stats": {
        "downloads": 52527,
        "likes": 137
      },
      "author": {
        "id": 744082,
        "name": "flaticon",
        "avatar": "https://avatar.cdnpk.net/744082.jpg",
        "slug": "flaticon"
      }
    },
    {
      "id": 1540200,
      "title": "Grey car logo collection",
      "url": "https://www.freepik.com/free-vector/grey-car-logo-collection_1540200.htm",
      "filename": "grey-car-logo-collection.zip",
      "licenses": [
        {
          "type": "freemium",
          "url": "https://www.freepik.com/profile/license/pdf/1540200?lang=en"
        }
      ],
      "products": [
        {
          "type": "essential",
          "url": "https://www.freepik.com/profile/license/pdf/1540200?lang=en"
        }
      ],
      "meta": {
        "published_at": "2022-01-14T16:06:23.000Z",
        "is_new": true,
        "available_formats": {
          "jpg": {
            "total": 2,
            "items": [
              {
                "id": 444,
                "size": 100
              },
              {
                "id": 555,
                "size": 200
              }
            ]
          }
        }
      },
      "image": {
        "type": "vector",
        "orientation": "square",
        "source": {
          "url": "https://",
          "key": "large",
          "size": "626x626"
        }
      },
      "related": {
        "serie": [],
        "others": [],
        "keywords": []
      },
      "stats": {
        "downloads": 1639,
        "likes": 18
      },
      "author": {
        "id": 23,
        "name": "freepik",
        "avatar": "https://avatar.cdnpk.net/23.jpg",
        "slug": "freepik"
      }
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 32,
    "per_page": 2,
    "total": 63
  }
}

Authorizations

x-freepik-api-key
string
headerrequired

Your Freepik API key. Required for authentication. Learn how to obtain an API key

Headers

Accept-Language
string

Specifies the search query language using the ISO 639-1 (2-letter language code) and the ISO 3166-1 (2-letter country code) for language variants. The API will use "en-US" as a default language for processing if a code is not provided, or does not exist.

Query Parameters

page
integer

Page number. It must be greater than 0 and less than or equal to 100.

limit
integer

Limit results per page. It must be greater than 0.

order
enum<string>
default: relevance

Specifies the order in which search results are returned. The available options allow you to prioritize results based on different criteria:

  • relevance: Prioritizes results that are most relevant to the search query.
  • recent: Sorts results by the most recent updates.
Available options:
relevance,
recent
term
string

Search term. If only term comes, it is searched for term, if only slug comes, it is searched for slug and if both come, it is searched for slug

filters[orientation][landscape]
number
default: 0

Filters results to only include resources with a landscape orientation. Set to 1 to enable, 0 to disable.

filters[orientation][portrait]
number
default: 0

Filters results to only include resources with a portrait orientation. Set to 1 to enable, 0 to disable.

filters[orientation][square]
number
default: 0

Filters results to only include resources with a square orientation. Set to 1 to enable, 0 to disable.

filters[orientation][panoramic]
number
default: 0

Filters results to only include resources with a panoramic orientation. Set to 1 to enable, 0 to disable.

filters[content_type][photo]
number
default: 0

Filters results to only include resources of type photo. Set to 1 to enable, 0 to disable.

filters[content_type][psd]
number
default: 0

Filters results to only include resources of type PSD (Photoshop Document). Set to 1 to enable, 0 to disable.

filters[content_type][vector]
number
default: 0

Filters results to only include resources of type vector. Set to 1 to enable, 0 to disable.

filters[license][freemium]
number
default: 0

Filters results to only include resources with a freemium license. Set to 1 to enable, 0 to disable.

filters[license][premium]
number
default: 0

Filters results to only include resources with a premium license. Set to 1 to enable, 0 to disable.

filters[people][include]
number
default: 0

Filter by included people

filters[people][exclude]
number
default: 0

Filter by excluded people

filters[people][number]
enum<string>

Filter by number of people

Available options:
1,
2,
3,
more_than_three
filters[people][age]
enum<string>

Filter by age of the people

Available options:
infant,
child,
teen,
young-adult,
adult,
senior,
elder
filters[people][gender]
enum<string>

Filter by gender of the people

Available options:
male,
female
filters[people][ethnicity]
enum<string>

Filter by ethnicity of the people

Available options:
south-asian,
middle-eastern,
east-asian,
black,
hispanic,
indian,
white,
multiracial
filters[period]
enum<string>

Filters results based on the time period in which the resources were added.

Available options:
last-month,
last-quarter,
last-semester,
last-year
filters[color]
enum<string>

Filters results by the predominant color in the resources.

Available options:
black,
blue,
gray,
green,
orange,
red,
white,
yellow,
purple,
cyan,
pink
filters[author]
number
default: 0

Filters results to include resources by a specific author, identified by their author ID.

filters[ai-generated][excluded]
number
default: 0

Excludes AI-generated images from the results. Set to 1 to exclude, 0 to include.

filters[ai-generated][only]
number
default: 0

Filters results to only include AI-generated images. Set to 1 to include only AI-generated images, 0 to include all images.

filters[vector][type]
enum<string>

File type for vectors

Available options:
jpg,
ai,
eps,
svg
filters[vector][style]
enum<string>

Style type for vectors, ignored if content_type exists and it is not vector

Available options:
watercolor,
flat,
cartoon,
geometric,
gradient,
isometric,
3d,
hand-drawn
filters[psd][type]
enum<string>

File type for psd

Available options:
jpg,
psd
filters[ids]
string

Filter by list of ids. This filter is incompatible with any other filters. In case of using this filter, the rest of filters will be ignored.

Response

200 - application/json
data
object[]

A list of resources.

meta
object

Metainformation about pagination

Was this page helpful?

Get the status of all upscaling tasksGet the detail of a resource (psd, vector or photo)