Bitly (version v1.*.*)

Add a Keyword to a Bitlink

Parameters

$body

The object used to add a custom Bitlink

Type: object

{
  "bitlink_id" : "string",
  "custom_bitlink" : "string"
}

Convert a long url to a Bitlink

Parameters

$body

The object used to create a Bitlink

Type: object

{
  "group_guid" : "string",
  "domain" : "string",
  "long_url" : "Required string"
}

create_campaign

Create a new campaign

Parameters

$body

The object used for creating/updating a campaign

Type: object

{
  "group_guid" : "string",
  "channel_guids" : [ "string" ],
  "name" : "string",
  "description" : "string"
}

create_channel

Create a new channel

Parameters

$body

The object used for creating/updating a channel

Type: object

{
  "group_guid" : "string",
  "created" : "ISO TIMESTAMP",
  "name" : "string",
  "guid" : "string",
  "modified" : "ISO_TIMESTAMP",
  "bitlinks" : [ {
    "campaign_guid" : "string",
    "bitlink_id" : "string"
  } ]
}

Convert a long url to a Bitlink and set additional parameters

Parameters

$body

The object used to create a Bitlink

Type: object

{
  "group_guid" : "string",
  "deeplinks" : [ {
    "install_url" : "string",
    "app_uri_path" : "string",
    "app_id" : "string",
    "install_type" : "string"
  } ],
  "domain" : "string",
  "title" : "string",
  "long_url" : "Required string",
  "tags" : [ "string" ]
}

This endpoint returns public information for a Bitlink.

Parameters

$body

The object used to expand a Bitlink

Type: object

{
  "bitlink_id" : "string"
}

This endpoint returns information for a Bitlink.

Parameters

A Bitlink made of the domain and hash

Type: string

get_campaign

Retrive details for a campaign

Parameters

campaign_guid (required)

A GUID for a Bitly campaign

Type: string

get_channel

Get a channel's details

Parameters

channel_guid (required)

A GUID for a Bitly Channel

Type: string

This will return the click counts for a specified Bitlink. This returns an array with clicks based on a date.

Parameters

A Bitlink made of the domain and hash

Type: string

unit (required)

A unit of time

Type: string

Potential values: minute, hour, day, week, month

units (required)

An integer representing the time units to query data for. pass -1 to return all units of time.

Type: integer

size

The quantity of items to be be returned

Type: integer

unit_reference

An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time.

Type: string

This will return the click counts for a specified Bitlink. This rolls up all the data into a single field of clicks.

Parameters

A Bitlink made of the domain and hash

Type: string

unit (required)

A unit of time

Type: string

Potential values: minute, hour, day, week, month

units (required)

An integer representing the time units to query data for. pass -1 to return all units of time.

Type: integer

size

The quantity of items to be be returned

Type: integer

unit_reference

An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time.

Type: string

Retrieve the details and history of a Custom Bitlink

Parameters

A Custom Bitlink made of the domain and keyword

Type: string

Get Click Metrics for a Custom Bitlink by historical Bitlink destinations

Parameters

A Custom Bitlink made of the domain and keyword

Type: string

get_group

Retrive details for a group

Parameters

group_guid (required)

A GUID for a Bitly group

Type: string

get_group_metrics_by_countries

This endpoint will return metrics about the countries referring click traffic rolled up to a Group

Parameters

group_guid (required)

A GUID for a Bitly group

Type: string

get_group_metrics_by_referring_networks

This endpoint will return metrics about the referring network click traffic rolled up to a Group

Parameters

group_guid (required)

A GUID for a Bitly group

Type: string

get_group_preferences

Retrieve preferences for a specific group

Parameters

group_guid (required)

A GUID for a Bitly group

Type: string

get_group_shorten_counts

Get all the shorten counts for a specific group

Parameters

group_guid (required)

A GUID for a Bitly group

Type: string

This endpoint will return metrics about the countries referring click traffic to a single Bitlink.

Parameters

A Bitlink made of the domain and hash

Type: string

unit (required)

A unit of time

Type: string

Potential values: minute, hour, day, week, month

units (required)

An integer representing the time units to query data for. pass -1 to return all units of time.

Type: integer

size

The quantity of items to be be returned

Type: integer

unit_reference

An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time.

Type: string

This endpoint will return metrics about the referrers referring click traffic to a single Bitlink.

Parameters

A Bitlink made of the domain and hash

Type: string

unit (required)

A unit of time

Type: string

Potential values: minute, hour, day, week, month

units (required)

An integer representing the time units to query data for. pass -1 to return all units of time.

Type: integer

size

The quantity of items to be be returned

Type: integer

unit_reference

An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time.

Type: string

This endpoint will group referrers metrics about a single Bitlink.

Parameters

A Bitlink made of the domain and hash

Type: string

unit (required)

A unit of time

Type: string

Potential values: minute, hour, day, week, month

units (required)

An integer representing the time units to query data for. pass -1 to return all units of time.

Type: integer

size

The quantity of items to be be returned

Type: integer

unit_reference

An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time.

Type: string

This endpoint will rollup the click counts to a referrer about a single Bitlink.

Parameters

A Bitlink made of the domain and hash

Type: string

unit (required)

A unit of time

Type: string

Potential values: minute, hour, day, week, month

units (required)

