---
title: "Live upvote count for one listing"
method: GET
path: "/api/badge/{toolId}/votes.json"
---

# Live upvote count for one listing

`GET /api/badge/{toolId}/votes.json`

## Request

- Base URL: `https://brofindai.com`
- URL: `https://brofindai.com/api/badge/{toolId}/votes.json`
- Auth: none declared

Public, CORS-open and cacheable for five minutes. The count is merged across every key the listing's votes are filed under, so it matches the number shown on the listing page. Read by third-party badge embeds, including Make Taksh's, which get pasted into pages this project does not control: adding keys is safe, renaming one is not.

## Path parameters

- `toolId` string, required

## Response `200`

The listing and its live count.

- object
  - `toolId` string, required: The listing's slug.
  - `name` string, required
  - `votes` integer, required
  - `url` string, uri: The listing page.
  - `updatedAt` string, date-time, required: When the count was read, not when it last changed.
  - `makeTakshUsername` string, nullable: The owner's Make Taksh handle, if they linked one.

## Other responses

- `404`: No approved listing has that id.

---

[API](https://skmtc.dev/brofindai/apis/bro-find-ai-api.md) · [All operations](https://skmtc.dev/brofindai/apis/bro-find-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/brofindai/apis/bro-find-ai-api/revisions/4e4078821728?raw)