# Bitly Groups API

**Canonical:** https://apis.io/apis/bitly/bitly-groups-api/  
**Provider:** Bitly — https://apis.io/providers/bitly/  
**Base URL:** https://api-ssl.bitly.com/v4  
**Documentation:** https://dev.bitly.com/api-reference

Bitly Groups API is one of 11 APIs that [Bitly](https://apis.io/providers/bitly/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Group. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a getting-started guide.

Manage groups (workspaces) — preferences, tags, shorten counts, exports, feature usage and historical usage — plus the full group-level click, scan and engagement analytics surface. 28 operation(s), extracted verbatim from the OpenAPI Bitly publishes at https://dev.bitly.com/v4/v4.json.

## Operations (28)

| Method | Path | Summary |
|---|---|---|
| GET | `/groups` | Retrieve Groups |
| PATCH | `/groups/{group_guid}` | Update a Group |
| GET | `/groups/{group_guid}` | Retrieve a Group |
| GET | `/groups/{group_guid}/tags` | Retrieve Tags by Group |
| GET | `/groups/{group_guid}/preferences` | Retrieve Group Preferences |
| PATCH | `/groups/{group_guid}/preferences` | Update Group Preferences |
| GET | `/groups/{group_guid}/shorten_counts` | Retrieve Group Shorten Counts |
| GET | `/groups/{group_guid}/countries` | Get Click Metrics for a Group by Country |
| GET | `/groups/{group_guid}/cities` | Get Click Metrics for a Group by City |
| GET | `/groups/{group_guid}/devices` | Get Click Metrics for a Group by Device Type |
| GET | `/groups/{group_guid}/referring_networks` | Get Click Metrics for a Group by Referring Networks |
| GET | `/groups/{group_guid}/referrers` | Get Click Metrics for a Group by Referrer |
| GET | `/groups/{group_guid}/engagements/top` | Get Group Top Performing Links by Engagement |
| GET | `/groups/{group_guid}/engagements/over_time` | Get Group Metrics Over Time |
| GET | `/groups/{group_guid}/clicks` | Get clicks by group |
| POST | `/groups/{group_guid}/exports` | Create an inline CSV export for a group |
| GET | `/groups/{group_guid}/feature_usage` | Get limit usage for a group |
| GET | `/groups/{group_guid}/historical_usage` | Get historical usage for a group |
| GET | `/groups/{group_guid}/links/clicks/over_time` | Get Group Link Clicks Over Time |
| GET | `/groups/{group_guid}/links/clicks/devices` | Get Group Link Clicks by Device |
| GET | `/groups/{group_guid}/links/clicks/referrers` | Get Group Link Clicks by Referrer |
| GET | `/groups/{group_guid}/links/clicks/countries` | Get Group Link Clicks by Country |
| GET | `/groups/{group_guid}/links/clicks/cities` | Get Group Link Clicks by City |
| GET | `/groups/{group_guid}/links/clicks/top` | Get Group Top Performing Links by Click |
| GET | `/groups/{group_guid}/codes/scans/over_time` | Get Scan Metrics for a Group Over Time |
| GET | `/groups/{group_guid}/codes/scans/countries` | Get Scan Metrics for a Group by Country |
| GET | `/groups/{group_guid}/codes/scans/cities` | Get Scan Metrics for a Group by City |
| GET | `/groups/{group_guid}/codes/scans/top` | Get Top Performing QR Codes for a Group |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/bitly/refs/heads/main/openapi/bitly-groups-api-openapi.yml
- **Documentation** — https://dev.bitly.com/api-reference
- **APIReference** — https://dev.bitly.com/api-reference
- **GettingStarted** — https://dev.bitly.com/docs/getting-started/introduction
- **PostmanCollection** — https://raw.githubusercontent.com/api-evangelist/bitly/refs/heads/main/collections/bitly-groups-api.postman_collection.json
- **OpenCollection** — https://raw.githubusercontent.com/api-evangelist/bitly/refs/heads/main/collections/bitly-groups-api.opencollection.json
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/bitly/refs/heads/main/overlays/bitly-groups-overlay.yaml

## Other Bitly APIs (10)

- [Bitly BSDs API](https://apis.io/apis/bitly/bitly-bsds-api/)
- [Bitly Bitlinks API](https://apis.io/apis/bitly/bitly-bitlinks-api/)
- [Bitly Campaigns API](https://apis.io/apis/bitly/bitly-campaigns-api/)
- [Bitly Custom Bitlinks API](https://apis.io/apis/bitly/bitly-custom-bitlinks-api/)
- [Bitly Organizations API](https://apis.io/apis/bitly/bitly-organizations-api/)
- [Bitly QR Codes API](https://apis.io/apis/bitly/bitly-qr-codes-api/)
- [Bitly User API](https://apis.io/apis/bitly/bitly-user-api/)
- [Bitly Webhooks API](https://apis.io/apis/bitly/bitly-webhooks-api/)
- [Bitly MCP Server](https://apis.io/apis/bitly/bitly-mcp-server/)
- [Bitly Apps API](https://apis.io/apis/bitly/bitly-apps-api/)

## Tags

Group

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/bitly/bitly-groups-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/bitly/.