---
ref: tool:github/list-stargazers
name: List stargazers
company: company:github
workflows: [workflow:github-stargazers-outbound]
access: [api]
tags: [capability:find-prospects, category:code, has:api]
docs: https://docs.github.com/en/rest/activity/starring#list-stargazers
updated: 2026-09-29
---

# List stargazers

Returns the users who starred a repository, optionally with when each star was created.

Note: Send `Accept: application/vnd.github.star+json` to get each star's `starred_at` timestamp.

## Set up

Use the first option your agent supports.

### API (official)

- Base URL: https://api.github.com
- Endpoint: `GET /repos/{owner}/{repo}/stargazers`
- Auth: send the header `Authorization: Bearer $GITHUB_TOKEN`
- Get a key: https://github.com/settings/personal-access-tokens/new
- Docs: https://docs.github.com/en/rest

Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.

## Rules

- Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
- Never print API keys.