Atoka API User Reference

Companies package "Socials"

Available fields
Description
Data
Used by filters
Facet
Match
facebook[]

Facebook accounts related to a company (with information on friends and likes)

- -
facebook[].friends[].count

count of 'Friends' at a given date

int socials=facebook
facebook[].friends[].date

date when 'Friends' have been counted

"string" socials=facebook
facebook[].id

the numeric ID of the Facebook account

"string" socials=facebook
facebook[].likes[].count

count of 'Likes' at a given date

int socials=facebook
facebook[].likes[].date

date when 'Likes' have been counted

"string" socials=facebook
facebook[].url

the public link of the Facebook account

"string" socials=facebook
flickr[]

list of Flickr accounts

- -
flickr[].url

url of the account

"string" socials=flickr
googleplus[]

list of Google+ accounts

- -
googleplus[].url

url of the account

"string" socials=googleplus
instagram[]

list of Instagram accounts

- -
instagram[].url

url of the account

"string" socials=instagram
linkedin[]

list of LinkedIn accounts

- -
linkedin[].url

url of the account

"string" socials=linkedin
score.blog

a score given to the company based on the of activity of Blogs, computed using the number of posts and normalized between 0 and 1

float blogScoreMin blogScoreMax
score.facebookGlobal

a score given to the company on its activity on facebook; the score is a number from 0 (no activity) to 1 (really active); "global" score is based on the activity of the last 12 months

float facebookScoreGlobalMin facebookScoreGlobalMax
score.facebookLocal

a score given to the company on its activity on facebook; the score is a number from 0 (no activity) to 1 (really active); "local" score is based on the activity of the last 3 months

float facebookScoreLocalMin facebookScoreLocalMax
score.global

a score given to the company on its activity on social networks and the web; the score is a number from 0 (no activity) to 1 (really active); "global" score is based on a longer period than "local", and analyzes activity of the last year at least

float socialScoreGlobalMin socialScoreGlobalMax
score.globalLabel

text representation of the global score, values can be: top, high, medium, low

"string" socialScoresLocal
score.local

a score given to the company on its activity on social networks and the web; the score is a number from 0 (no activity) to 1 (really active); "local" score is based on the activity of the last 3 months

float socialScoreLocalMin socialScoreLocalMax
score.localLabel

text representation of the local score, values can be: top, high, medium, low

"string" socialScoresLocal
score.presence

a score given to the company based on the number social networks in which the company has an account that we detected; we consider all the social networks mentioned in the social package

the score is a number from 0 (no social network) to 1 (at least 4 social networks).

float socialPresenceScoreMin socialPresenceScoreMax
score.twitterGlobal

a score given to the company on its activity on twitter; the score is a number from 0 (no activity) to 1 (really active); "global" score is based on the activity of the last 12 months

float twitterScoreGlobalMin twitterScoreGlobalMax
score.twitterLocal

a score given to the company on its activity on twitter; the score is a number from 0 (no activity) to 1 (really active); "local" score is based on the activity of the last 3 months

float twitterScoreLocalMin twitterScoreLocalMax
score.updateTime

Last update time for the socials scores

date -
twitter[]

Twitter accounts related to a company (with information on friends and likes)

- -
twitter[].followers[].count

count of 'Followers' at a given date

int socials=twitter
twitter[].followers[].date

date when 'Followers' have been counted

"string" socials=twitter
twitter[].friends[].count

count of 'Friends' at a given date

int socials=twitter
twitter[].friends[].date

date when 'Friends' have been counted

"string" socials=twitter
twitter[].url

url of the account

"string" socials=twitter
vimeo[]

list of Vimeo accounts

- -
vimeo[].url

url of the account

"string" socials=vimeo
youtube[]

list of Youtube accounts

- -
youtube[].url

url of the account

"string" socials=youtube
Example JSON fragment for package
{ // Companies package "Socials"
"facebook": [ // Facebook accounts related to a company (with information on friends and likes)
{
"url": "string", // the public link of the Facebook account
"id": "string", // the numeric ID of the Facebook account
"friends": [
{
"date": "string", // date when 'Friends' have been counted
"count": int // count of 'Friends' at a given date
},
...
],
"likes": [ // list of 'Like' records for the Facebook account
{
"date": "string", // date when 'Likes' have been counted
"count": int // count of 'Likes' at a given date
},
...
]
},
...
],
"twitter": [ // Twitter accounts related to a company (with information on friends and likes)
{
"url": "string", // url of the account
"friends": [
{
"date": "string", // date when 'Friends' have been counted
"count": int // count of 'Friends' at a given date
},
...
],
"followers": [ // list of 'Followers' of the Twitter account
{
"date": "string", // date when 'Followers' have been counted
"count": int // count of 'Followers' at a given date
},
...
]
},
...
],
"linkedin": [ // list of LinkedIn accounts
{
"url": "string" // url of the account
},
...
],
"googleplus": [ // list of Google+ accounts
{
"url": "string" // url of the account
},
...
],
"youtube": [ // list of Youtube accounts
{
"url": "string" // url of the account
},
...
],
"vimeo": [ // list of Vimeo accounts
{
"url": "string" // url of the account
},
...
],
"flickr": [ // list of Flickr accounts
{
"url": "string" // url of the account
},
...
],
"instagram": [ // list of Instagram accounts
{
"url": "string" // url of the account
},
...
],
"score": { // a score given to the company on its activity on social networks and the web
"local": float, // a score given to the company on its activity on social networks and the web; the score is a number from 0 (no activity) to 1 (really active); "local" score is based on the activity of the last 3 months
"localLabel": "string", // text representation of the `local` score, values can be: `top`, `high`, `medium`, `low`
"global": float, // a score given to the company on its activity on social networks and the web; the score is a number from 0 (no activity) to 1 (really active); "global" score is based on a longer period than "local", and analyzes activity of the last year at least
"globalLabel": "string", // text representation of the `global` score, values can be: `top`, `high`, `medium`, `low`
"presence": float, // a score given to the company based on the number social networks in which the company has an account that we detected; we consider all the social networks mentioned in the social package the score is a number from 0 (no social network) to 1 (at least 4 social networks).
"facebookLocal": float, // a score given to the company on its activity on facebook; the score is a number from 0 (no activity) to 1 (really active); "local" score is based on the activity of the last 3 months
"facebookGlobal": float, // a score given to the company on its activity on facebook; the score is a number from 0 (no activity) to 1 (really active); "global" score is based on the activity of the last 12 months
"twitterLocal": float, // a score given to the company on its activity on twitter; the score is a number from 0 (no activity) to 1 (really active); "local" score is based on the activity of the last 3 months
"twitterGlobal": float, // a score given to the company on its activity on twitter; the score is a number from 0 (no activity) to 1 (really active); "global" score is based on the activity of the last 12 months
"blog": float, // a score given to the company based on the of activity of Blogs, computed using the number of posts and normalized between 0 and 1
"updateTime": "date (in YYYY-MM-DD format)" // Last update time for the socials scores
}
}