V1 Endpoints (Deprecated)
V1 has been retired
As of August 7, 2026, the V1 API is deprecated and no longer available. Requests to https://api.counterapi.dev/v1 will no longer succeed. This page is kept for historical reference only — please migrate to the V2 Endpoints documentation.
The information below describes the legacy V1 API, which is no longer in service.
Counter API V1 endpoints previously provided a simple, authentication-free way to track counts across your applications, with a rate limit of 30 requests per minute per URL path.
The former API base URL was https://api.counterapi.dev/v1 (now decommissioned).
V1 Limitations (historical)
V1 endpoints had the following limitations: - Always public: All counters were accessible to anyone who knew the namespace and name - Low rate limits: Limited to only 30 requests per minute per URL path - No private counters: Could not create counters that were accessible only to you
Migrate to V2
V2 endpoints are now the only available option, offering: - Higher rate limits (600 requests per minute) - Private counters with authentication - Better security for your data
Below is the legacy V1 endpoint reference, kept for migration purposes. These endpoints are no longer functional — the equivalent V2 endpoint is noted for each.
Counter Up
Incremented a counter by 1.
Former endpoint: https://api.counterapi.dev/v1/:namespace/:name/up
Parameters
| name | required | description |
|---|---|---|
:namespace |
yes | A grouping category for your counters (e.g., your app name, website, or project) |
:name |
yes | Unique identifier for this specific counter within your namespace |
Former usage (no longer functional)
Use the V2 Counter Up endpoint instead.
Counter Down
Decremented a counter by 1.
Former endpoint: https://api.counterapi.dev/v1/:namespace/:name/down
Parameters
| name | required | description |
|---|---|---|
:namespace |
yes | A grouping category for your counters (e.g., your app name, website, or project) |
:name |
yes | Unique identifier for this specific counter within your namespace |
Former usage (no longer functional)
Use the V2 Counter Down endpoint instead.
Set Counter
Set a counter to a specific value.
Former endpoint: https://api.counterapi.dev/v1/:namespace/:name/set
Parameters
| name | required | description |
|---|---|---|
:namespace |
yes | A grouping category for your counters (e.g., your app name, website, or project) |
:name |
yes | Unique identifier for this specific counter within your namespace |
count |
yes | The exact value to set the counter to (integer) |
Former usage (no longer functional)
Use the V2 Reset Counter endpoint instead.
Counter Get
Retrieved the current value of a counter.
Former endpoint: https://api.counterapi.dev/v1/:namespace/:name/
Parameters
| name | required | description |
|---|---|---|
:namespace |
yes | A grouping category for your counters (e.g., your app name, website, or project) |
:name |
yes | Unique identifier for this specific counter within your namespace |
Former usage (no longer functional)
Use the V2 Counter Get endpoint instead.
Counts List
Retrieved historical count data with flexible grouping and ordering options.
Former endpoint: https://api.counterapi.dev/v1/:namespace/:name/list
Parameters
| name | required | description |
|---|---|---|
:namespace |
yes | A grouping category for your counters (e.g., your app name, website, or project) |
:name |
yes | Unique identifier for this specific counter within your namespace |
group_by |
no | Aggregates data by time period for easier analysis. Options: hour, day, week, month, year. Default is day. |
order_by |
no | Sorts results chronologically. Options: asc (oldest first), desc (newest first). Default is desc. |
Former usage (no longer functional)
The V2 Counter Stats endpoint provides similar historical breakdowns.