shieldcn
Docs
Studio
Showcase
Sponsor
jal-co/shieldcn561
shieldcn

Member of the Vercel OSS Program

Analytics provided by OpenPanel

Monitored by Sentry

Powered by Neon.

Community

GitHubjal-co/uiStatsllms.txtPrivacyContact

Product

DocumentationAPI ReferenceToken PoolGeneratorAgent Skill

inspired by shields.io and badgen.net

Made with in by Justin Levine

shieldcn
Docs
Studio
Showcase
Sponsor
jal-co/shieldcn561

Search documentation

Search all badge providers, guides, and reference docs.

Getting Started

IntroductionREADME StudioCLIAgent SkillNewSelf-HostingAPI ReferenceToken PoolSponsor

Badges

Badge GroupStatic BadgeDynamic JSONHTTPS Endpoint
DiscordNBABlueskyX / TwitterYouTubeMastodonLemmyHacker NewsTwitchDiscourseMatrixStack Exchange

Charts

Overview

Headers

OverviewGenerator

Sponsors

OverviewGenerator

Contributors

OverviewGenerator
shieldcn

Member of the Vercel OSS Program

Analytics provided by OpenPanel

Monitored by Sentry

Powered by Neon.

Community

GitHubjal-co/uiStatsllms.txtPrivacyContact

Product

DocumentationAPI ReferenceToken PoolGeneratorAgent Skill

inspired by shields.io and badgen.net

Made with in by Justin Levine

X / Twitter

Badges for X profiles — follow and mention CTA badges with the X icon.

Static CTA badges for X profiles. No API token required.

Follow (branded)
Follow (secondary)
Mention (outline)
Default (follow)

Available badges

BadgeEndpointDescription
Follow/x/follow/{username}"follow @username" CTA linking to profile
Mention/x/mention/{username}"@username" CTA linking to tweet intent
Default/x/{username}Same as follow
GET/x/follow/:username.svg

Path Parameters

required

X username without @.

<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/x/follow/jal_co.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/x/follow/jal_co.svg?mode=light"></picture>
badge preview

Quick examples

![follow](https://shieldcn.dev/x/follow/jal_co.svg?variant=branded)
![mention](https://shieldcn.dev/x/mention/jal_co.svg?variant=outline)
![follow](https://shieldcn.dev/x/jal_co.svg?variant=secondary)

Why static?

X's API requires a $200/mo Basic plan for any read access — even public profile data like follower counts. These badges skip the API entirely and render as static follow/mention CTAs with the X icon. No token, no cost, no rate limits.

Data source

No external API calls. Badges are rendered statically using the username from the URL path.

On This Page

Available badgesQuick examplesWhy static?Data source