{ "info": { "name": "Bitly API v4", "_postman_id": "bitly", "description": "The complete Bitly v4 REST API. Generated by API Evangelist on 2026-08-13 from Bitly's published OpenAPI (https://dev.bitly.com/v4/v4.json).", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "item": [ { "name": "Bitly Bitlinks API", "item": [ { "name": "Create a Bitlink", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/bitlinks", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "bitlinks" ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } }, "description": "Converts a long url to a Bitlink and sets additional parameters. You may see errors returned from this endpoint - \"BRANDED_LINK_MONTHLY_LIMIT_EXCEEDED\" occurs if you have shortened more links than your account is configured for for the month, and \"DNS_CONFIGURATION_ERROR\" occurs if you are attempting to shorten links against a custom domain which doesn't have DNS properly configured." } }, { "name": "Delete a Bitlink", "request": { "method": "DELETE", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/bitlinks/{bitlink}", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "bitlinks", "{bitlink}" ] }, "description": "Delete an unedited hash Bitlink." } }, { "name": "Update a Bitlink", "request": { "method": "PATCH", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/bitlinks/{bitlink}", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "bitlinks", "{bitlink}" ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } }, "description": "Updates fields in the specified link. To redirect the link (i.e. to update the Long URL), use the long_url parameter. This will always charge an encode limit." } }, { "name": "Retrieve a Bitlink", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/bitlinks/{bitlink}", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "bitlinks", "{bitlink}" ] }, "description": "Returns information for the specified link." } }, { "name": "Get Metrics for a Bitlink by City", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/bitlinks/{bitlink}/cities", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "bitlinks", "{bitlink}", "cities" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns the city origins of click traffic for the specified link." } }, { "name": "Get Clicks for a Bitlink", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/bitlinks/{bitlink}/clicks", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "bitlinks", "{bitlink}", "clicks" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns the click counts for the specified link in an array based on a date." } }, { "name": "Get a Clicks Summary for a Bitlink", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/bitlinks/{bitlink}/clicks/summary", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "bitlinks", "{bitlink}", "clicks", "summary" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns the click counts for the specified link rolled up into a single field." } }, { "name": "Get Metrics for a Bitlink by Country", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/bitlinks/{bitlink}/countries", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "bitlinks", "{bitlink}", "countries" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns the country origins of click traffic for the specified link." } }, { "name": "Get Metrics for a Bitlink by Device Type", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/bitlinks/{bitlink}/devices", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "bitlinks", "{bitlink}", "devices" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns the device types generating click traffic to the specified link." } }, { "name": "Get Engagement Counts for a Bitlink", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/bitlinks/{bitlink}/engagements", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "bitlinks", "{bitlink}", "engagements" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns an array of engagement counts for the specified link. The array is comprised of button click, click and scan counts for each time window, where the window is based on the provided unit." } }, { "name": "Get an Engagement Count Summary for a Bitlink", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/bitlinks/{bitlink}/engagements/summary", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "bitlinks", "{bitlink}", "engagements", "summary" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns the engagement counts for the specified link rolled up into a single field." } }, { "name": "Get Metrics for a Bitlink by Referrer Name", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/bitlinks/{bitlink}/referrer_name", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "bitlinks", "{bitlink}", "referrer_name" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns referrer click counts for the specified link." } }, { "name": "Get Metrics for a Bitlink by Referrers", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/bitlinks/{bitlink}/referrers", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "bitlinks", "{bitlink}", "referrers" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns referrer click counts for the specified link." } }, { "name": "Get Metrics for a Bitlink by Referrers by Domain", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/bitlinks/{bitlink}/referrers_by_domains", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "bitlinks", "{bitlink}", "referrers_by_domains" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns click metrics grouped by referrers for the specified link." } }, { "name": "Get Metrics for a Bitlink by Referring Domains", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/bitlinks/{bitlink}/referring_domains", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "bitlinks", "{bitlink}", "referring_domains" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns the referring domain click counts for the specified link." } }, { "name": "Expand a Bitlink", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/expand", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "expand" ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } }, "description": "Returns the short link and long URL for the specified link." } }, { "name": "Retrieve Bitlinks by Group", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/bitlinks", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "bitlinks" ], "query": [ { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "search_after", "value": "", "description": "Token used to search next batch, only use response from API as input value." }, { "key": "query", "value": "", "description": "The value that you would like to search" }, { "key": "hostname_path_query", "value": "", "description": "The hostname and/or path you would like to search (case-insensitive). Subdomains included; query params and fragment ignored." }, { "key": "created_before", "value": "", "description": "Timestamp as an integer unix epoch (seconds only)" }, { "key": "created_after", "value": "", "description": "Timestamp as an integer unix epoch (seconds only)" }, { "key": "archived", "value": "", "description": "Whether or not to include archived resources" }, { "key": "deeplinks", "value": "", "description": "Filter to only Bitlinks that contain deeplinks" }, { "key": "domain_deeplinks", "value": "", "description": "Filter to only Bitlinks that contain deeplinks configured with a custom domain" }, { "key": "campaign_guid", "value": "", "description": "Filter to return only links for the given campaign GUID, can be provided" }, { "key": "channel_guid", "value": "", "description": "Filter to return only links for the given channel GUID, can be provided, overrides all other parameters" }, { "key": "custom_bitlink", "value": "", "description": "" }, { "key": "has_qr_codes", "value": "", "description": "a filter value if the resource has any QR codes" }, { "key": "is_expired", "value": "", "description": "filter bitlinks by expiration status" }, { "key": "has_expiration", "value": "", "description": "filter bitlinks by presence of expiration" }, { "key": "has_dynamic_routing", "value": "", "description": "filter bitlinks by presence of dynamic routing rules" }, { "key": "tags", "value": "", "description": "Filter by given tags" }, { "key": "launchpad_ids", "value": "", "description": "Filter by launchpad id" }, { "key": "encoding_login", "value": "", "description": "Filter by the login of the authenticated user that created the Bitlink" } ] }, "description": "Returns a paginated collection of Bitlinks for a group. The list of custom bitlinks has newest entries first." } }, { "name": "Bulk update bitlinks", "request": { "method": "PATCH", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/bitlinks", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "bitlinks" ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } }, "description": "Bulk update can add or remove tags or archive up to 100 links at a time; The response includes a list of bitlink ids that were updated." } }, { "name": "Retrieve Sorted Bitlinks for Group", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/bitlinks/{sort}", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "bitlinks", "{sort}" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time." }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" } ] }, "description": "Returns a list of Bitlinks sorted by group. The list of custom bitlinks has newest entries first." } }, { "name": "Retrieve Top Links and Decoupled QR Codes by Engagements", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/engagements/sorted/top", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "engagements", "sorted", "top" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time." }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" } ] }, "description": "Returns the bitlinks and decoupled QR codes in a group with the most engagements over the requested time window, ranked together in descending order by engagement count. Bitlinks and decoupled QR codes are returned in separate lists; `sorted_links` preserves the unified descending-by-count ordering across both, with each entry's id referencing either a bitlink or a QR code guid.\n" } }, { "name": "Shorten a Link", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/shorten", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "shorten" ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } }, "description": "Converts a long url to a Bitlink. You may see errors returned from this endpoint - \"BRANDED_LINK_MONTHLY_LIMIT_EXCEEDED\" occurs if you have shortened more links than your account is configured for for the month, and \"DNS_CONFIGURATION_ERROR\" occurs if you are attempting to shorten links against a custom domain which doesn't have DNS properly configured." } } ] }, { "name": "Bitly BSDs API", "item": [ { "name": "Get BSDs", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/bsds", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "bsds" ] }, "description": "Fetch all Branded Short Domains" } } ] }, { "name": "Bitly Campaigns API", "item": [ { "name": "Retrieve Campaigns", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/campaigns", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "campaigns" ], "query": [ { "key": "group_guid", "value": "", "description": "A GUID for a Bitly group" } ] }, "description": "Returns the campaigns for the current authenticated user." } }, { "name": "Create Campaign", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/campaigns", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "campaigns" ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } }, "description": "Creates a new campaign." } }, { "name": "Retrieve a Campaign", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/campaigns/{campaign_guid}", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "campaigns", "{campaign_guid}" ] }, "description": "Returns details for a campaign." } }, { "name": "Update Campaign", "request": { "method": "PATCH", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/campaigns/{campaign_guid}", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "campaigns", "{campaign_guid}" ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } }, "description": "Updates a campaign's details." } }, { "name": "Retrieve Channels", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/channels", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "channels" ], "query": [ { "key": "group_guid", "value": "", "description": "A GUID for a Bitly group" }, { "key": "campaign_guid", "value": "", "description": "A GUID for a Bitly campaign" } ] }, "description": "Returns the channels available to a user." } }, { "name": "Create Channel", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/channels", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "channels" ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } }, "description": "Creates a new channel." } }, { "name": "Get a Channel", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/channels/{channel_guid}", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "channels", "{channel_guid}" ] }, "description": "Returns a channel's details." } }, { "name": "Update a Channel", "request": { "method": "PATCH", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/channels/{channel_guid}", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "channels", "{channel_guid}" ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } }, "description": "Updates an existing channel." } } ] }, { "name": "Bitly Custom Bitlinks API", "item": [ { "name": "Add Custom Bitlink", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/custom_bitlinks", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "custom_bitlinks" ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } }, "description": "Add a keyword (or \"custom back-half\") to a Bitlink with a Custom Domain (domains must match). This endpoint can also be used for initial redirects to a link." } }, { "name": "Update Custom Bitlink", "request": { "method": "PATCH", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/custom_bitlinks/{custom_bitlink}", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "custom_bitlinks", "{custom_bitlink}" ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } }, "description": "Move a keyword (or custom back-half) to a different Bitlink (domains must match)." } }, { "name": "Retrieve Custom Bitlink", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/custom_bitlinks/{custom_bitlink}", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "custom_bitlinks", "{custom_bitlink}" ] }, "description": "Returns the details and history of the specified link." } }, { "name": "Get Clicks for a Custom Bitlink's Entire History", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/custom_bitlinks/{custom_bitlink}/clicks", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "custom_bitlinks", "{custom_bitlink}", "clicks" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns the click counts for the specified link. This returns an array with clicks based on a date." } }, { "name": "Get Metrics for a Custom Bitlink by Destination", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/custom_bitlinks/{custom_bitlink}/clicks_by_destination", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "custom_bitlinks", "{custom_bitlink}", "clicks_by_destination" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns click metrics for the specified link by its historical destinations." } } ] }, { "name": "Bitly Groups API", "item": [ { "name": "Retrieve Groups", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups" ], "query": [ { "key": "organization_guid", "value": "", "description": "A GUID for a Bitly organization" } ] }, "description": "Returns a list of groups in the organization." } }, { "name": "Update a Group", "request": { "method": "PATCH", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}" ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } }, "description": "Updates the details of a group." } }, { "name": "Retrieve a Group", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}" ] }, "description": "Returns details for a group." } }, { "name": "Get Click Metrics for a Group by City", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/cities", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "cities" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns the geographic origins of click traffic by city for the specified group." } }, { "name": "Get clicks by group", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/clicks", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "clicks" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "get number of clicks on bitlinks in a group" } }, { "name": "Get Scan Metrics for a Group by City", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/codes/scans/cities", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "codes", "scans", "cities" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Get QR code scan metrics for a group broken down by city." } }, { "name": "Get Scan Metrics for a Group by Country", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/codes/scans/countries", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "codes", "scans", "countries" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Get QR code scan metrics for a group broken down by country." } }, { "name": "Get Scan Metrics for a Group Over Time", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/codes/scans/over_time", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "codes", "scans", "over_time" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Get QR code scan metrics over time for a group." } }, { "name": "Get Top Performing QR Codes for a Group", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/codes/scans/top", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "codes", "scans", "top" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" }, { "key": "decoupled", "value": "", "description": "When true, ranks results by decoupled QR scan count and returns a TopLinksAndQRCodes response with links and QR codes partitioned into separate lists and a unified sorted_engagements ordering.\n" } ] }, "description": "Get top performing QR codes by scan count for all codes in a group." } }, { "name": "Get Click Metrics for a Group by Country", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/countries", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "countries" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns the geographic origins of click traffic by country for the specified group." } }, { "name": "Get Click Metrics for a Group by Device Type", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/devices", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "devices" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns the device types generating click traffic to the specified group's links." } }, { "name": "Get Group Metrics Over Time", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/engagements/over_time", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "engagements", "over_time" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Get group engagement metrics over time for all links in a group." } }, { "name": "Get Group Top Performing Links by Engagement", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/engagements/top", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "engagements", "top" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Get top performing links by engagement for all links in a group." } }, { "name": "Create an inline CSV export for a group", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/exports", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "exports" ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } }, "description": "Build a CSV export synchronously and return it inline as a base64 data URI plus metadata.\nThe export_type field selects the CSV shape: link_engagements_batch (engagement metrics for\nexplicit bitlinks or a filter), links_list (link metadata roster), or qr_codes_list (QR code\nmetadata roster). Row caps apply per request: 200 rows when metrics are included\n(link_engagements_batch, or include_metrics on a list export); 1000 rows for metadata-only\nlist exports. When the match set exceeds the cap, truncated is true and only the first\ncap rows are returned; row_count reports how many data rows are in the CSV.\n" } }, { "name": "Get limit usage for a group", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/feature_usage", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "feature_usage" ], "query": [ { "key": "name", "value": "", "description": "The limit name you would like usage for" } ] }, "description": "Get a group's current feature limit usage, optionally provide limit name(s) for usage on specific limit(s)" } }, { "name": "Get historical usage for a group", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/historical_usage", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "historical_usage" ], "query": [ { "key": "name", "value": "", "description": "The limit name you would like usage for" }, { "key": "start_date", "value": "", "description": "The start date for the date range" }, { "key": "end_date", "value": "", "description": "The end date for the date range" }, { "key": "unit", "value": "", "description": "A unit of time (day, week, or month)" } ] }, "description": "Get a group's historical usage for specific limit(s) and date range. Refer to GET /v4/groups/{group_guid}/feature_usage endpoint response for available limit names." } }, { "name": "Get Group Link Clicks by City", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/links/clicks/cities", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "links", "clicks", "cities" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Get link clicks by city for all links in a group." } }, { "name": "Get Group Link Clicks by Country", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/links/clicks/countries", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "links", "clicks", "countries" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Get link clicks by country for all links in a group." } }, { "name": "Get Group Link Clicks by Device", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/links/clicks/devices", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "links", "clicks", "devices" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Get link clicks by device for all links in a group." } }, { "name": "Get Group Link Clicks Over Time", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/links/clicks/over_time", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "links", "clicks", "over_time" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Get link clicks over time for all links in a group." } }, { "name": "Get Group Link Clicks by Referrer", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/links/clicks/referrers", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "links", "clicks", "referrers" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Get link clicks by referrer for all links in a group." } }, { "name": "Get Group Top Performing Links by Click", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/links/clicks/top", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "links", "clicks", "top" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Get top performing links by click for all links in a group." } }, { "name": "Retrieve Group Preferences", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/preferences", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "preferences" ] }, "description": "Returns preferences for the specified group." } }, { "name": "Update Group Preferences", "request": { "method": "PATCH", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/preferences", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "preferences" ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } }, "description": "Updates preferences for a group." } }, { "name": "Get Click Metrics for a Group by Referrer", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/referrers", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "referrers" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns metrics by referrer for the specified group's links." } }, { "name": "Get Click Metrics for a Group by Referring Networks", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/referring_networks", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "referring_networks" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns metrics by referring networks for the specified group's links." } }, { "name": "Retrieve Group Shorten Counts", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/shorten_counts", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "shorten_counts" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns all the shorten counts for a group." } }, { "name": "Retrieve Tags by Group", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/tags", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "tags" ], "query": [ { "key": "type", "value": "", "description": "Tag set to return; defaults to bitlink" } ] }, "description": "Returns the tags currently used in the specified group. Maximum 1000." } } ] }, { "name": "Bitly OAuth Apps API", "item": [ { "name": "Retrieve OAuth App", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/apps/{client_id}", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "apps", "{client_id}" ] }, "description": "Retrieve the details for the provided OAuth App client ID" } } ] }, { "name": "Bitly Organizations API", "item": [ { "name": "Retrieve Organizations", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/organizations", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "organizations" ], "query": [ { "key": "include_all", "value": "", "description": "When set to true, returns all of the user's organizations regardless of the token's allowed_orgs restrictions.\n" } ] }, "description": "Retrieve a list of organizations for the authenticated user. By default, only organizations permitted by the token's allowed_orgs are returned. Use include_all=true to return all organizations regardless of token restrictions. Each organization is annotated with its authentication requirements (require_sso, require_2fa) when configured.\n" } }, { "name": "Retrieve an Organization", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/organizations/{organization_guid}", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "organizations", "{organization_guid}" ] }, "description": "Retrive details for the specified organization." } }, { "name": "Get Plan Limits", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/organizations/{organization_guid}/plan_limits", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "organizations", "{organization_guid}", "plan_limits" ] }, "description": "Returns all plan limits and counts available for an organization." } }, { "name": "Get Shorten Counts for an Organization", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/organizations/{organization_guid}/shorten_counts", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "organizations", "{organization_guid}", "shorten_counts" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns the shorten counts for a specific organization over a specified time period." } }, { "name": "Get Shorten Counts for an Organization by Group", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/organizations/{organization_guid}/shorten_counts_by_group", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "organizations", "{organization_guid}", "shorten_counts_by_group" ] }, "description": "Returns the shorten counts for a specific organization by group for the current month." } } ] }, { "name": "Bitly QR Codes API", "item": [ { "name": "Retrieve QR Codes by Group", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/qr-codes", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "qr-codes" ], "query": [ { "key": "has_render_customizations", "value": "", "description": "Whether or not QRCode has any render customizations (like color or shape changes)" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "search_after", "value": "", "description": "Token used to search next batch of qr codes, only use response from API as input value." }, { "key": "query", "value": "", "description": "The value that you would like to search" }, { "key": "hostname_path_query", "value": "", "description": "The hostname and/or path you would like to search (case-insensitive). Subdomains included; query params and fragment ignored." }, { "key": "created_before", "value": "", "description": "Timestamp as an integer unix epoch (seconds only)" }, { "key": "created_after", "value": "", "description": "Timestamp as an integer unix epoch (seconds only)" }, { "key": "archived", "value": "", "description": "Whether or not to include archived resources" }, { "key": "creating_login", "value": "", "description": "Filter by the login of the authenticated user that created the QR Code" }, { "key": "qrc_type", "value": "", "description": "" }, { "key": "is_gs1", "value": "", "description": "a filter value if the resource is a GS1 QR code" }, { "key": "is_expired", "value": "", "description": "filter bitlinks by expiration status" }, { "key": "has_expiration", "value": "", "description": "filter bitlinks by presence of expiration" }, { "key": "has_dynamic_routing", "value": "", "description": "filter bitlinks by presence of dynamic routing rules" }, { "key": "tags", "value": "", "description": "Filter by given tags" } ] }, "description": "Retrieves a list of QR codes matching the filter settings. Values are in reverse chronological order.\nThe pagination occurs by calling the next link in the pagination response object.\n" } }, { "name": "Bulk update QR codes", "request": { "method": "PATCH", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/groups/{group_guid}/qr-codes", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "groups", "{group_guid}", "qr-codes" ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } }, "description": "Bulk update can add or remove tags, or archive/un-archive, up to 100 QR codes at a time.\nPages QR codes cannot be updated with this endpoint.\nThe response includes a list of QR code ids that were updated.\n" } }, { "name": "Create a QR Code", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/qr-codes", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "qr-codes" ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } }, "description": "Create a new QR Code and return its metadata" } }, { "name": "Generate a static QR Code image", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/qr-codes/static", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "qr-codes", "static" ], "query": [ { "key": "format", "value": "", "description": "The image format. Supports `svg` and `png`. Ignored if the Accept header specifies an image type." } ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } }, "description": "Generate a static QR code image without creating or saving a QR code resource. SVG and PNG output are supported via the Accept header\nContact your Account Manager to discuss enabling this feature for your account.\n\nThe `render_customizations` field supports basic appearance options. Customizations that require the rasterize API are not supported: `gradient`, `background_gradient`, `frame`, `text`, and `logo`.\n\nThe Accept header controls the response format:\n- `application/json` (default): Returns a JSON object with the image as a base64-encoded byte string.\n- `image/svg+xml`: Returns the raw SVG image.\n- `image/png`: Returns the raw PNG image.\n" } }, { "name": "Update a QR Code", "request": { "method": "PATCH", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/qr-codes/{qrcode_id}", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "qr-codes", "{qrcode_id}" ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } }, "description": "Updates the QR code with a matching id and returns it." } }, { "name": "Retrieve a QR Code", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/qr-codes/{qrcode_id}", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "qr-codes", "{qrcode_id}" ] }, "description": "Gets the QR code with a matching id." } }, { "name": "Delete a QR Code", "request": { "method": "DELETE", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/qr-codes/{qrcode_id}", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "qr-codes", "{qrcode_id}" ] }, "description": "Delete a QR Code that has not been redirected and is not for a custom link. Also deletes the associated link (if applicable)." } }, { "name": "Retrieve a QR Code image", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/qr-codes/{qrcode_id}/image", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "qr-codes", "{qrcode_id}", "image" ], "query": [ { "key": "format", "value": "", "description": "The format type of the image. If there is an image format in the header it takes precedence." } ] }, "description": "Get the image of a given QR Code. The Accept header controls how this is returned (options are \"application/json\", \"image/svg+xml\", and \"image/png\").\nIf the Accept header is \"application/json\" the format query parameter will determine the image format inside of the json (which will be base64 encoded and prefixed with its mime type as would be suitable for a HTML image src tag).\nTo Return the QR Code image itself, set the Accept header to \"image/svg+xml\" or \"image/png\", or remove the Accept header and set the format query parameter to \u201csvg\u201d or \u201cpng\u201d (if no format is specified the default will be \u201csvg\u201d).\n" } }, { "name": "Redirect a QR Code", "request": { "method": "PATCH", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/qr-codes/{qrcode_id}/redirect", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "qr-codes", "{qrcode_id}", "redirect" ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } }, "description": "Changes the destination URL that a stand alone QR Code redirects to. This only works for stand alone QR Codes; a QR Code already associated with a bitlink must be updated via the Bitlinks API." } }, { "name": "Get Scans for a QR Code", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/qr-codes/{qrcode_id}/scans", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "qr-codes", "{qrcode_id}", "scans" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns an array of scan counts for the specified QR code. The array is comprised of scan counts for each time window, where the window is based on the provided unit." } }, { "name": "Get Scans for a QR Code by Browser", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/qr-codes/{qrcode_id}/scans/browsers", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "qr-codes", "{qrcode_id}", "scans", "browsers" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns the browsers generating scan traffic to the specified QR Code." } }, { "name": "Get Metrics for a QR Code by City", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/qr-codes/{qrcode_id}/scans/cities", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "qr-codes", "{qrcode_id}", "scans", "cities" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns the city origins of scan traffic for the specified QR Code." } }, { "name": "Get Scans for a QR Code by Country", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/qr-codes/{qrcode_id}/scans/countries", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "qr-codes", "{qrcode_id}", "scans", "countries" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns the country origins of scan traffic for the specified QR Code." } }, { "name": "Get Scans for a QR Code by Device OS", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/qr-codes/{qrcode_id}/scans/device_os", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "qr-codes", "{qrcode_id}", "scans", "device_os" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "size", "value": "", "description": "The quantity of items to be be returned" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns the device os generating scan traffic for the specified QR Code." } }, { "name": "Get Scans Summary for a QR Code", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/qr-codes/{qrcode_id}/scans/summary", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "qr-codes", "{qrcode_id}", "scans", "summary" ], "query": [ { "key": "unit", "value": "", "description": "A unit of time" }, { "key": "units", "value": "", "description": "An integer representing the time units to query data for. pass -1 to return all units of time" }, { "key": "unit_reference", "value": "", "description": "An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time. Timestamp values should be url encoded (i.e. replace '+' with '%2B' and ':' with '%3A'; 2022-02-02T15:53:02+0000 becomes 2022-02-02T15%3A53%3A02%2B0000)" } ] }, "description": "Returns the scan counts for a QR Code rolled up into a single field for a specified time window, where the window is based on the provided unit." } }, { "name": "Upgrade a QR Code to a bitlink", "request": { "method": "PUT", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/qr-codes/{qrcode_id}/to-bitlink", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "qr-codes", "{qrcode_id}", "to-bitlink" ] }, "description": "Upgrades a stand alone (decoupled) QR Code to a coupled QR Code by associating it with its underlying Bitly short link. This operation consumes one encode from the organization's monthly Link limit. If the QR Code is already coupled, no encode is consumed." } } ] }, { "name": "Bitly User API", "item": [ { "name": "Update a User", "request": { "method": "PATCH", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/user", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "user" ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } }, "description": "Update fields in the user" } }, { "name": "Retrieve a User", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/user", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "user" ] }, "description": "Returns information for the current authenticated user." } }, { "name": "Get Platform Limits", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/user/platform_limits", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "user", "platform_limits" ], "query": [ { "key": "path", "value": "", "description": "The specific path for which information is requested" } ] }, "description": "Fetch all platform limits and counts available for an organization" } } ] }, { "name": "Bitly Webhooks API", "item": [ { "name": "Get Webhooks", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/organizations/{organization_guid}/webhooks", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "organizations", "{organization_guid}", "webhooks" ] }, "description": "Fetch all webhooks available for an Organization" } }, { "name": "Create Webhook", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/webhooks", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "webhooks" ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } }, "description": "Creates a webhook." } }, { "name": "Retrieve Webhook", "request": { "method": "GET", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/webhooks/{webhook_guid}", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "webhooks", "{webhook_guid}" ] }, "description": "Returns a webhook." } }, { "name": "Update Webhook", "request": { "method": "PATCH", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/webhooks/{webhook_guid}", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "webhooks", "{webhook_guid}" ] }, "body": { "mode": "raw", "raw": "{}", "options": { "raw": { "language": "json" } } }, "description": "Update a webhook" } }, { "name": "Delete Webhook", "request": { "method": "DELETE", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/webhooks/{webhook_guid}", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "webhooks", "{webhook_guid}" ] }, "description": "Deletes a webhook." } }, { "name": "Verify Webhook", "request": { "method": "POST", "header": [ { "key": "Authorization", "value": "Bearer {{bitly_token}}" } ], "url": { "raw": "https://api-ssl.bitly.com/v4/webhooks/{webhook_guid}/verify", "protocol": "https", "host": [ "api-ssl", "bitly", "com" ], "path": [ "v4", "webhooks", "{webhook_guid}", "verify" ] }, "description": "Sends ping event to test webhook configuration." } } ] } ], "variable": [ { "key": "baseUrl", "value": "https://api-ssl.bitly.com/v4" }, { "key": "bitly_token", "value": "" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bitly_token}}", "type": "string" } ] } }