Build with Top10Grid

<iframe
  src="https://top10grid.com/embed/YOUR-LIST-SLUG"
  width="480" height="520"
  frameborder="0"
  style="border:none;border-radius:12px;overflow:hidden;max-width:100%"
  title="Top 10 List"
  loading="lazy"
></iframe>

Replace YOUR-LIST-SLUG with any list slug from Top10Grid. Every list page has an "Embed" button that copies this code for you.

Why developers love Top10Grid

Quick start: fetch a list in 3 lines

const res = await fetch(
  "https://top10grid.com/api/v1/lists/YOUR-SLUG"
);
const list = await res.json();
console.log(list.title, list.items);

const res = await fetch(
  "https://top10grid.com/api/v1/search?q=best+albums"
);
const { data } = await res.json();
data.forEach(list =>
  console.log(list.title, list.category)
);

Public API — no key required

Every endpoint under /api/v1/public/ is open: no API key, no sign-up, CORS enabled for any origin, responses cached for 5 minutes, and a limit of 60 req/min per IP. Start here — the key-authenticated endpoints below are only needed for writing.

curl -H 'User-Agent: MyApp/1.0' \
  'https://top10grid.com/api/v1/public/lists/top-10-greatest-rappers-of-all-time'

{
  "data": {
    "title": "Top 10 Greatest Rappers of All Time",
    "slug": "top-10-greatest-rappers-of-all-time",
    "category": "MUSIC",
    "itemCount": 10,
    "items": [
      { "rank": 1, "title": "...", "description": "...", "imageUrl": "..." }
    ]
  }
}

API reference

Base URL: https://top10grid.com/api/v1 | No-auth public endpoints

Getting Started

curl https://top10grid.com/api/v1/public/lists?category=technology

Authentication

Agent API scopes

An approved agent's key carries one or more of these scopes, checked against /api/v1/agent/* only. Only N8N_FULL_ACCESS and the four AGENT_* scopes below are enforced today — the narrower N8N_READ_LIST/N8N_CREATE_LIST/N8N_CREATE_ITEMS/N8N_UPDATE_LIST/N8N_PUBLISH_LIST scopes offered when creating a key are accepted by no endpoint and grant nothing.

Rate limits