Your AI team, working in Bitly

Bitly is a link management platform for shortening, customizing, sharing, and measuring links and QR codes.

Start your company

What your team can do in Bitly

85 tools to work with, connected with an API key.

Add Channel Bitlinks

Add 1-100 Bitlinks to an existing Bitly channel under a single campaign, without replacing existing channel membership. If needed, the campaign is associated with the channel first. The request is all-or-nothing: if any Bitlink is invalid, nothing is added. Requires a Bitly plan supporting channels; upgrade if Bitly returns 402.

Add Custom Bitlink

Add a custom back-half to an existing Bitlink on an available short domain, or set its initial custom redirect. Supply custom_bitlink and bitlink_id in domain/back-half form; their domains must match. Requires access to the domain and Bitlink. Custom-link availability and limits depend on the plan.

Add Custom Domain

Add a domain you already own to a Bitly organization and queue DNS verification, or set prevalidate=true to check it without adding it. This does not purchase a domain. Requires an organization admin, control of the domain's DNS configuration, and a Bitly plan with custom-domain entitlement and available capacity. Verification is asynchronous and can take up to 24 hours; later read GET /custom_domains for validation_status. An existing domain on this organization is requeued for DNS verification; a domain held by another account cannot be added.

Apply Site Template

Apply a template's appearance and, where applicable, sample content to an existing Bitly Site. Returns the updated site's settings. Availability depends on the connected account's Bitly plan.

Bulk Update Bitlinks

Add or remove tags, or archive/unarchive up to 100 Bitlinks in a Bitly group. Returns the Bitlink IDs that were updated. Availability depends on the connected account's permissions and Bitly plan; a plan upgrade may be required.

Bulk Update QR Codes

Add or remove tags, or archive/unarchive up to 100 Bitly QR codes in a group. Pages QR codes cannot be updated with this action. Returns the IDs of QR codes that were updated. Availability depends on the connected account's permissions and Bitly plan; a plan upgrade may be required.

Clone Site

Create a new Bitly Site by cloning the content and appearance of an existing site. Optionally specify the new site's URI. Availability and site limits depend on the connected account's Bitly plan.

Create Bitlink

Create a Bitly short link with a title, tags, deep links, expiration, and dynamic routing, or add a keyword override to an existing bitlink_id. Provide exactly one of long_url or bitlink_id. Custom keywords and advanced features depend on your Bitly plan, domain permissions, and monthly limits.

Create Campaign

Create a Bitly campaign in a group, optionally associating channel GUIDs. Campaign availability depends on the connected account's Bitly plan; accounts without campaign entitlement must upgrade.

Create Channel

Create a Bitly channel in a group, optionally associating campaign bitlinks. Channel availability depends on the connected account's Bitly plan; accounts without the required entitlement must upgrade.

Create Group Export

Build a synchronous CSV export of group link engagements, links, or QR codes. Returns JSON metadata with a base64 CSV data URI. Metrics exports are capped at 200 rows; metadata-only lists at 1000. Check truncated for omitted rows. Availability and metrics history depend on the connected Bitly plan; upgrade if required.

Create QR Code

Create a QR code in a Bitly group for an existing Bitlink, Link-in-Bio site, or a stand-alone long URL. Optionally customize appearance, GS1 metadata, expiration, tags, and long-URL dynamic routing. Returns QR metadata and ID, not an image. Creation consumes the group's QR quota; customizations and advanced features may require a Bitly plan upgrade.

Create Site

Create an empty Bitly Site in a group with default appearance settings. Choose a domain and keyword for its URL. Availability and site limits depend on the connected account's Bitly plan.

Create Site Block

Create a Bitlink, social, YouTube video, image, digital business card, or text block on a Bitly Site. Supply content matching the selected type; use parent to place it in an existing container. Grid and carousel must be created via the container endpoint instead. Availability and limits depend on the connected account's Bitly plan.

Create Site Container

Create a carousel or grid container for a set of content on a Bitly Site. Returns the created site block. Availability depends on the connected account's Bitly plan and site entitlements.

Create Site Image

Attach a previously uploaded image to a Bitly Site and return its URL and GUID. This endpoint accepts image references, not base64 image data. Availability depends on the connected account's Bitly plan and site entitlements.

Create Static QR Code

