GuidesAPI Reference

Creating a rule for country targeting

This method creates a new country targeting rule for given link

Suggest Edits

📘

Information below might be outdated - please visit our recently updated API Reference

The instruction below shows how to create a rule for country targeting for the existing URL.

1) Get your API key here: https://app.short.io/settings/integrations/api-key

  • Click "Create API key".
  • Add a Secret key.

2) Copy an ID of a short link you want to add a country targeting rule.

  • Open the statistics of the short link.
  • Copy the link ID.

3) ISO codes.

To create region targeting, you need to specify country ISO code and country region code in ISO-3166-2 format. Example: US (country) - United States; NY (region) - New York. You can find a necessary ISO code here: http://www.geonames.org

4) Install prerequisites for requests.

pip install requests

npm install --save axios

Now everything is ready to run the following snippet. It will create a country targeting rule for a short URL.

5) Create a file: filename.py/ .js/ .rb. Use the code snippet below.

📘

Please, replace LINK_ID, and ORIGINAL_URL with appropriate values.

import requests

url = "https://api.short.io/link_country/LINK_ID"

import json
payload = json.dumps({"country":"US","originalURL":"ORIGINAL_URL"})
headers = {
    'content-type': "application/json",
    'authorization': "<<apiKey>>"
    }

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)

const axios = require('axios');

const data = {
    "country":"US",
    "originalURL":"ORIGINAL_URL"
};

const options = {
  headers: {
    'content-type': 'application/json',
    authorization: '<<apiKey>>'
  }
};

axios.post('https://api.short.io/link_country/LINK_ID', data, options)
.then(function (response) {
  console.log(response.data);
})
.catch(function (response) {
  console.log(response);
});

require 'uri'
require 'net/http'
require 'openssl'
require 'json'

url = URI("https://api.short.io/link_country/LINK_ID")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["content-type"] = 'application/json'
request["authorization"] = '<<apiKey>>'
request.body = JSON.generate({"country":"US","originalURL":"ORIGINAL_URL"})

response = http.request(request)
puts response.read_body

6) Launch the file.

python filename.py

node filename.js

ruby filename.rb

7) JSON Response (country targeting is created).

Once you run the code, you will see the response. 

{
"id":24158
"LinkId":2950160
"country":"US"
"originalURL":"https://dash.readme.io"
"updatedAt":"2020-06-01T11:17:20.702Z"
"createdAt":"2020-06-01T11:17:20.702Z"
}

Updated 12 months ago