# Bitly Bitlinks API

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

Bitly Bitlinks 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 Bitlinks. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a getting-started guide.

Create, expand, update, archive and delete Bitlinks, list them by group, and read per-link click, engagement, country, city, device and referrer metrics. 21 operation(s), extracted verbatim from the OpenAPI Bitly publishes at https://dev.bitly.com/v4/v4.json.

## Operations (21)

| Method | Path | Summary |
|---|---|---|
| POST | `/shorten` | Shorten a Link |
| POST | `/bitlinks` | Create a Bitlink |
| DELETE | `/bitlinks/{bitlink}` | Delete a Bitlink |
| PATCH | `/bitlinks/{bitlink}` | Update a Bitlink |
| GET | `/bitlinks/{bitlink}` | Retrieve a Bitlink |
| POST | `/expand` | Expand a Bitlink |
| GET | `/bitlinks/{bitlink}/clicks` | Get Clicks for a Bitlink |
| GET | `/bitlinks/{bitlink}/clicks/summary` | Get a Clicks Summary for a Bitlink |
| GET | `/bitlinks/{bitlink}/engagements` | Get Engagement Counts for a Bitlink |
| GET | `/bitlinks/{bitlink}/engagements/summary` | Get an Engagement Count Summary for a Bitlink |
| GET | `/bitlinks/{bitlink}/countries` | Get Metrics for a Bitlink by Country |
| GET | `/bitlinks/{bitlink}/cities` | Get Metrics for a Bitlink by City |
| GET | `/bitlinks/{bitlink}/devices` | Get Metrics for a Bitlink by Device Type |
| GET | `/bitlinks/{bitlink}/referrers` | Get Metrics for a Bitlink by Referrers |
| GET | `/bitlinks/{bitlink}/referrer_name` | Get Metrics for a Bitlink by Referrer Name |
| GET | `/bitlinks/{bitlink}/referring_domains` | Get Metrics for a Bitlink by Referring Domains |
| GET | `/bitlinks/{bitlink}/referrers_by_domains` | Get Metrics for a Bitlink by Referrers by Domain |
| GET | `/groups/{group_guid}/bitlinks` | Retrieve Bitlinks by Group |
| PATCH | `/groups/{group_guid}/bitlinks` | Bulk update bitlinks |
| GET | `/groups/{group_guid}/engagements/sorted/top` | Retrieve Top Links and Decoupled QR Codes by Engagements |
| GET | `/groups/{group_guid}/bitlinks/{sort}` | Retrieve Sorted Bitlinks for Group |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/bitly/refs/heads/main/openapi/bitly-bitlinks-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-bitlinks-api.postman_collection.json
- **OpenCollection** — https://raw.githubusercontent.com/api-evangelist/bitly/refs/heads/main/collections/bitly-bitlinks-api.opencollection.json
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/bitly/refs/heads/main/overlays/bitly-bitlinks-overlay.yaml

## Other Bitly APIs (10)

- [Bitly BSDs API](https://apis.io/apis/bitly/bitly-bsds-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 Groups API](https://apis.io/apis/bitly/bitly-groups-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

Bitlinks

---

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