Lordicon API

Beginner's Pick Art & Design / No Auth Required Beginner HTTPS CORS
Free to Use
89 A
Measured Score 0 50 100 Speed 29/30 Consistency 17/20 Security 20/20 Browser access 15/15 Transparency 8/15 TESTED 2026-08-10

Overview

Lordicon provides a library of high-quality animated icons delivered as Lottie JSON files and web components. You can embed animated icons in any webpage by including a script tag and using the lordicon web component — no API calls or keys needed for the free collection. It is ideal for adding polished micro-animations to landing pages or dashboards.

Beginner Tip

Add the Lordicon player script to your HTML, then use the <lord-icon src="URL"> tag to embed an animated icon. Browse free icons and copy their embed code at https://lordicon.com/icons.

Measurement Record

What actually happened when we called this API from our own infrastructure. Every value below was recorded by the request, not copied from the provider's documentation.

Request
GET https://cdn.lordicon.com/osuxyevn.json
Result
HTTP 200 · application/json · 64,205 bytes · compressed
Response time
35 ms (median of 3) · fastest 32 ms
Transport
TLSv1.3 · TLS_AES_128_GCM_SHA256 · certificate issued by Amazon
Browser CORS
Allowed — Access-Control-Allow-Origin: *
Recorded
2026-08-10

Fields Returned

Top-level fields present in the response we captured, with the type and value we actually received.

Field Type Value received
v string 5.8.1
fr integer 60
ip integer 0
op integer 61
w integer 500
h integer 500
nm string 41-home-outline
ddd integer 0
assets array [1 item]
layers array [1 item]
markers array [0 items]

Captured Response

Captured from a real request to https://cdn.lordicon.com/osuxyevn.json on 2026-08-10. Long arrays and nested objects are truncated to keep the shape readable.

JSON Response · Captured
{
  "v": "5.8.1",
  "fr": 60,
  "ip": 0,
  "op": 61,
  "w": 500,
  "h": 500,
  "nm": "41-home-outline",
  "ddd": 0,
  "assets": [
    {
      "id": "comp_0",
      "nm": "in-home",
      "fr": 60,
      "layers": [
        {
          "…": "(15 more fields)"
        }
      ]
    }
  ],
  "layers": [
    {
      "ddd": 0,
      "ind": 1,
      "ty": 4,
      "nm": "watermark",
      "sr": 1,
      "ks": {
        "…": "(5 more fields)"
      },
      "ao": 0,
      "shapes": [
        {
          "…": "(7 more fields)"
        }
      ],
      "ip": 2.5,
      "op": 25,
      "st": 0,
      "bm": 0
    }
  ],
  "markers": []
}

Field Reference

v Lottie format version number
layers Animation layers defining shapes, colors, and keyframes for the icon animation

Implementation Example

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request
const url = "https://cdn.lordicon.com/osuxyevn.json";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

How This API Fails

We deliberately sent this API a broken request and recorded exactly what came back on 2026-08-10. Knowing the shape of an error before you hit it makes error handling much easier to write.

HTTP 404 Requesting a path that does not exist text/html

Returned an HTML error page rather than JSON — worth knowing if your client assumes every response can be parsed as JSON.

Common Errors & Troubleshooting

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

Icon not animating The lordicon player script was not loaded before the web component tag
Add <script src="https://cdn.lordicon.com/lordicon.js"></script> in the head before any lord-icon tags
Icon shows blank box Incorrect src URL or the icon has been moved to the paid tier
Get the current embed URL from the Lordicon website — free icon URLs start with https://cdn.lordicon.com/
Trigger property not working Using an invalid trigger value for the animation
Valid trigger values are: hover, click, loop, loop-on-hover, morph, boomerang — check the docs for the full list

Measured Score Breakdown

Live HTTP request to the API endpoint

Speed 29/30
Consistency 17/20
Security 20/20
Browser access 15/15
Transparency 8/15
Endpoint Response Time 35ms

Fully tested on Aug 10, 2026

Technical Specifications

Auth No Auth
HTTPS REQUIRED
CORS YES
Category Art & Design
Difficulty Beginner
Endpoint last called: 2026-08-10

Related Tags

Similar APIs

View All →