Site Badges

Add a ToolPix-powered badge to your website to show your tool rank, score, and category. Fetched live from our API.

What is a Site Badge?

A Site Badge is a dynamic widget you embed on your website. It shows your ToolPix rank, score, and category — updated daily. Visitors can click it to view your full profile on ToolPix.

Badges are verified by ToolPix once the badge snippet is detected on your site.

Setup in 2 Steps

Go to Console → Site Badges → "Add Site". Enter your domain and category. We'll create your badge profile.

Add the Snippet

Copy the badge snippet and paste it anywhere on your website. The badge loads from our CDN and updates automatically.

Badge Snippet

Paste this anywhere in your HTML (replace your-domain.com with your actual domain):

<a href="https://toolpix.dev/sites/your-domain.com" target="_blank" rel="noopener">
  <img
    src="https://toolpix.dev/api/badge/your-domain.com/svg"
    alt="ToolPix Badge"
    height="28"
  />
</a>

JSON API

Fetch badge data as JSON to build your own custom badge UI:

GEThttps://toolpix.dev/api/badge/{domain}

No authentication required. Responses are cached for 24 hours.

curl https://toolpix.dev/api/badge/example.com

Response:

{
  "domain": "example.com",
  "name": "Example Site",
  "rank": 42,
  "score": 87,
  "category": "Developer Tools",
  "badgeViews": 1204,
  "verified": true
}

Response Fields

Field	Type	Description
`domain`	string	Registered domain
`name`	string	Display name of the site
`rank`	number	Current ToolPix rank position
`score`	number	Score out of 100
`category`	string	Site category (e.g. Developer Tools)
`badgeViews`	number	Total times this badge was viewed
`verified`	boolean	Whether the badge was detected on the site

Error Codes

400Invalid or missing domain

404Badge not found or not active

Add your site badge

Go to Console — Badges →