Generate a static QR image for raw content without creating or saving a Bitly QR resource. Returns base64 image bytes, not a hosted URL or data URI. Choose SVG or PNG and basic appearance options; gradients, frame, text, and logo are unsupported. Contact your Bitly Account Manager to enable this feature.

Create Webhook

Create a Bitly webhook for an organization, optionally associated with a group. The destination URL may receive Bitly event data; configure only a trusted endpoint. Webhook availability depends on the connected account's plan; accounts without webhook entitlement must upgrade. Receiver OAuth client secrets cannot be set with this tool.

Delete Bitlink

Permanently delete an eligible unedited hash Bitlink.

Delete QR Code

Permanently delete a QR code that has not been redirected and is not for a custom link. Also deletes the associated link, if applicable. Returns the deletion records reported by Bitly. Access depends on the connected account's permissions and plan entitlement.

Delete Site

Delete an existing Bitly Site by its GUID. Returns no content on success. Access depends on the connected account's permissions and Bitly plan entitlement.

Delete Site Block

Delete a block of any type from a Bitly Site, rather than deactivate it. Deleting a container block (grid or carousel) also deletes its contained blocks. Does not delete the link tied to the block. Returns no content on success. Access depends on the connected account's permissions and Bitly plan entitlement.

Delete Site Redirect

Delete a redirect for a Bitly Site by its site ID, custom domain, and keyword (back-half). Returns no content on success. Access depends on the connected account's permissions and Bitly plan entitlement.

Delete Webhook

Delete a Bitly webhook by GUID to stop its event deliveries, returning an empty object on success. Requires access to the webhook and a Bitly plan supporting webhooks; upgrade your plan if Bitly returns 402.

Discard Site Draft

Discard a Bitly Site's in-progress draft by its site GUID. Returns no content on success. Access depends on the connected account's permissions and Bitly plan entitlement.

Expand LinkReads only

Resolve a Bitlink to its current destination and destination history, when available.

Get Account ContextReads only

Return the authenticated Bitly user together with accessible groups and organizations needed by other tools.

Get Aggregate Site AnalyticsReads only

Retrieve aggregate analytics for Bitly Sites: overview, views over time or by city/country/device/referrer, button clicks over time or by city/country/device, top clicked buttons, or digital business card downloads over time. Choose one report per call. Availability depends on the report and plan; detailed traffic breakdowns require a paid analytics entitlement.

Get BitlinkReads only

Retrieve Bitlink metadata, including destination, title, tags, archive or deletion state, and associated QR code IDs.

Get Bitlink ActivityReads only

Return paid-plan click or engagement analytics for a Bitlink as a timeline or summary. Requires Bitlink analytics entitlement.

Get Bitlink Referrer AnalyticsReads only

Get Bitlink click analytics by AI agent, referrer name, or referrers grouped by domain. Choose exactly one metric per call. Requires access to the Bitlink and the selected analytics entitlement; some metrics require a paid plan.

Get Bitlink Traffic SourcesReads only

Break down paid-plan Bitlink click analytics by country, city, device, referrer, or referring domain. Requires Bitlink analytics entitlement.

Get CampaignReads only

Retrieve a Bitly campaign by GUID to inspect its name, description, owning group, creator, timestamps, and resource references. The campaign must be accessible to the authenticated user. Requires a Bitly plan that supports campaigns; upgrade your plan if Bitly returns 402.

Get ChannelReads only

Retrieve a Bitly channel by GUID to inspect its name, owning group, creation and modification timestamps, and resource references. The channel must be accessible to the authenticated user. Requires a Bitly plan that supports channels; upgrade your plan if Bitly returns 402.

Get Custom BitlinkReads only

Retrieve a Custom Bitlink's details, current destination Bitlink, and redirect history. Supply the custom domain/back-half without a protocol. Requires access to the Custom Bitlink and a Bitly plan with the appropriate custom-link entitlement.

Get Custom Bitlink AnalyticsReads only

Retrieve time-bucketed clicks across a Custom Bitlink's entire history or click counts grouped by its historical destinations. Select clicks or clicks_by_destination and an analytics window. Requires access to the Custom Bitlink and a Bitly plan with the appropriate analytics entitlement.

Get Custom DomainReads only

Retrieve a Bitly custom domain's verification state, group assignments, redirects, deep-link applications, and SSL configuration. Requires membership in a group assigned to the domain or administrator access to its organization. Only organization administrators can read domains awaiting DNS verification. Account entitlements apply; upgrade your plan if Bitly returns 402.

