Skip to main content
GET
/
v1
/
icons
/
{id}
Get detailed icon information by ID
curl --request GET \
  --url https://api.freepik.com/v1/icons/{id} \
  --header 'x-freepik-api-key: <api-key>'
{
  "title": "example-0"
}

Documentation Index

Fetch the complete documentation index at: https://docs.freepik.com/llms.txt

Use this file to discover all available pages before exploring further.

Fetch a specific icon by ID. See the Icons API overview for authentication and usage guidance.

Authorizations

​
x-freepik-api-key
string
header
required

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.

Path Parameters

​
id
integer
required

Icon resource ID

Response

OK

​
data
object
Example:
{
  "free_svg": true,
  "created": "2023-03-07T23:05:26.000Z",
  "author": {
    "assets": 0,
    "name": "John Doe",
    "id": 2147483647,
    "avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
    "slug": "merry-christmas"
  },
  "name": "a woman reads a book in a tablet sits in the luxurious back of the library",
  "style": {
    "name": "Meticulous Yellow shadow",
    "id": 50
  },
  "id": 52912,
  "family": { "total": 1200, "name": "Outline", "id": 1 },
  "thumbnails": [
    {
      "width": 512,
      "url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
      "height": 512
    },
    {
      "width": 512,
      "url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
      "height": 512
    }
  ],
  "slug": "a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library",
  "related": {
    "visual_concept": [
      {
        "free_svg": true,
        "created": "2023-03-07T23:05:26.000Z",
        "author": {
          "assets": 0,
          "name": "John Doe",
          "id": 2147483647,
          "avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
          "slug": "merry-christmas"
        },
        "name": "a woman reads a book in a tablet sits in the luxurious back of the library",
        "style": {
          "name": "Meticulous Yellow shadow",
          "id": 50
        },
        "id": 52912,
        "family": { "total": 1200, "name": "Outline", "id": 1 },
        "thumbnails": [
          {
            "width": 512,
            "url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
            "height": 512
          },
          {
            "width": 512,
            "url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
            "height": 512
          }
        ],
        "slug": "a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library"
      },
      {
        "free_svg": true,
        "created": "2023-03-07T23:05:26.000Z",
        "author": {
          "assets": 0,
          "name": "John Doe",
          "id": 2147483647,
          "avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
          "slug": "merry-christmas"
        },
        "name": "a woman reads a book in a tablet sits in the luxurious back of the library",
        "style": {
          "name": "Meticulous Yellow shadow",
          "id": 50
        },
        "id": 52912,
        "family": { "total": 1200, "name": "Outline", "id": 1 },
        "thumbnails": [
          {
            "width": 512,
            "url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
            "height": 512
          },
          {
            "width": 512,
            "url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
            "height": 512
          }
        ],
        "slug": "a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library"
      }
    ],
    "style": [
      {
        "free_svg": true,
        "created": "2023-03-07T23:05:26.000Z",
        "author": {
          "assets": 0,
          "name": "John Doe",
          "id": 2147483647,
          "avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
          "slug": "merry-christmas"
        },
        "name": "a woman reads a book in a tablet sits in the luxurious back of the library",
        "style": {
          "name": "Meticulous Yellow shadow",
          "id": 50
        },
        "id": 52912,
        "family": { "total": 1200, "name": "Outline", "id": 1 },
        "thumbnails": [
          {
            "width": 512,
            "url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
            "height": 512
          },
          {
            "width": 512,
            "url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
            "height": 512
          }
        ],
        "slug": "a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library"
      },
      {
        "free_svg": true,
        "created": "2023-03-07T23:05:26.000Z",
        "author": {
          "assets": 0,
          "name": "John Doe",
          "id": 2147483647,
          "avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
          "slug": "merry-christmas"
        },
        "name": "a woman reads a book in a tablet sits in the luxurious back of the library",
        "style": {
          "name": "Meticulous Yellow shadow",
          "id": 50
        },
        "id": 52912,
        "family": { "total": 1200, "name": "Outline", "id": 1 },
        "thumbnails": [
          {
            "width": 512,
            "url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
            "height": 512
          },
          {
            "width": 512,
            "url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
            "height": 512
          }
        ],
        "slug": "a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library"
      }
    ],
    "variants": [
      {
        "free_svg": true,
        "created": "2023-03-07T23:05:26.000Z",
        "author": {
          "assets": 0,
          "name": "John Doe",
          "id": 2147483647,
          "avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
          "slug": "merry-christmas"
        },
        "name": "a woman reads a book in a tablet sits in the luxurious back of the library",
        "style": {
          "name": "Meticulous Yellow shadow",
          "id": 50
        },
        "id": 52912,
        "family": { "total": 1200, "name": "Outline", "id": 1 },
        "thumbnails": [
          {
            "width": 512,
            "url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
            "height": 512
          },
          {
            "width": 512,
            "url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
            "height": 512
          }
        ],
        "slug": "a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library"
      },
      {
        "free_svg": true,
        "created": "2023-03-07T23:05:26.000Z",
        "author": {
          "assets": 0,
          "name": "John Doe",
          "id": 2147483647,
          "avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
          "slug": "merry-christmas"
        },
        "name": "a woman reads a book in a tablet sits in the luxurious back of the library",
        "style": {
          "name": "Meticulous Yellow shadow",
          "id": 50
        },
        "id": 52912,
        "family": { "total": 1200, "name": "Outline", "id": 1 },
        "thumbnails": [
          {
            "width": 512,
            "url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
            "height": 512
          },
          {
            "width": 512,
            "url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
            "height": 512
          }
        ],
        "slug": "a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library"
      }
    ]
  },
  "tags": [
    { "name": "Dog", "slug": "dog" },
    { "name": "Dog", "slug": "dog" }
  ]
}