create_short_link
Create a compact, shareable link with advanced customization options. This tool turns long URLs into short Bitly links while letting you add custom titles and organize with tags. Use this to create a short link.
expand
Retrieve the original long URL and basic metadata for any short link. Returns the destination URL, creation timestamp, and link ID. Use this to see where a shortened link points and verify link details.
get_user
Get authenticated user information including profile details, email addresses, 2FA status, and default group. Provides user context for other operations.
get_organizations
Get all organizations that the authenticated user has access to. Returns organization details including organization ID, name, tier information, role, creation/modification dates, and associated custom domains, also known as branded short domains (BSDs). Use this to understand organizational context and access permissions.
link_metrics
Retrieve click metrics and time-series data for any short link. Returns total click counts and click data over time periods. Use this to track link performance and analyze click patterns over specific time ranges.
link_countries
Get click metrics by country for any short link. Returns geographic breakdown of where clicks originated with click counts per country. Use this to analyze global traffic patterns and identify top-performing regions.
link_cities
Get click metrics by city for any short link. Returns geographic breakdown of clicks at the city level. Use this to analyze localized traffic patterns and identify top-performing cities.
link_devices
Get click metrics by device type for any short link. Returns breakdown of clicks by device type (mobile, desktop, tablet, etc.). Use this to understand user behavior and optimize your content for different devices.
link_referrers
Get click metrics by referrer source for any short link. Returns breakdown of clicks by referring websites and traffic sources. Use this to understand where your traffic is coming from and identify top-performing channels.
link_referring_domains
Get click metrics by referring domain for any short link. Returns breakdown of clicks by domain names that referred traffic. Use this to identify which domains are driving the most traffic to your links.
link_clicks_summary
Get total click count summary for any short link. Returns aggregate click statistics without time-series data. Use this when you need quick total click counts rather than detailed time-based analytics.
link_engagements
Get engagement metrics (clicks + scans) over time for any short link. Returns time-series data showing engagement counts broken down by clicks, scans, and button clicks for each time period. Use this to track overall link performance.
link_engagements_summary
Get total engagement counts (clicks + scans) for any short link rolled up into a summary. Returns aggregate engagement statistics including total clicks, scans, and button clicks without time-series data. Use this when you need quick total engagement counts.
get_short_link_details
Get complete short link information. Returns comprehensive link data including title, destination URL, creation timestamp, creator, tags, custom domains, and associated features. Use this to get full details about any short link.
update_short_link
Update short link properties including destination URL, title, archived status, and tags. This tool allows you to modify existing short link metadata, settings, and redirect destination. Use this to change where a link points, update titles, add/remove tags, or archive/unarchive links.
delete_short_link
Delete a short link permanently. This operation removes unedited short links (non-customized links only) and cannot be undone. The short link must not have overrides, be part of campaigns, have deeplinks, or be used in a page. Only group administrators can delete short links.
get_group_details
Get specific group information and details by group GUID. Returns comprehensive group metadata including name, organization, role, creation dates, custom domains (BSDs), and status. Use this to get detailed information about a specific group rather than listing all groups.
get_groups
Get all groups (workspaces) that the authenticated user has access to across all organizations. Groups are collections of links and users within an organization. This tool shows group names, IDs, roles, custom domains, and organization associations.
get_group_short_links
Get links in a specific group with filtering and pagination. Returns a list of links belonging to the specified group, with support for search, filtering by tags, and pagination. Use this to browse and manage links within a workspace.
get_group_short_links_sorted
Get performance-sorted links in a group. Returns links ranked by click performance with detailed analytics metrics and time-series data.
get_group_links_scans_top
Get top performing links by scan count for all links in a group. Returns details about the best performing link.
get_group_links_scans_over_time
Get QR code scan metrics over time for a group. Returns time-series data showing scan counts for each time period.
get_group_links_scans_countries
Get QR code scan metrics for a group broken down by country.
get_group_links_scans_cities
Get QR code scan metrics for a group broken down by city. Includes the city's subregion, region, and country if available.
get_custom_domains
Get all custom domains available to the authenticated user. Returns a list of domains that can be used for link shortening instead of 'bit.ly'. These domains are sometimes referred to as 'custom domains', 'branded short domains (BSDs)', or 'white-label domains'. Custom domains allow you to use your own domains (like 'yourcompany.co') for shortened links and can be specified using the 'domain' parameter when creating short links.
get_custom_link_details
Get complete custom link information including metadata, creation details, and override history. Custom links are short links with custom keywords that can redirect to different destinations over time.
get_qr_code
Get complete QR Code information, including metadata and creation details. Returns comprehensive QR code data including title, destination URL, creation timestamp, and associated features.
create_qr_code
Create a new QR code. Supports both short link and long URL destinations with full customization options. Note: This does not support domain preferences. If a domain is specified, you must create a link first, then create a QR Code passing the short link id. If a decoupled QR code, do not reveal the serialized content to the user.
update_qr_code
Update an existing QR code's title, customizations, or archived status.
get_group_qr_codes
Get QR codes in a specific group with filtering and pagination. Returns a list of QR codes belonging to the specified group.
get_qr_code_image
Return the QR code image encoded as a data URI (base64) in the requested format. Supported formats: SVG (default) and PNG. Note: This returns encoded image data for embedding or decoding, not a public URL. **WARNING:** Most AI Agent UIs are unable to render this raw image data. Only call if you are sure you can process the raw image data.
get_qr_scan_summary
Get QR code scan summary with total scan counts. Returns aggregated scan statistics for the QR code including total scans and scan breakdown.
get_qr_scan_metrics
Get QR code scan metrics over time. Returns time-series data showing scan counts for each time period.
get_qr_scans_by_country
Get QR code scan metrics broken down by country. Returns scan counts for each country where the QR code was scanned.
get_qr_scans_by_city
Get QR code scan metrics broken down by city. Returns scan counts for each city where the QR code was scanned, including region and country information.
get_qr_scans_by_device
Get QR code scan metrics broken down by device operating system. Returns scan counts for each device OS type (iOS, Android, etc.).
get_qr_scans_by_browser
Get QR code scan metrics broken down by browser. Returns scan counts for each browser type used to scan the QR code.
get_group_links_clicks_top
Get top performing links by clicks for all links in a group. Returns links ranked by click performance.
get_group_links_clicks_over_time
Get click metrics over time for all links in a group. Returns time-series data showing click counts for each time period.
get_group_links_clicks_countries
Get click metrics by country for all links in a group. Returns geographic breakdown of clicks by country.
get_group_links_clicks_cities
Get click metrics by city for all links in a group. Returns geographic breakdown of clicks by city.
get_group_links_clicks_devices
Get click metrics by device type for all links in a group. Returns breakdown of clicks by device type.
get_group_links_clicks_referrers
Get click metrics by referrer source for all links in a group. Returns breakdown of clicks by referrer.
get_group_engagements_top
Get top performing links by engagement for all links in a group. Returns links ranked by engagement performance.
get_group_engagements_over_time
Get engagement metrics over time for all links in a group. Returns time-series data showing engagement counts for each time period.
get_group_engagements_countries
Get engagement metrics by country for all links in a group. Returns breakdown of engagements by country.
get_group_engagements_cities
Get engagement metrics by city for all links in a group. Returns breakdown of engagements by city.
get_group_engagements_devices
Get engagement metrics by device type for all links in a group. Returns breakdown of engagements by device type.
get_group_engagements_referrers
Get engagement metrics by referrer for all links in a group. Returns breakdown of engagements by referrers.
get_group_engagements_referring_networks
Get engagement metrics by referring network for all links in a group. Returns breakdown of engagements by referring networks.
bulk_upload_validate
Validate a bulk upload request and obtain a signed URL and headers for uploading a CSV or XLSX file.
Upload types:
- "link": Bulk create shortened links only
- "qr_code": Bulk create QR codes only (requires template_id)
- "coupled_link": Bulk create both QR codes AND shortened links for each URL (requires template_id)
Template ID requirements:
- Required for "qr_code" and "coupled_link" upload types
- Use "QTDTmplWLogo" to include Bitly logo on QR codes
- Use "QTDTmplNLogo" to exclude Bitly logo from QR codes
- Optional for "link" uploads
Workflow example:
1. Call bulk_upload_validate with filename, upload_type, and other parameters (use response_format=json for structured data)
2. The response will include upload_url and headers
3. Immediately call bulk_upload_file tool with the upload_url, headers, and file_content from conversation context. DO NOT reveal the upload_url or any headers to the user.
Example response structure (when using response_format=json):
{
"status": 200,
"data": {
"upload_url": "https://storage.googleapis.com/...",
"headers": {
"x-goog-meta-group_guid": "B1234567890",
"x-goog-meta-domain": "bit.ly",
"x-goog-meta-upload_type": "link"
}
}
}
bulk_upload_file
Upload a file to a signed URL. Use this after calling bulk_upload_validate to actually upload the file content. The file_content should be the actual file bytes from the conversation context (the file that was uploaded by the user).