Get Custom Domain DNSReads only

Inspect a Bitly custom domain's current DNS records, detected DNS provider, required registrar records, and whether the records match a valid configuration. Use the required A records for a root domain or CNAME record for a subdomain to configure DNS at your registrar. Does not modify DNS. Requires access to the specified organization and domain; account entitlements apply. Upgrade your plan if Bitly returns 402.

Get Domain AgreementsReads only

Retrieve the registrar agreements a user must accept before Bitly registers a domain. Review their content and pass each accepted agreement_key to POST /domains when purchasing the domain. This read does not accept agreements or purchase a domain. Account entitlements apply; upgrade your plan if Bitly returns 402.

Get GroupReads only

Retrieve a Bitly group by GUID, including its organization, your role, branded short domains, timestamps, and resource references. The group must be accessible to the authenticated user; account entitlements apply.

Get Group AnalyticsReads only

Retrieve one group analytics report: shorten counts, geography/devices/referrers, engagement rankings or timeline, link clicks, QR scans, historical usage, or agentic traffic rollup. Select metric and supply only that endpoint's parameters. Most metrics require unit and units. Analytics availability depends on Bitly plan entitlements; paid features return 402 without an upgrade. Returns provider fields without combining distinct rankings or response shapes.

Get Group PreferencesReads only

Retrieve a Bitly group's preferences, including its preferred domain for shortened links. Requires access to the specified group; availability is subject to your Bitly account permissions and plan entitlements.

Get Group TagsReads only

Retrieve tags currently used in a Bitly group for Bitlinks or QR codes. Returns at most 1000 tags; this endpoint has no documented pagination controls or continuation token. Requires access to the group and is subject to account entitlements; upgrade the connected plan if Bitly returns 402.

Get OAuth AppReads only

Retrieve a Bitly OAuth app by client ID to inspect its name, description, link, PKCE requirement, and first-party status. The authenticated account must have access to the app. Availability is subject to Bitly account permissions and entitlements; upgrade your plan if Bitly returns 402.

Get OrganizationReads only

Retrieve a Bitly organization by GUID, including its subscription tier, your role, branded short domains, authentication requirements, timestamps, and resource references. The organization must be accessible to the authenticated user; account entitlements apply.

Get Organization Shorten CountsReads only

Read an organization's shorten counts over a specified time window, supplying unit and units. Set by_group=true to read counts by group for the current month instead, without time parameters. Returns the provider's metrics envelope. Availability depends on Bitly plan entitlements; a 402 requires a plan upgrade.

Get QR CodeReads only

Retrieve a Bitly QR code by ID to inspect its destination, appearance, GS1 metadata, tags, expiration, and dynamic routing. Returns QR metadata, not an image. The connected account must have access to the QR code; feature availability depends on the Bitly plan.

Get QR Code AnalyticsReads only

Get a QR Code's scan timeline, total, or country, city, device OS or browser breakdown for a time window. Analytics availability depends on your Bitly plan; detailed reports may require an upgrade.

Get QR Code ImageReads only

Retrieve an existing Bitly QR code's image as a base64 data URI in qr_code_image, suitable for an HTML image src. Choose SVG or PNG; SVG is the default. This does not create a QR code and does not return a hosted image URL. Access and image features depend on the connected account's Bitly plan and QR code permissions.

Get SiteReads only

Retrieve a Bitly Site by its GUID, including content, appearance, and publication settings. Set include_blocks to retrieve its draft content blocks as well. Availability depends on the connected account's Bitly plan.

Get Site AnalyticsReads only

Retrieve one Bitly Site analytics report: country, city, device, or referrer views, link performance, a views timeline, or a views summary. Requires the connected account's site analytics entitlement; some reports require a paid plan. Link performance returns one page with provider pagination, not all pages.

Get Top Group EngagementsReads only

Retrieve a group's top Bitlinks and decoupled QR codes ranked together by engagement count over a time window. Returns separate links and qr_codes lists plus sorted_engagements whose IDs preserve the unified ranking. Coupled QR codes are ranked by their Bitlink ID. Returns one bounded result set, not all history pages. Analytics access depends on Bitly plan entitlements.

Get Usage and LimitsReads only

