List Tags

GET/api/v1/content/tags

Overview

Returns all tags for the resolved client site, including the number of published posts using each tag. Useful for building tag clouds, filters, and navigation.

Authentication

info

No authentication required - Client is resolved from the X-Content-Domain header, which the Cloudflare Worker sets automatically based on the request domain.

Headers

Header	Type	Required	Description
X-Content-Domain	string	Yes	The domain used to resolve the client tenant. Automatically set by the CF Worker; set manually for external frontend integrations.

Response

tagsarray

Array of tag objects

tags[].idstring (UUID)

Unique tag identifier

tags[].namestring

Tag display name

tags[].slugstring

URL-friendly slug

tags[].descriptionstring | null

Optional tag description

tags[].post_countinteger

Number of published posts using this tag

totalinteger

Total number of tags

Example Request

cURL

curl -s "https://spideriq.ai/api/v1/content/tags" \
  -H "X-Content-Domain: your-domain.com"

Python

import requests

resp = requests.get(
    "https://spideriq.ai/api/v1/content/tags",
    headers={"X-Content-Domain": "your-domain.com"}
)
data = resp.json()

for tag in sorted(data["tags"], key=lambda t: t["post_count"], reverse=True):
    print(f"{tag['name']}: {tag['post_count']} posts")

JavaScript

const resp = await fetch(
  "https://spideriq.ai/api/v1/content/tags",
  { headers: { "X-Content-Domain": "your-domain.com" } }
);
const data = await resp.json();

data.tags
  .sort((a, b) => b.post_count - a.post_count)
  .forEach(tag => console.log(`${tag.name}: ${tag.post_count} posts`));

Example Response

{
  "tags": [
    {
      "id": "tag-001-uuid",
      "name": "SEO",
      "slug": "seo",
      "description": "Search engine optimization tips and tools",
      "post_count": 12
    },
    {
      "id": "tag-002-uuid",
      "name": "Google Maps",
      "slug": "google-maps",
      "description": "Extracting data from Google Maps",
      "post_count": 8
    },
    {
      "id": "tag-003-uuid",
      "name": "Email Verification",
      "slug": "email-verification",
      "description": null,
      "post_count": 5
    }
  ],
  "total": 3
}

Status Codes

Status Code	Meaning	Description
200	OK	Tags returned successfully

Related Endpoints

📋

List Posts

List posts (filter by tag)

folder

List Categories

List all categories

🔎

Search Posts

Search across posts

👥

List Authors

List active authors