Atoka API User Reference

Companies package "Socials"

API tokens are configured to access only the packages each user needs; this means you might not have access to the content of this package. Ask your sales contact!

Available fields
Description
Data
Used by filters
Facet
Match
Stats
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[].provenance[] Private field

provenance of the Facebook account

 "string" -
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[] This field is deprecated

list of Google+ accounts

 - -
googleplus[].url This field is deprecated

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
pinterest[]

list of Pinterest accounts

 - -
pinterest[].url

url of the account

 "string" socials=pinterest
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
{
"facebook": [
{
"url": "foo",
"provenance": [
"foo",
...
],
"id": "foo",
"friends": [
{
"date": "foo",
"count": 42
},
...
],
"likes": [
{
"date": "foo",
"count": 42
},
...
]
},
...
],
"twitter": [
{
"url": "foo",
"friends": [
{
"date": "foo",
"count": 42
},
...
],
"followers": [
{
"date": "foo",
"count": 42
},
...
]
},
...
],
"linkedin": [
{
"url": "foo"
},
...
],
"googleplus": [
{
"url": "foo"
},
...
],
"youtube": [
{
"url": "foo"
},
...
],
"vimeo": [
{
"url": "foo"
},
...
],
"flickr": [
{
"url": "foo"
},
...
],
"instagram": [
{
"url": "foo"
},
...
],
"pinterest": [
{
"url": "foo"
},
...
],
"score": {
"local": 0.42,
"localLabel": "foo",
"global": 0.42,
"globalLabel": "foo",
"presence": 0.42,
"facebookLocal": 0.42,
"facebookGlobal": 0.42,
"twitterLocal": 0.42,
"twitterGlobal": 0.42,
"blog": 0.42,
"updateTime": "2015-12-24"
}
}