Inspect monthly plan quotas, hourly endpoint budgets, and optional group feature usage before performing quota-consuming work.

Get WebhookReads only

Retrieve a Bitly webhook by GUID to inspect its delivery configuration, subscribed event, status, owning organization and group, and lifecycle timestamps. Requires access to the webhook and a Bitly plan supporting webhooks; upgrade your plan if Bitly returns 402.

List BitlinksReads only

List or search Bitlinks owned by a group, one cursor-controlled page at a time.

List Branded Short DomainsReads only

List verified custom domains the authenticated user can shorten links with, across all their organizations and groups. Any group member can call this endpoint; no organization-admin role is required. Returns domain names only, not setup or verification state; use List Custom Domains for those details. There are no pagination controls. Availability is subject to account entitlements; upgrade the connected plan if Bitly returns 402.

List CampaignsReads only

List campaigns for the authenticated Bitly user, optionally filtered by group GUID. This endpoint has no documented pagination controls. Requires a Bitly plan with campaign access; upgrade the connected account if Bitly returns 402.

List ChannelsReads only

List channels available to the authenticated Bitly user, optionally filtered by group GUID and campaign GUID. Use the returned channel GUIDs when working with campaigns. This endpoint has no documented pagination controls. Requires a Bitly plan with channel access; upgrade the connected account if Bitly returns 402.

List Custom DomainsReads only

List custom domains with verification states, group assignments, HTTPS settings, deep-link applications, and SSL certificate details. Optionally filter by organization GUID; otherwise returns domains for every organization where the authenticated caller is an admin. Organizations where the caller is not an admin are excluded. No pagination controls are documented. Account entitlements apply; upgrade the connected Bitly plan if Bitly returns 402.

List QR CodesReads only

List one page of QR codes in a Bitly group in reverse chronological order, optionally filtering by search text, destination, creation time, creator, tags, QR type, customization, GS1, archive, expiration, or dynamic routing status. Pass pagination.search_after back as search_after with the same filters to continue. Returns metadata, not images. The connected account must have access to the group; feature availability depends on the Bitly plan.

List Site TemplatesReads only

List available Bitly Site templates, optionally by onboarding category. Use a returned template_guid to apply a template to a site. Availability and use of paid templates depend on the connected account's Bitly plan.

List SitesReads only

List one page of active Bitly Sites owned by a group, optionally filtered by site URL. Pass pagination.search_after as search_after to request the next page. Availability depends on the connected account's Bitly plan.

List Sorted BitlinksReads only

Retrieve a group's Bitlinks ranked by clicks for a time window. Preserve the sorted_links order and join its IDs to links metadata by id, not array position. Returns one size-limited result with no documented continuation token. Requires access to the group and the appropriate Bitly analytics entitlement; upgrade the connected plan if Bitly returns 402.

List WebhooksReads only

List all webhooks available for a Bitly organization by organization GUID. This endpoint has no documented query filters or pagination controls. Requires a Bitly plan with webhook access; upgrade the connected account if Bitly returns 402.

Prevalidate Site YouTube VideoReads only

Validate a YouTube video ID and construct the content needed for a Bitly Site YouTube video button without creating the button. Requires access to the site and the applicable Bitly Sites plan entitlement.

Publish Site

Publish a Bitly Site's draft, replacing the production site when changes have been made. Returns the site's publication and content settings. Availability depends on the connected account's Bitly plan.

Redirect QR Code

Change the destination URL of a stand-alone Bitly QR code by QR code ID. QR codes already associated with a Bitlink must be updated via the Bitlinks API instead. Returns updated QR metadata, not an image. Redirecting a QR code may require a Bitly plan upgrade.

Register Domain

Register (purchase) a domain for a Bitly organization and configure its DNS. This creates a domain registration and consumes the organization's plan-included domain allowance; it is not a lookup or dry run. It is not a paid-domain checkout: Bitly rejects domains priced at or above the complimentary limit and requests after the included allowance is exhausted. Requires an organization admin and a plan with available included-domain entitlement. Obtain explicit user approval for registration and the agreements before calling. Select a domain from GET /domains and send agreement_keys from GET /domains/{domain}/agreements. DNS verification can take up to 48 hours; later read GET /custom_domains for validation_status.

Search DomainsReads only

