Simple impression counter? #11229

Activity

1. 0wwafa

   added

   service-badgeNew or updated service badgeNew or updated service badge

   on Jul 23, 2025
2. jNullj commented on Jul 26, 2025

   

   jNullj

   on Jul 26, 2025

   Member

   More actions

   While an interesting idea, I'm not sure it best aligns with project goals.
   As stated in our contribution guideline badges should present information useful to developers from a documented API.

   While some developers might be interested in such counters, there are a few problems here:

   1. Information is not directly related to developers work.
   2. Shields depends on an API to provide said info.
   3. Shields is not built to hold information over time, like the number of requests of an image.

   Could you provide info regarding benefits of the badge and API source that it might use?
3. 0wwafa commented on Jul 27, 2025

   

   0wwafa

   on Jul 27, 2025

   Last edited by 0wwafa

   Author

   More actions

   Could you provide info regarding benefits of the badge and API source that it might use?

   Benefits: let's assume I have a badge that tells me how many downloads I had.
   It would be useful to know how many people visited the "repository main page" (where the readme is displayed.
   To have a comparison.
   About the data source, github should have an api for that..

   Source: https://github.com/[USER]/[REPO]/graphs/traffic?partial=top_lists

   https://github.com/badges/shields/graphs/traffic?partial=top_lists

   or:

   https://docs.github.com/en/rest/orgs/api-insights?apiVersion=2022-11-28#get-summary-stats
4. jNullj commented on Jul 27, 2025

   

   jNullj

   on Jul 27, 2025

   Member

   More actions

   Thank you for the data sources, but there are some limitations here that might render them not suitable for this use case.

   Let me start by saying api-insights is not relevant here, as it tracks api usage and not user page views.

   regarding the traffic endpoint:

   • This view (and API) shows repository page views and unique visitors, as well as referrers and popular content.
   • These metrics reflect how many times the GitHub repo itself was visited in a browser, potentially including times when a badge in the README was visible.
   • Limitation: It does not count badge impressions outside the GitHub repository (e.g., when badges are embedded on blogs or other sites). It also only covers the last 14 days and requires repo admin permissions to access.

   So in short:

   • api-insights is not relevant here
   • traffic endpoint requires permissions and is very limited in what it provides.
5. heliocarlitos commented on Feb 15, 2026

   

   heliocarlitos

   on Feb 15, 2026 · Hidden as spam

   show commentMore actions
6. PyvesB commented on Jun 20, 2026

   

   PyvesB

   on Jun 20, 2026

   Member

   More actions

   @heliocarlitos feel free to add a reference to your project on https://github.com/badges/awesome-badges :)

   ❤️React with ❤️1Reacted by Hélio Carlitos
7. heliocarlitos commented on Jun 21, 2026

   

   heliocarlitos

   on Jun 21, 2026

   Last edited by heliocarlitos

   More actions

   @PyvesB
   Great. Liked it! I'm going to take a closer look to see how to add these tools to the project.