Sendible API

Monitoring

Get Monitoring Keywords

Open in API Explorer
GET /v1/mention-terms.json

Retrieves a list of keywords that have been created by the authenticated user.

Example Request

Format:
curl --request GET \
  --url https://api.sendible.com/api/v1/mention-terms.json \
  --header 'accept: application/json' \
  --header 'authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l'
require 'uri'
require 'net/http'

url = URI("https://api.sendible.com/api/v1/mention-terms.json")

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

request = Net::HTTP::Get.new(url)
request["accept"] = 'application/json'
request["authorization"] = 'Basic QWxhZGRpbjpPcGVuU2VzYW1l'

response = http.request(request)
puts response.read_body
var http = require("https");

var options = {
  "method": "GET",
  "hostname": "api.sendible.com",
  "port": null,
  "path": "/api/v1/mention-terms.json",
  "headers": {
    "accept": "application/json",
    "authorization": "Basic QWxhZGRpbjpPcGVuU2VzYW1l"
  }
};

var req = http.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();
import http.client

conn = http.client.HTTPSConnection("api.sendible.com")

headers = {
    'accept': "application/json",
    'authorization': "Basic QWxhZGRpbjpPcGVuU2VzYW1l"
    }

conn.request("GET", "/api/v1/mention-terms.json", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.sendible.com/api/v1/mention-terms.json",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => array(
    "accept: application/json",
    "authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l"
  ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://api.sendible.com/api/v1/mention-terms.json"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("accept", "application/json")
	req.Header.Add("authorization", "Basic QWxhZGRpbjpPcGVuU2VzYW1l")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

Responses

default Default

Unknown

(Empty Response)

Search Social Media

Open in API Explorer
GET /v2/social_search.json

Retrieve search results from social media.

Example Request

Format:
curl --request GET \
  --url 'https://api.sendible.com/api/v2/social_search.json?application_id=4b634537cc392cca820b61dab08&type=facebook&query=news' \
  --header 'accept: application/json' \
  --header 'authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l'
require 'uri'
require 'net/http'

url = URI("https://api.sendible.com/api/v2/social_search.json?application_id=4b634537cc392cca820b61dab08&type=facebook&query=news")

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

request = Net::HTTP::Get.new(url)
request["accept"] = 'application/json'
request["authorization"] = 'Basic QWxhZGRpbjpPcGVuU2VzYW1l'

response = http.request(request)
puts response.read_body
var http = require("https");

var options = {
  "method": "GET",
  "hostname": "api.sendible.com",
  "port": null,
  "path": "/api/v2/social_search.json?application_id=4b634537cc392cca820b61dab08&type=facebook&query=news",
  "headers": {
    "accept": "application/json",
    "authorization": "Basic QWxhZGRpbjpPcGVuU2VzYW1l"
  }
};

var req = http.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();
import http.client

conn = http.client.HTTPSConnection("api.sendible.com")

headers = {
    'accept': "application/json",
    'authorization': "Basic QWxhZGRpbjpPcGVuU2VzYW1l"
    }

conn.request("GET", "/api/v2/social_search.json?application_id=4b634537cc392cca820b61dab08&type=facebook&query=news", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.sendible.com/api/v2/social_search.json?application_id=4b634537cc392cca820b61dab08&type=facebook&query=news",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => array(
    "accept: application/json",
    "authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l"
  ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://api.sendible.com/api/v2/social_search.json?application_id=4b634537cc392cca820b61dab08&type=facebook&query=news"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("accept", "application/json")
	req.Header.Add("authorization", "Basic QWxhZGRpbjpPcGVuU2VzYW1l")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

Query Parameters

Name Type Required Description Example
application_id String Required

Your developer application id. This was provided to you via email.

4b634537cc392cca820b61dab08
type String Required

The social network to search. Must be entered in lowercase. Possible values are facebook, twitter.

facebook
query String Required

The search query to search for.

news

Responses

default Default

Unknown

(Empty Response)

Get Mentions

Open in API Explorer
GET /v1/mentions.json

Retrieves a list of mentions for a given keyword.

Example Request

Format:
curl --request GET \
  --url 'https://api.sendible.com/api/v1/mentions.json?application_id=4b634537cc392cca820b61dab08&mention_id=10000&type=blogs&sentiment=1&filter=news&page=1&per_page=10' \
  --header 'accept: application/json' \
  --header 'authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l'
require 'uri'
require 'net/http'

url = URI("https://api.sendible.com/api/v1/mentions.json?application_id=4b634537cc392cca820b61dab08&mention_id=10000&type=blogs&sentiment=1&filter=news&page=1&per_page=10")

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

request = Net::HTTP::Get.new(url)
request["accept"] = 'application/json'
request["authorization"] = 'Basic QWxhZGRpbjpPcGVuU2VzYW1l'

response = http.request(request)
puts response.read_body
var http = require("https");

var options = {
  "method": "GET",
  "hostname": "api.sendible.com",
  "port": null,
  "path": "/api/v1/mentions.json?application_id=4b634537cc392cca820b61dab08&mention_id=10000&type=blogs&sentiment=1&filter=news&page=1&per_page=10",
  "headers": {
    "accept": "application/json",
    "authorization": "Basic QWxhZGRpbjpPcGVuU2VzYW1l"
  }
};

var req = http.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();
import http.client

conn = http.client.HTTPSConnection("api.sendible.com")

headers = {
    'accept': "application/json",
    'authorization': "Basic QWxhZGRpbjpPcGVuU2VzYW1l"
    }

conn.request("GET", "/api/v1/mentions.json?application_id=4b634537cc392cca820b61dab08&mention_id=10000&type=blogs&sentiment=1&filter=news&page=1&per_page=10", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.sendible.com/api/v1/mentions.json?application_id=4b634537cc392cca820b61dab08&mention_id=10000&type=blogs&sentiment=1&filter=news&page=1&per_page=10",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => array(
    "accept: application/json",
    "authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l"
  ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://api.sendible.com/api/v1/mentions.json?application_id=4b634537cc392cca820b61dab08&mention_id=10000&type=blogs&sentiment=1&filter=news&page=1&per_page=10"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("accept", "application/json")
	req.Header.Add("authorization", "Basic QWxhZGRpbjpPcGVuU2VzYW1l")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

Query Parameters

Name Type Required Description Example
application_id String Required

Your developer application id. This was provided to you via email.

4b634537cc392cca820b61dab08
mention_id Number Optional

The ID of the keyword, retrieved using the [Get Monitoring Keywords] . If no mention_id is provided, mentions for all keywords will be returned.

10000
type String Optional

The type of mentions to retrieve. Possible values are blogs, microblogs, bookmarks, comments, events, images, news, videos, audio, questions, networks

blogs
sentiment Number Optional

The type of sentiment to filter results by: neutral (0), negative (-1) or positive (1). Possible values are 0, 1 or -1.

1
filter String Optional

A search term to filter results by.

news
page Number Optional

The page number to retrieve.

1
per_page Number Optional

The number of results to return per page.

10

Responses

default Default

Unknown

(Empty Response)

Update Mentions

Open in API Explorer
PUT /v1/mentions.json

Update sentiment and relevance for one or more mentions.

Example Request

Format:
curl --request PUT \
  --url 'https://api.sendible.com/api/v1/mentions.json?application_id=4b634537cc392cca820b61dab08&ids=123&sentiment=1&relevancy=0' \
  --header 'accept: application/json' \
  --header 'authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l' \
  --header 'content-type: multipart/form-data; boundary=---011000010111000001101001'
require 'uri'
require 'net/http'

url = URI("https://api.sendible.com/api/v1/mentions.json?application_id=4b634537cc392cca820b61dab08&ids=123&sentiment=1&relevancy=0")

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

request = Net::HTTP::Put.new(url)
request["accept"] = 'application/json'
request["authorization"] = 'Basic QWxhZGRpbjpPcGVuU2VzYW1l'
request["content-type"] = 'multipart/form-data; boundary=---011000010111000001101001'

response = http.request(request)
puts response.read_body
var http = require("https");

var options = {
  "method": "PUT",
  "hostname": "api.sendible.com",
  "port": null,
  "path": "/api/v1/mentions.json?application_id=4b634537cc392cca820b61dab08&ids=123&sentiment=1&relevancy=0",
  "headers": {
    "accept": "application/json",
    "authorization": "Basic QWxhZGRpbjpPcGVuU2VzYW1l",
    "content-type": "multipart/form-data; boundary=---011000010111000001101001"
  }
};

var req = http.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();
import http.client

conn = http.client.HTTPSConnection("api.sendible.com")

payload = ""

headers = {
    'accept': "application/json",
    'authorization': "Basic QWxhZGRpbjpPcGVuU2VzYW1l",
    'content-type': "multipart/form-data; boundary=---011000010111000001101001"
    }

conn.request("PUT", "/api/v1/mentions.json?application_id=4b634537cc392cca820b61dab08&ids=123&sentiment=1&relevancy=0", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.sendible.com/api/v1/mentions.json?application_id=4b634537cc392cca820b61dab08&ids=123&sentiment=1&relevancy=0",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => "",
  CURLOPT_HTTPHEADER => array(
    "accept: application/json",
    "authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l",
    "content-type: multipart/form-data; boundary=---011000010111000001101001"
  ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://api.sendible.com/api/v1/mentions.json?application_id=4b634537cc392cca820b61dab08&ids=123&sentiment=1&relevancy=0"

	req, _ := http.NewRequest("PUT", url, nil)

	req.Header.Add("accept", "application/json")
	req.Header.Add("authorization", "Basic QWxhZGRpbjpPcGVuU2VzYW1l")
	req.Header.Add("content-type", "multipart/form-data; boundary=---011000010111000001101001")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

Query Parameters

Name Type Required Description Example
application_id String Required

Your developer application id. This was provided to you via email.

4b634537cc392cca820b61dab08
ids String Required

A comma separated list of mention IDs to update.

123
sentiment Number Required

The sentiment type to set. 1 for positive, 0 for neutral, -1 for negative

1
relevancy Number Required

Set whether or not a mention is relevant. 1 for relevant, 0 for irrelevant

0

Responses

default Default

Unknown

(Empty Response)