Bitly is a link management platform for creating, branding, routing and measuring short links, QR Codes and link-in-bio pages at scale. The Bitly v4 REST API is a 94-operation, bearer-authenticated JSON API at https://api-ssl.bitly.com/v4 covering Bitlink creation and expansion, custom back-halves, branded short domains, groups (workspaces) and organizations, campaigns and channels, dynamic and static QR Codes, bulk shortening, engagement webhooks, and a deep click/scan analytics surface sliced by country, city, device, OS, browser and referrer. Bitly publishes its own OpenAPI 3.0 definition and operates an official remote Model Context Protocol server, making it directly callable by AI agents.
Bitly publishes 11 API contracts indexed on the APIs.io network, including BSDs API, Bitlinks API, Campaigns API, and 8 more. Tagged areas include Links, URL Shorteners, QR Codes, Analytics, and Marketing.
The Bitly catalog on APIs.io includes 1 event-driven AsyncAPI specification and 1 Spectral governance ruleset.
Bitly’s developer surface includes authentication, documentation, API reference, pricing, signup flow, support, engineering blog, and 44 more developer resources.
The questions people put to an LLM, and the jobs they hand an agent, that Bitly's APIs answer — each one linked to the operation that does it.
Generated by API Evangelist
Regulatory Posture applies to this provider. Its tags matched the
Horizontal (data, software, accessibility, platform) regime, so
Regulatory Posture carries 15 points of the composite.
If this regime is wrong for your business, say so on your
provider repo — the
applicability map is public and we will correct it.
Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it
carries 10 points of the composite. It is scored from the published contracts
themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already
holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in
front of it, and the first time that check is skipped a duplicate record is created.
Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet,
not penalised by it.
The six quality facets above are damped to 75 points between them,
because the conditional facet above carries the other
25. That is why each facet's contribution is shown against a damped
maximum: raising a quality facet moves the composite by 75% of its nominal
weight, not 100%. The full arithmetic is at apis.io/rating/.
Show this score on your site.
It updates itself when the score changes. Paste this where you link to your API docs:
<a href="https://apis.io/providers/bitly/"><img src="https://apis.io/badge/bitly/card.svg" alt="Bitly on APIs.io — Kin Score by API Evangelist"></a>
Other styles, a README pill and a shields.io endpoint are on the badge page.
Raise your score.
Agent readiness — checks not met, largest first (exact, from this profile):
Idempotency+9 pts — OpenAPI mutating operations declare an idempotency key — a header, a request-body property, or a named de-duplication token whose own description says so (verified); else common[].type matches /idempoten/i (documented)
A2A Agent Card+8 pts — a2a/-a2a.yml manifest, graded on conformance.grade against A2A 1.0.0
Documented Reversibility+6 pts — a reversal operation in the contract, graded up when a window is documented too
Pagination+5 pts — share of collection GETs (an array, or one wrapped in data/items/results ...) that declare a page/limit/offset/cursor parameter, a Link header or a next/cursor field; na with no collection GETs
Agentic Commerce Well-Known Document+5 pts — a parsing /.well-known/ucp.json or acp.json declaring a version and at least one service, OR (0.27) a live x402 payment challenge from _data/x402-adoption.json — `self` when its endpoints are on the provider's own domain, `platform` when they are on a vendor's
The Kin Score Market layer reads a provider inside its market:
its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted:
not part of the Kin Score or agent readiness.
Registered MCP server and declares compatibility are report only — not weighted.
Undeclared means we found nothing we can read, so there is no number: we never infer integrations.
Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.
List the branded short domains (BSDs) available to the authenticated account. 1 operation(s), extracted verbatim from the OpenAPI Bitly publishes at https://dev.bitly.com/v4/v4....
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), extrac...
Manage marketing campaigns and the channels inside them, grouping Bitlinks for attribution. 8 operation(s), extracted verbatim from the OpenAPI Bitly publishes at https://dev.bi...
Create and update custom back-halves on existing Bitlinks and read clicks by destination for A/B rotations. 5 operation(s), extracted verbatim from the OpenAPI Bitly publishes a...
Manage groups (workspaces) — preferences, tags, shorten counts, exports, feature usage and historical usage — plus the full group-level click, scan and engagement analytics surf...
Read organizations, their plan limits, and shorten counts overall and by group. 5 operation(s), extracted verbatim from the OpenAPI Bitly publishes at https://dev.bitly.com/v4/v...
Create dynamic and static QR Codes, customize their render, fetch the image, upgrade a code to a Bitlink, and read scan metrics by browser, city, country and device OS. 16 opera...
Read and update the authenticated user profile and read the platform limits applied to the account. 3 operation(s), extracted verbatim from the OpenAPI Bitly publishes at https:...
Create, read, update, delete and verify webhook endpoints that receive Bitly engagement events. 6 operation(s), extracted verbatim from the OpenAPI Bitly publishes at https://de...
Bitly's official remote Model Context Protocol server, exposing 25 tools for link creation, QR Codes, analytics, groups, custom domains and bulk upload. Hosted by Bitly at https...
Overlays applied on top of this provider's contracts. Each card says who wrote it: a document the provider publishes, or one API Evangelist derived or generated.
aid: bitly
name: Bitly
description: Bitly is a link management platform for creating, branding, routing and measuring short links, QR Codes and link-in-bio
pages at scale. The Bitly v4 REST API is a 94-operation, bearer-authenticated JSON API at https://api-ssl.bitly.com/v4 covering
Bitlink creation and expansion, custom back-halves, branded short domains, groups (workspaces) and organizations, campaigns
and channels, dynamic and static QR Codes, bulk shortening, engagement webhooks, and a deep click/scan analytics surface
sliced by country, city, device, OS, browser and referrer. Bitly publishes its own OpenAPI 3.0 definition and operates an
official remote Model Context Protocol server, making it directly callable by AI agents.
type: Index
deliveryModel:
model: saas
open_source: false
commercial: true
callable_host: true
label: Hosted service · you call their endpoint
confidence: high
source:
- openapi
- pricing
generated: '2026-08-28'
method: derived
accessModel:
pricing: freemium
onboarding: self-serve
trial: false
try_now: true
public: false
gated: none
gated_source:
- onboarding
label: Freemium · Self-serve signup
confidence: high
source:
- plans
- authentication
- scopes
- rate-limits
- security
- sandbox
generated: '2026-11-06'
method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/bitly.png
tags:
- Links
- URL Shorteners
- QR Codes
- Analytics
- Marketing
- Link Management
- Webhook
- Attribution
- Agents
- MCP
tags_raw:
- Links
- URL Shortener
- QR Codes
- Analytics
- Marketing
- Link Management
- Webhooks
- Attribution
- Agents
- MCP
url: https://raw.githubusercontent.com/api-evangelist/bitly/refs/heads/main/apis.yml
created: '2026-05-11'
modified: '2026-08-13'
specificationVersion: '0.23'
apis:
- aid: bitly:bitly-bsds-api
name: Bitly BSDs API
description: List the branded short domains (BSDs) available to the authenticated account. 1 operation(s), extracted verbatim
from the OpenAPI Bitly publishes at https://dev.bitly.com/v4/v4.json.
humanURL: https://dev.bitly.com/api-reference
baseURL: https://api-ssl.bitly.com/v4
tags:
- BSDs
properties:
- type: OpenAPI
url: openapi/bitly-bsds-api-openapi.yml
- type: Documentation
url: https://dev.bitly.com/api-reference
- type: APIReference
url: https://dev.bitly.com/api-reference
- type: GettingStarted
url: https://dev.bitly.com/docs/getting-started/introduction
- type: PostmanCollection
url: collections/bitly-bsds-api.postman_collection.json
- type: OpenCollection
url: collections/bitly-bsds-api.opencollection.json
- type: Overlay
url: overlays/bitly-bsds-overlay.yaml
- aid: bitly:bitly-bitlinks-api
name: Bitly Bitlinks API
description: 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.
humanURL: https://dev.bitly.com/api-reference
baseURL: https://api-ssl.bitly.com/v4
tags:
- Bitlinks
properties:
- type: OpenAPI
url: openapi/bitly-bitlinks-api-openapi.yml
- type: Documentation
url: https://dev.bitly.com/api-reference
- type: APIReference
url: https://dev.bitly.com/api-reference
- type: GettingStarted
url: https://dev.bitly.com/docs/getting-started/introduction
- type: PostmanCollection
url: collections/bitly-bitlinks-api.postman_collection.json
- type: OpenCollection
url: collections/bitly-bitlinks-api.opencollection.json
- type: Overlay
url: overlays/bitly-bitlinks-overlay.yaml
- aid: bitly:bitly-campaigns-api
name: Bitly Campaigns API
description: Manage marketing campaigns and the channels inside them, grouping Bitlinks for attribution. 8 operation(s),
extracted verbatim from the OpenAPI Bitly publishes at https://dev.bitly.com/v4/v4.json.
humanURL: https://dev.bitly.com/api-reference
baseURL: https://api-ssl.bitly.com/v4
tags:
- Campaigns
properties:
- type: OpenAPI
url: openapi/bitly-campaigns-api-openapi.yml
- type: Documentation
url: https://dev.bitly.com/api-reference
- type: APIReference
url: https://dev.bitly.com/api-reference
- type: GettingStarted
url: https://dev.bitly.com/docs/getting-started/introduction
- type: PostmanCollection
url: collections/bitly-campaigns-api.postman_collection.json
- type: OpenCollection
url: collections/bitly-campaigns-api.opencollection.json
- type: Overlay
url: overlays/bitly-campaigns-overlay.yaml
- aid: bitly:bitly-custom-bitlinks-api
name: Bitly Custom Bitlinks API
description: Create and update custom back-halves on existing Bitlinks and read clicks by destination for A/B rotations.
5 operation(s), extracted verbatim from the OpenAPI Bitly publishes at https://dev.bitly.com/v4/v4.json.
humanURL: https://dev.bitly.com/api-reference
baseURL: https://api-ssl.bitly.com/v4
tags:
- Custom Bitlinks
properties:
- type: OpenAPI
url: openapi/bitly-custom-bitlinks-api-openapi.yml
- type: Documentation
url: https://dev.bitly.com/api-reference
- type: APIReference
url: https://dev.bitly.com/api-reference
- type: GettingStarted
url: https://dev.bitly.com/docs/getting-started/introduction
- type: PostmanCollection
url: collections/bitly-custom-bitlinks-api.postman_collection.json
- type: OpenCollection
url: collections/bitly-custom-bitlinks-api.opencollection.json
- type: Overlay
url: overlays/bitly-custom-bitlinks-overlay.yaml
- aid: bitly:bitly-groups-api
name: Bitly Groups API
description: 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.
humanURL: https://dev.bitly.com/api-reference
baseURL: https://api-ssl.bitly.com/v4
tags:
- Group
tags_raw:
- Groups
properties:
- type: OpenAPI
url: openapi/bitly-groups-api-openapi.yml
- type: Documentation
url: https://dev.bitly.com/api-reference
- type: APIReference
url: https://dev.bitly.com/api-reference
- type: GettingStarted
url: https://dev.bitly.com/docs/getting-started/introduction
- type: PostmanCollection
url: collections/bitly-groups-api.postman_collection.json
- type: OpenCollection
url: collections/bitly-groups-api.opencollection.json
- type: Overlay
url: overlays/bitly-groups-overlay.yaml
- aid: bitly:bitly-organizations-api
name: Bitly Organizations API
description: Read organizations, their plan limits, and shorten counts overall and by group. 5 operation(s), extracted verbatim
from the OpenAPI Bitly publishes at https://dev.bitly.com/v4/v4.json.
humanURL: https://dev.bitly.com/api-reference
baseURL: https://api-ssl.bitly.com/v4
tags:
- Organization
tags_raw:
- Organizations
properties:
- type: OpenAPI
url: openapi/bitly-organizations-api-openapi.yml
- type: Documentation
url: https://dev.bitly.com/api-reference
- type: APIReference
url: https://dev.bitly.com/api-reference
- type: GettingStarted
url: https://dev.bitly.com/docs/getting-started/introduction
- type: PostmanCollection
url: collections/bitly-organizations-api.postman_collection.json
- type: OpenCollection
url: collections/bitly-organizations-api.opencollection.json
- type: Overlay
url: overlays/bitly-organizations-overlay.yaml
- aid: bitly:bitly-qr-codes-api
name: Bitly QR Codes API
description: Create dynamic and static QR Codes, customize their render, fetch the image, upgrade a code to a Bitlink, and
read scan metrics by browser, city, country and device OS. 16 operation(s), extracted verbatim from the OpenAPI Bitly
publishes at https://dev.bitly.com/v4/v4.json.
humanURL: https://dev.bitly.com/api-reference
baseURL: https://api-ssl.bitly.com/v4
tags:
- QR Codes
properties:
- type: OpenAPI
url: openapi/bitly-qr-codes-api-openapi.yml
- type: Documentation
url: https://dev.bitly.com/api-reference
- type: APIReference
url: https://dev.bitly.com/api-reference
- type: GettingStarted
url: https://dev.bitly.com/docs/getting-started/introduction
- type: PostmanCollection
url: collections/bitly-qr-codes-api.postman_collection.json
- type: OpenCollection
url: collections/bitly-qr-codes-api.opencollection.json
- type: Overlay
url: overlays/bitly-qr-codes-overlay.yaml
- aid: bitly:bitly-user-api
name: Bitly User API
description: Read and update the authenticated user profile and read the platform limits applied to the account. 3 operation(s),
extracted verbatim from the OpenAPI Bitly publishes at https://dev.bitly.com/v4/v4.json.
humanURL: https://dev.bitly.com/api-reference
baseURL: https://api-ssl.bitly.com/v4
tags:
- User
properties:
- type: OpenAPI
url: openapi/bitly-user-api-openapi.yml
- type: Documentation
url: https://dev.bitly.com/api-reference
- type: APIReference
url: https://dev.bitly.com/api-reference
- type: GettingStarted
url: https://dev.bitly.com/docs/getting-started/introduction
- type: PostmanCollection
url: collections/bitly-user-api.postman_collection.json
- type: OpenCollection
url: collections/bitly-user-api.opencollection.json
- type: Overlay
url: overlays/bitly-user-overlay.yaml
- aid: bitly:bitly-webhooks-api
name: Bitly Webhooks API
description: Create, read, update, delete and verify webhook endpoints that receive Bitly engagement events. 6 operation(s),
extracted verbatim from the OpenAPI Bitly publishes at https://dev.bitly.com/v4/v4.json.
humanURL: https://dev.bitly.com/api-reference
baseURL: https://api-ssl.bitly.com/v4
tags:
- Webhook
tags_raw:
- Webhooks
properties:
- type: OpenAPI
url: openapi/bitly-webhooks-api-openapi.yml
- type: Documentation
url: https://dev.bitly.com/api-reference
- type: APIReference
url: https://dev.bitly.com/api-reference
- type: GettingStarted
url: https://dev.bitly.com/docs/getting-started/introduction
- type: PostmanCollection
url: collections/bitly-webhooks-api.postman_collection.json
- type: Webhooks
url: asyncapi/bitly-engagement-webhooks.yml
- type: OpenCollection
url: collections/bitly-webhooks-api.opencollection.json
- type: Overlay
url: overlays/bitly-webhooks-overlay.yaml
- aid: bitly:bitly-mcp-server
name: Bitly MCP Server
description: Bitly's official remote Model Context Protocol server, exposing 25 tools for link creation, QR Codes, analytics,
groups, custom domains and bulk upload. Hosted by Bitly at https://api-ssl.bitly.com/v4/mcp; authentication is required
(bearer token or OAuth 2.1 with Dynamic Client Registration).
humanURL: https://dev.bitly.com/bitly-mcp/
baseURL: https://api-ssl.bitly.com/v4/mcp
tags:
- MCP
- Agents
properties:
- type: MCPServer
url: mcp/bitly-mcp.yml
- type: ToolCrosswalk
url: mcp/bitly-tool-crosswalk.yml
- type: Documentation
url: https://dev.bitly.com/bitly-mcp/
- type: GettingStarted
url: https://dev.bitly.com/bitly-mcp/overview/quickstart/
- type: ChangeLog
url: https://dev.bitly.com/bitly-mcp/overview/mcp-changelog/
- aid: bitly:bitly-apps-api
name: Bitly Apps API
description: The Apps API from Bitly — 1 operation(s) for apps.
humanURL: https://dev.bitly.com/api-reference
baseURL: https://api-ssl.bitly.com/v4
tags:
- Application
tags_raw:
- Apps
properties:
- type: OpenAPI
url: openapi/bitly-apps-api-openapi.yml
- type: Documentation
url: https://dev.bitly.com/api-reference
- type: APIReference
url: https://dev.bitly.com/api-reference
- type: GettingStarted
url: https://dev.bitly.com/docs/getting-started/introduction
- type: PostmanCollection
url: collections/bitly-oauth-apps-api.postman_collection.json
- type: OpenCollection
url: collections/bitly-oauth-apps-api.opencollection.json
common:
- type: CapabilityMap
url: capabilities/bitly-capability-edges.yml
name: Bitly Business Capability Map
- type: Overlay
url: overlays/bitly-oauth-apps-overlay.yaml
- type: AgenticAccess
url: agentic-access/bitly-agentic-access.yml
- type: TrustCenter
url: security/bitly-trust-center.yml
- type: VulnerabilityDisclosure
url: security/bitly-vulnerability-disclosure.yml
- type: DomainSecurity
url: security/bitly-domain-security.yml
- type: Authentication
url: authentication/bitly-authentication.yml
- type: LinkedIn
url: https://www.linkedin.com/company/bitly
- type: Website
url: https://bitly.com
- type: Documentation
url: https://dev.bitly.com
- type: APIReference
url: https://dev.bitly.com/api-reference
- type: Pricing
url: https://bitly.com/pages/pricing
- type: Signup
url: https://app.bitly.com/sign_up
- type: Login
url: https://app.bitly.com/sign_in
- type: Authentication
url: https://dev.bitly.com/docs/getting-started/authentication
- type: RateLimits
url: https://dev.bitly.com/docs/getting-started/rate-limits
- type: Support
url: https://support.bitly.com
- type: StatusPage
url: https://bitly.statuspage.io
- type: GitHubOrganization
url: https://github.com/bitly
- url: https://bitly.com/blog/
type: Blog
- type: Packages
url: packages/bitly-packages.yml
- type: SDKs
url: packages/bitly-packages.yml
- type: WellKnown
url: well-known/bitly-well-known.yml
- type: SecurityTxt
url: well-known/bitly-security.txt
- type: LLMsTxt
url: llms/bitly-llms.txt
- type: Conformance
url: conformance/bitly-conformance.yml
- type: Compliance
url: security/bitly-trust-center.yml
- type: ErrorCatalog
url: errors/bitly-problem-types.yml
- type: Lifecycle
url: lifecycle/bitly-lifecycle.yml
- type: Conventions
url: conventions/bitly-conventions.yml
- type: ChangeLog
url: changelog/bitly-changelog.yml
- type: DataModel
url: data-model/bitly-data-model.yml
- type: Sandbox
url: sandbox/bitly-sandbox.yml
- type: Plans
url: plans/bitly-plans-pricing.yml
- type: RateLimits
url: rate-limits/bitly-rate-limits.yml
- type: Webhooks
url: asyncapi/bitly-engagement-webhooks.yml
- type: AgentSkill
url: skills/_index.yml
- type: Security
url: security/bitly-vulnerability-disclosure.yml
- type: OAuthScopes
url: scopes/bitly-scopes.yml
- type: DeveloperPortal
url: https://dev.bitly.com
- type: TrustCenter
url: https://security.bitly.com
- type: Changelog
url: https://dev.bitly.com/bitly-mcp/overview/mcp-changelog/
- type: TermsOfService
url: https://bitly.com/pages/terms-of-service
- type: PrivacyPolicy
url: https://bitly.com/pages/privacy
- type: MCPServer
url: https://dev.bitly.com/bitly-mcp/
- type: PostmanCollection
url: collections/bitly.postman_collection.json
- type: OpenCollection
url: collections/bitly.opencollection.json
- type: AgentSkill
url: skills/bitly-shorten-and-brand-a-link.md
- type: AgentSkill
url: skills/bitly-report-link-performance.md
- type: AgentSkill
url: skills/bitly-create-and-measure-a-qr-code.md
- type: AgentSkill
url: skills/bitly-subscribe-to-engagement-events.md
maintainers:
- FN: Kin Lane
email: kin@apievangelist.com
x-enrichment:
date: '2026-08-13'
status: enriched
artifacts_added: 38
pass: local-v1
Bitly API — frequently asked questions
Does Bitly have an API?
Yes. APIs.io lists 11 APIs from Bitly, including Bitly BSDs API, Bitly Bitlinks API and Bitly Campaigns API, and 8 more.
Is there an OpenAPI specification for the Bitly API?
Yes. APIs.io indexes 10 OpenAPI specifications for Bitly, each linked for download from this page.
How do I authenticate with the Bitly API?
Bitly documents its authentication (http/oauth2 · 2 schemes). The details are profiled on APIs.io as Bitly Authentication.
How much does the Bitly API cost?
Bitly publishes its prices; its Free With Ads plan is $0/month as of 2026-10-28. APIs.io lists 5 pricing plans for Bitly, with each plan's price, limits and inclusions under Pricing on this page.
Does Bitly have an MCP server?
Yes. APIs.io lists 2 MCP servers for Bitly: Remote MCP server at api-ssl.bitly.com requiring OAuth; 25 tools listed.
Is the Bitly API ready for AI agents?
Bitly has a Kin Score of 73.7 out of 100 (exemplar) and an Agent Readiness score of 59.4 (agent-ready), scored by API Evangelist on 2026-11-06.
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.