An integer representing the time units to query data for. pass -1 to return all units of time.

Type: integer

size

The quantity of items to be be returned

Type: integer

unit_reference

An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time.

Type: string

get_oauth_app

Retrieve the details for the provided OAuth App client ID

Parameters

client_id (required)

The client ID of an OAuth app

Type: string

get_organization

Retrive details for an organization

Parameters

organization_guid (required)

A GUID for a Bitly organization

Type: string

get_organization_shorten_counts

Retrieve all the shorten counts for a specific organization

Parameters

organization_guid (required)

A GUID for a Bitly organization

Type: string

get_user

This operation has no parameters

Retrieve a paginated collection of Bitlinks for a Group

Parameters

group_guid (required)

A GUID for a Bitly group

Type: string

archived

Whether or not to include archived bitlinks

Type: string

Potential values: on, off, both

campaign_guid

Filter to return only links for the given campaign GUID, can be provided

Type: string

channel_guid

Filter to return only links for the given channel GUID, can be provided, overrides all other parameters

Type: string

created_after

Timestamp as an integer unix epoch

Type: integer

created_before

Timestamp as an integer unix epoch

Type: integer

Type: string

Potential values: on, off, both

Filter to only Bitlinks that contain deeplinks

Type: string

Potential values: on, off, both

Filter to only Bitlinks that contain deeplinks configured with a custom domain

Type: string

Potential values: on, off, both

encoding_login

Filter by the login of the authenticated user that created the Bitlink

Type: array

[ "string" ]

keyword

Custom keyword to filter on history entries

Type: string

modified_after

Timestamp as an integer unix epoch

Type: integer

query

the value that you would like to search

Type: string

tags

filter by given tags

Type: array

[ "string" ]

list_bsds

This operation has no parameters

list_campaigns

Retrieve the campaigns for the current user

Parameters

group_guid

A GUID for a Bitly group

Type: string

list_channels

Retrieve the channels available to a user

Parameters

campaign_guid

A GUID for a Bitly campaign

Type: string

group_guid

A GUID for a Bitly group

Type: string

list_group_tags

Retrieve the currently used tags for a group

Parameters

group_guid (required)

A GUID for a Bitly group

Type: string

list_groups

Retrieve a list of Groups

Parameters

organization_guid

A GUID for a Bitly rganization

Type: string

list_organizations

This operation has no parameters

This will retrieve a paginated response for Bitlinks that are sorted for the Group

Parameters

group_guid (required)

A GUID for a Bitly group

Type: string

sort (required)

The type of sorting that you would like to do

Type: string

Potential values: clicks

unit (required)

A unit of time

Type: string

Potential values: minute, hour, day, week, month

units (required)

An integer representing the time units to query data for. pass -1 to return all units of time.

Type: integer

size

The quantity of items to be be returned

Type: integer

unit_reference

An ISO-8601 timestamp, indicating the most recent time for which to pull metrics. Will default to current time.

Type: string

Update fields in the Bitlink

Parameters

A Bitlink made of the domain and hash

Type: string

$body

The object used to update attributes on a Bitlink

Type: object

{
  "references" : "object",
  "archived" : "boolean",
  "deeplinks" : [ {
    "app_guid" : "string",
    "bitlink" : "string",
    "install_url" : "string",
    "os" : "string",
    "created" : "ISO timestamp",
    "app_uri_path" : "string",
    "modified" : "ISO timestamp",
    "guid" : "string",
    "install_type" : "string"
  } ],
  "custom_bitlinks" : [ "string" ],
  "link" : "string",
  "created_at" : "string",
  "id" : "string",
  "title" : "string",
  "long_url" : "string",
  "created_by" : "string",
  "client_id" : "string",
  "tags" : [ "string" ]
}

update_campaign

Update a campaign's details

Parameters

campaign_guid (required)

A GUID for a Bitly campaign

Type: string

$body

The object used for creating/updating a campaign

Type: object

{
  "group_guid" : "string",
  "channel_guids" : [ "string" ],
  "name" : "string",
  "description" : "string"
}

update_channel

Update an existing Channel

Parameters

channel_guid (required)

A GUID for a Bitly Channel

Type: string

$body

The object used for creating/updating a channel

Type: object

{
  "group_guid" : "string",
  "created" : "ISO TIMESTAMP",
  "name" : "string",
  "guid" : "string",
  "modified" : "ISO_TIMESTAMP",
  "bitlinks" : [ {
    "campaign_guid" : "string",
    "bitlink_id" : "string"
  } ]
}

Move a Keyword to a different Bitlink

Parameters

A Custom Bitlink made of the domain and keyword

Type: string

$body

The object used to update a custom Bitlink

Type: object

{
  "bitlink_id" : "string"
}

update_group

Update the details of a group

Parameters

group_guid (required)

A GUID for a Bitly group

Type: string

$body

The object used for updating a group

Type: object

{
  "name" : "string",
  "organization_guid" : "string"
}

update_group_preferences

Update preferences for a specific group

Parameters

group_guid (required)

A GUID for a Bitly group

Type: string

$body

The object used to update group preferences

Type: object

{
  "group_guid" : "string",
  "domain_preference" : "string"
}

update_user

Update fields in the user

Parameters

$body

The object used for updating a user

Type: object

{
  "default_group_guid" : "string",
  "name" : "string"
}