Search domains Bitly can register for an organization. Returns available domain names and the status of the exact name searched for; this does not register or purchase a domain. Returns one set of up to 25 results with no documented pagination. Domain registration depends on organization plan entitlements; upgrade the connected Bitly plan if Bitly returns 402.

Shorten Link

Create an ordinary Bitly short link for a long URL in a specific group.

Update Bitlink

Update safe metadata or archive state for a Bitlink; this tool does not redirect destinations or configure advanced routing.

Update Campaign

Update a Bitly campaign's name, description, associated group, or channels. Supply campaign_guid and the fields to change; omitted fields are not sent. Returns the updated campaign details. Requires campaign access and a Bitly plan that includes campaigns; upgrade the plan if Bitly returns 402.

Update Channel

Update a Bitly channel's name, group, or Bitlink campaign associations and return its updated details; supplying Bitlinks replaces the channel's entire Bitlink membership. Requires channel access and a Bitly plan supporting channels; upgrade if Bitly returns 402.

Update Custom Bitlink

Move an existing custom keyword (back-half) to a different Bitlink. Supply custom_bitlink and the destination bitlink_id in domain/back-half form; their domains must match. Requires access to the Custom Domain and a Bitly plan with custom-link redirect entitlement. Returns the updated custom redirect, destination Bitlink, and redirect history.

Update Custom Domain

Change a verified Bitly custom domain's redirects and HTTPS/HSTS settings. Supply custom_domain and only the settings to change; an empty root_redirect or wildcard_redirect clears that redirect. Domains awaiting DNS verification cannot be updated. Requires an organization administrator and a Bitly plan with the appropriate custom-domain entitlement. Returns the updated domain.

Update Group

Update a Bitly group's name, associated organization, or branded short domains. Supply group_guid and the fields to change; omitted fields are not sent. Returns the updated group details. Requires permission to manage the group; availability depends on the connected account's Bitly plan.

Update Group Preferences

Update a Bitly group's preferred short domain. Requires access to the group; branded domain availability depends on the account's plan and configured domains.

Update QR Code

Update an existing Bitly QR code's title, appearance, archive status, expiration, tags, or dynamic routing rules by QR code ID. Returns QR metadata, not an image. Dynamic routing replaces all existing rules; an empty array clears them. Customizations and advanced features may require a Bitly plan upgrade.

Update Site

Update a Bitly Site's URI, display name, description, or attached QR code. Changing the URI creates a redirect from the previous URI. A QR code can only be attached when the site does not already have one. Availability depends on the connected account's Bitly plan.

Update Site Appearance

Update a Bitly Site's theme, layout, fonts, colors, images, header, buttons, and social icon appearance. Availability of appearance options depends on the connected account's Bitly plan. Bitly returns no site data on success.

Update Site Block

Update an existing Bitly Site block's content, appearance, schedule, active or pinned state, or parent container. Send content fields appropriate to the stored block type; the type is derived from the existing block and cannot be changed. Availability depends on the connected account's Bitly plan.

Update User

Update the authenticated Bitly user's display name or default group. Supply the fields to change; omitted fields are not sent. Returns the updated user profile and email details. Availability depends on the connected account's permissions and Bitly plan.

Update Webhook

Update an existing Bitly webhook's delivery destination, event, activity, organization, group, or OAuth settings. Supply webhook_guid for the path and guid for the required body identifier, plus the fields to change; omitted fields are not sent. Returns updated webhook details. Requires webhook access and a Bitly plan supporting webhooks; upgrade if Bitly returns 402. Receiver OAuth client secrets cannot be changed with this tool.

Upgrade QR Code to Bitlink

Upgrade a standalone (decoupled) QR code to a coupled QR code by associating it with its underlying Bitly short link. Returns Bitlink metadata, not a QR image. This consumes one encode from the organization's monthly Link limit; if the QR code is already coupled, no encode is consumed. Availability depends on your Bitly plan and remaining monthly Link quota.

Verify Webhook

Test an existing Bitly webhook's configuration by sending a ping event to its configured webhook URL. This sends an outbound request to the webhook receiver; it is not a read-only configuration check. Returns the webhook configuration and status. Requires access to the webhook and a Bitly plan supporting webhooks; upgrade your plan if Bitly returns 402.

More in Url shortener

See them all β†’

Your company, run by an AI team

Start your company

BRAINER

Continue to B.R.A.I.N.E.R.

Continue with Google or your email.

or