How to use the app

For use the ATRIBUS API you need to select a category id and a search id or profile id, you will find this information in the respective endpoints. Then you need to set an interval of dates in UNIX time (seconds). Is the same that you find inside the app of ATRIBUS. This interval cant be more than 2 weeks (1.020.000 s)

Access Token

For obtain the access token follow the steps in this link

Searchs

With this endpoint you can get all the searchs that you got in app.atribus.com https://api.atribus.com/api/searchs

Request

Parameter Type Position # Description
Authorization string Header Required Authorization token for request.

Response

								{
    "current_page": 1,
    "data": [
        {
            "search_id": *,
            "crawlers_id": "*****",
            "category_id": *,
            "search": "****",
            "active": *,
            "date": "******",
            "timezone": "********",
            "geo_unknown": **,
            "avatar": **,
            "min_follower": **,
            "max_follower": **,
            "verified": *,
            "description": "**",
            "app": **,
            "filter_not_lang": "",
            "filter_not_geo": "",
            "filter_sentiment": "",
            "rss": "",
            "pause": 0
        }
    ],
    "first_page_url": "http://api.atribus.com/api/searchs?page=1",
    "from": 1,
    "last_page": *,
    "last_page_url": "http://api.atribus.com/api/searchs?page=2",
    "next_page_url": "http://api.atribus.com/api/searchs?page=2",
    "path": "http://api.atribus.com/api/searchs",
    "per_page": **,
    "prev_page_url": null,
    "to": **,
    "total": **
}
								

Categories

With this endpoint you can get all the categories that you got in app.atribus.com https://api.atribus.com/api/categories

Request

Parameter Type Position # Description
Authorization string Header Required Authorization token for request.

Response

{
    "current_page": 1,
    "data": [
        {
            "category_id": **,
            "search": "***",
            "active": **,
            "date": "*******",
            "app": **
        }
    ],
    "first_page_url": "http://api.atribus.com/api/categories?page=1",
    "from": *,
    "last_page": *,
    "last_page_url": "http://api.atribus.com/api/categories?page=3",
    "next_page_url": "http://api.atribus.com/api/categories?page=2",
    "path": "http://api.atribus.com/api/categories",
    "per_page": *,
    "prev_page_url": null,
    "to": *,
    "total": **
}

Profiles

With this endpoint you can get all the profiles that you got in app.atribus.com https://api.atribus.com/api/profiles

Request

Parameter Type Position # Description
Authorization string Header Required Authorization token for request.

Response

{
    "current_page": 1,
    "data": [
        {
            "profiles_id": *,
            "category_id": *,
            "crawler": *,
            "screen_name": "**",
            "user_id": "**",
            "active": **,
            "date": "***",
            "timezone": "****",
            "refresh_token": "",
            "avatar": "*****",
            "count_follow": **,
            "count_follower": **,
            "count_publish": **,
            "description": "**",
            "is_login": *,
            "recover_mention": *,
            "recover_story": *,
            "date_refresh": **,
            "pause": *
        }
    ],
    "first_page_url": "http://api.atribus.com/api/profiles?page=1",
    "from": 1,
    "last_page": 2,
    "last_page_url": "http://api.atribus.com/api/profiles?page=2",
    "next_page_url": "http://api.atribus.com/api/profiles?page=2",
    "path": "http://api.atribus.com/api/profiles",
    "per_page": **,
    "prev_page_url": null,
    "to": **,
    "total": **
}

Twitter Tweets Timeline

To get all the tweets that atribus has collect for you https://api.atribus.com/api/timeline_twitter

Request

Parameter Type Position # Description
authorization string Header Required Bearer token for the request.
category int Body Required Category that you want gather all the information.
search int Body Required Search that you want gather all the information.
date_start date Body Required Start time for the gather information.
date_end date Body Required End time for the gather information.

Response

{
    "current_page": 1,
    "data": [
        {
            "twitters_tweets_id": **********,
            "category": **,
            "search": **,
            "text": "***",
            "picture": "",
            "lang": "**",
            "date_created": "***",
            "latitude": **,
            "longitude": **,
            "county": "",
            "county_code": "",
            "country": "",
            "country_code": "",
            "count_retweet": **,
            "count_favorite": **,
            "sentiment": *,
            "gender": *,
            "description": "*********",
            "avatar": "*********",
            "count_follow": ******,
            "twitters_users_id": *****,
            "screen_name": "****",
            "name": "****",
            "count_tweet": *****,
            "count_follower": *****,
            "value_potential": ****,
            "engagement": ****,
            "impact_potential": ***,
            "impression_estimated": ****,
            "interaction": ****,
            "impression_potential": *****,
            "reach_potential": ****,
            "reach_estimated": ***,
            "value_estimated": *****,
            "value_ayzenberg": ****
        }
    ],
    "first_page_url": "http://api.atribus.com/api/timeline_twitter?page=1",
    "from": *,
    "last_page": **,
    "last_page_url": "http://api.atribus.com/api/timeline_twitter?page=**",
    "next_page_url": "http://api.atribus.com/api/timeline_twitter?page=2",
    "path": "http://api1.atribus.com/api/timeline_twitter",
    "per_page": **,
    "prev_page_url": null,
    "to": **,
    "total": **
}

Twitter Tweets Profiles Timeline

To get all the tweets that atribus has collect for you https://api.atribus.com/api/timeline_twitter_profiles

Request

Parameter Type Position # Description
authorization string Header Required Bearer token for the request.
category int Body Required Category that you want gather all the information.
profile int Body Required Profile that you want gather all the information.
date_start date Body Required Start time for the gather information.
date_end date Body Required End time for the gather information.

Response

{
    "current_page": *,
    "data": [
        {
            "twitters_profile_tweets_id": ***,
            "category": **,
            "profile_id": **,
            "text": "*****",
            "source": "****",
            "picture": "",
            "lang": "***",
            "date_created": "****",
            "latitude": *******,
            "longitude": ****,
            "county": "***",
            "county_code": "***",
            "country": "******",
            "country_code": "**",
            "count_retweet":***,
            "count_favorite": **,
            "sentiment": *,
            "twitters_user_id": ****,
            "gender": **,
            "description": "*****",
            "avatar": "****",
            "count_follow": *******,
            "twitters_profile_users_id": ****,
            "screen_name": "***",
            "name": "Sprout ***",
            "count_tweet": ***,
            "count_list": ***,
            "is_verified": **,
            "is_default_profile_image": **,
            "count_follower": ***,
            "duration": ****,
            "value_potential": *****,
            "engagement": *****,
            "impact_potential": ****,
            "impression_estimated": *****,
            "interaction": *,
            "impact_estimated": ***,
            "impression_potential": ***,
            "reach_potential": **,
            "reach_estimated": ***,
            "value_estimated": ***,
            "value_ayzenberg": *****
        }
    ],
    "first_page_url": "http://api.atribus.com/api/timeline_twitter_profiles?page=1",
    "from": *,
    "last_page": **,
    "last_page_url": "http://api.atribus.com/api/timeline_twitter_profiles?page=**",
    "next_page_url": "http://api.atribus.com/api/timeline_twitter_profiles?page=**",
    "path": "http://api.atribus.com/api/timeline_twitter_profiles",
    "per_page": *,
    "prev_page_url": null,
    "to": *,
    "total": **
}

Instagrams Timeline

To get all the instagrams that atribus has collect for you https://api.atribus.com/api/timeline_instagram

Request

Parameter Type Position # Description
authorization string Header Required Bearer token for the request.
category int Body Required Category that you want gather all the information.
search int Body Required Search that you want gather all the information.
date_start date Body Required Start time for the gather information.
date_end date Body Required End time for the gather information.

Response

{
    "current_page": 1,
    "data": [
        {
            "instagrams_id": "*****",
            "instagrams_users_id": ****,
            "search_id": **,
            "category_id": **,
            "text": "*****",
            "type": "***",
            "picture": "*****",
            "lang": "**",
            "url": "****",
            "date_created": "***",
            "location": "**",
            "longitude": *,
            "county": "**",
            "county_code": "",
            "country": "",
            "country_code": "",
            "count_like": ***,
            "count_comment": **,
            "sentiment": *,
            "screen_name": "***",
            "name": "***",
            "description": "****",
            "avatar": "*********",
            "website": "*******",
            "gender": ***,
            "count_media": ***,
            "count_follow": ***,
            "count_follower": ***,
            "impression_potential": ***,
            "impression_estimated": **,
            "reach_potential": **,
            "reach_estimated": **,
            "engagement": ****,
            "interaction": ***,
            "value_potential": ***,
            "value_estimated": ****,
            "impact_potential": ***,
            "impact_estimated": ***,
            "value_ayzenberg": ****
        }
    ],
    "first_page_url": "http://api.atribus.com/api/timeline_instagram?page=1",
    "from": *,
    "last_page": ***,
    "last_page_url": "http://api.atribus.com/api/timeline_instagram?page=**",
    "next_page_url": "http://api.atribus.com/api/timeline_instagram?page=2",
    "path": "http://api.atribus.com/api/timeline_instagram",
    "per_page": **,
    "prev_page_url": null,
    "to": *,
    "total": ***
}

Instagrams Timeline

To get all the instagrams profiles timeline that atribus has collect for you https://api.atribus.com/api/timeline_instagram_profiles

Request

Parameter Type Position # Description
authorization string Header Required Bearer token for the request.
category int Body Required Category that you want gather all the information.
search int Body Required Search that you want gather all the information.
date_start date Body Required Start time for the gather information.
date_end date Body Required End time for the gather information.

Response

{
    "current_page": 1,
    "data": [
        {
            "instagrams_profiles_id": "****",
            "instagrams_profiles_users_id": ****,
            "profile_id": **,
            "category_id": *,
            "text": "******",
            "type": "***",
            "picture": "******",
            "lang": "**",
            "url": "****",
            "date_created": "*****",
            "location": "**",
            "longitude": **,
            "county": "**",
            "county_code": "**",
            "country": "**",
            "country_code": "**",
            "count_like": **,
            "count_comment": *,
            "sentiment": *,
            "screen_name": "****",
            "name": "****",
            "description": "**********",
            "avatar": "****"",
            "website": "****",
            "gender": **,
            "count_media": **,
            "count_follow": **,
            "count_follower": **,
            "impression_potential": **,
            "impression_estimated": **,
            "reach_potential": **,
            "reach_estimated": **,
            "engagement": ******,
            "interaction": **,
            "value_potential": ***,
            "value_estimated": ***,
            "impact_potential": **,
            "impact_estimated": **,
            "value_ayzenberg": ***
        }
    ],
    "first_page_url": "http://api.atribus.com/api/timeline_instagram_profiles?page=1",
    "from": **,
    "last_page": **,
    "last_page_url": "http://api.atribus.com/api/timeline_instagram_profiles?page=**",
    "next_page_url": "http://api.atribus.com/api/timeline_instagram_profiles?page=2",
    "path": "http://api.atribus.com/api/timeline_instagram_profiles",
    "per_page": **,
    "prev_page_url": null,
    "to": **,
    "total": **
}

YouTube Timeline

To get all the feeds from Youtube that atribus has collect for you https://api.atribus.com/api/instagrams

Request

Parameter Type Position # Description
authorization string Header Required Bearer token for the request.
category int Body Required Category that you want gather all the information.
search int Body Required Search that you want gather all the information.
date_start date Body Required Start time for the gather information.
date_end date Body Required End time for the gather information.

Response

{
    "current_page": 1,
    "data": [
        {
            "youtubes_id": "***",
            "category": *,
            "search": **,
            "title": "***",
            "description": "******",
            "url": "****",
            "license": "***",
            "lang": "en",
            "date_created": "******",
            "date_updated": "******",
            "duration": **,
            "count_view": **,
            "count_like": **,
            "count_dislike": **,
            "response": **,
            "sentiment": **,
            "youtubes_users_id": "***",
            "screen_name": "***",
            "description_user": "****",
            "user_url": "*****",
            "avatar": "*****",
            "age": **,
            "gender": *,
            "country": "**",
            "country_code": "**",
            "count_subscriber": *,
            "count_video_playback": **,
            "count_video": *,
            "rapidity": *,
            "impression": *,
            "reach": *,
            "engagement": *,
            "interaction": *,
            "value": ***,
            "impact": *,
            "passion": *,
            "value_ayzenberg": ***
        }
    ],
    "first_page_url": "http://api.atribus.com/api/timeline_youtube?page=1",
    "from": *,
    "last_page": *,
    "last_page_url": "http://api.atribus.com/api/timeline_youtube?page=*",
    "next_page_url": null,
    "path": "http://api.atribus.com/api/timeline_youtube",
    "per_page": *,
    "prev_page_url": null,
    "to": *,
    "total": *
}

YouTube Profiles Timeline

To get all the facebooks profiles timeline that atribus has collect for you https://api.atribus.com/api/instagrams

Request

Parameter Type Position # Description
authorization string Header Required Bearer token for the request.
category int Body Required Category that you want gather all the information.
search int Body Required Search that you want gather all the information.
date_start date Body Required Start time for the gather information.
date_end date Body Required End time for the gather information.

Response

{
    "current_page": 1,
    "data": [
        {
            "youtubes_profiles_id": "****",
            "youtubes_profiles_users_id": "****",
            "category_id": *,
            "title": "*****",
            "description": "*****",
            "url": "****",
            "category": "***",
            "license": "****",
            "lang": "**",
            "date_created": "******",
            "date_updated": "***",
            "duration": **,
            "count_view": **,
            "count_like": **,
            "count_dislike": **,
            "count_comment": **,
            "sentiment_human": **,
            "screen_name": "****",
            "user_description": "*********",
            "avatar": "****",
            "age": **,
            "gender": **,
            "country": "**",
            "country_code": "**",
            "count_subscriber": ****,
            "count_video_playback": ****,
            "count_video": ***,
            "rapidity": *,
            "impression": ***,
            "reach": ***,
            "engagement": ***,
            "interaction": ***,
            "value": ***,
            "impact": ***,
            "passion": **,
            "value_ayzenberg": ***
        }
    ],
    "first_page_url": "http://api.atribus.com/api/timeline_youtube_profiles?page=1",
    "from": *,
    "last_page": ***,
    "last_page_url": "http://api.atribus.com/api/timeline_youtube_profiles?page=**",
    "next_page_url": "http://api.atribus.com/api/timeline_youtube_profiles?page=2",
    "path": "http://api.atribus.com/api/timeline_youtube_profiles",
    "per_page": **,
    "prev_page_url": null,
    "to": **,
    "total": **
}

Facebook Timeline

To get all the feeds from Facebook that atribus has collect for you https://api.atribus.com/api/instagrams

Request

Parameter Type Position # Description
authorization string Header Required Bearer token for the request.
category int Body Required Category that you want gather all the information.
search int Body Required Search that you want gather all the information.
date_start date Body Required Start time for the gather information.
date_end date Body Required End time for the gather information.

Response

{
    "current_page": 1,
    "data": [
        {
            "facebooks_feeds_id": "****",
            "facebooks_users_pages_id": ***,
            "search_id": **,
            "category_id": *,
            "name": "**",
            "message": "****",
            "description": "**",
            "source": "**",
            "caption": "**",
            "type": "***",
            "picture": "********",
            "link": "***",
            "lang": "**",
            "date_created": "**",
            "date_updated": "***",
            "count_like": **,
            "response": *,
            "count_share": *,
            "count_reaction": *,
            "sentiment_human": *,
            "screen_name": "*****",
            "about": "*****",
            "url": "******",
            "avatar": "****",
            "website": "****",
            "category": "***",
            "gender": **,
            "country": "**",
            "country_code": "**",
            "county": "***",
            "county_code": "***",
            "street": "****",
            "latitude": ****,
            "longitude": ****,
            "phone": "***",
            "count_checkin": *,
            "count_talking": *,
            "impression_potential": **,
            "impression_estimated": **,
            "reach_potential": **,
            "reach_estimated": **,
            "engagement": **,
            "interaction": **,
            "value_potential": ***,
            "value_estimated": ***,
            "impact_potential": ***,
            "impact_estimated": **,
            "value_ayzenberg": ***
        }
    ],
    "first_page_url": "http://api.atribus.com/api/timeline_facebook?page=1",
    "from": 1,
    "last_page": **,
    "last_page_url": "http://api.atribus.com/api/timeline_facebook?page=**",
    "next_page_url": "http://api.atribus.com/api/timeline_facebook?page=2",
    "path": "http://api.atribus.com/api/timeline_facebook",
    "per_page": **,
    "prev_page_url": null,
    "to": 1,
    "total": **
}

Facebook Profiles Timeline

To get all the facebooks profiles timeline that atribus has collect for you https://api.atribus.com/api/instagrams

Request

Parameter Type Position # Description
authorization string Header Required Bearer token for the request.
category int Body Required Category that you want gather all the information.
search int Body Required Search that you want gather all the information.
date_start date Body Required Start time for the gather information.
date_end date Body Required End time for the gather information.

Response

{
    "current_page": 1,
    "data": [
        {
            "facebooks_profiles_feeds_id": "*****",
            "facebooks_profiles_users_pages_id": ****,
            "category_id": *,
            "name": "***",
            "message": "****",
            "description": "******",
            "source": "******",
            "caption": "**",
            "type": "***",
            "picture": "********",
            "link": "*******",
            "lang": "****",
            "date_created": "******",
            "date_updated": "***",
            "count_like": ***,
            "count_comment": **,
            "count_share": **,
            "count_reaction": **,
            "sentiment": **,
            "sentiment_human": **,
            "screen_name": "****",
            "about": "*****",
            "url": "****",
            "avatar": "****",
            "website": "*****",
            "category": "*****",
            "gender": **,
            "country": "**",
            "country_code": "**",
            "county": "**",
            "county_code": "***",
            "street": "***",
            "latitude": ****,
            "longitude": ****,
            "phone": "***",
            "count_checkin": *,
            "count_talking": *,
            "impression_potential": **,
            "impression_estimated": **,
            "reach_potential": **,
            "reach_estimated": **,
            "engagement": **,
            "interaction": *,
            "value_potential": ****,
            "value_estimated": ****,
            "impact_potential": ***,
            "impact_estimated": **,
            "value_ayzenberg": ***
        }
    ],
    "first_page_url": "http://api.atribus.com/api/timeline_facebook_profiles?page=1",
    "from": **,
    "last_page": **,
    "last_page_url": "http://api.atribus.com/api/timeline_facebook_profiles?page=**",
    "next_page_url": "http://api.atribus.com/api/timeline_facebook_profiles?page=2",
    "path": "http://api.atribus.com/api/timeline_facebook_profiles",
    "per_page": **,
    "prev_page_url": null,
    "to": **,
    "total": **
}

Google Webs

To get all the google webs that atribus has collect for you https://api.atribus.com/api/timeline_google_webs

Request

Parameter Type Position # Description
authorization string Header Required Bearer token for the request.
category int Body Required Category that you want gather all the information.
search int Body Required Search that you want gather all the information.
date_start date Body Required Start time for the gather information.
date_end date Body Required End time for the gather information.

Response

{
    "current_page": 1,
    "data": [
        {
            "category_id": *,
            "search_id": **,
            "googles_webs_id": ***,
            "title": "*****",
            "url": "***",
            "lang": "**",
            "host": "***",
            "summary": "*****",
            "date_created": "***",
            "sentiment_human": **,
            "share_twitter": **,
            "share_facebook": **,
            "share_pinterest": **,
            "share_reddit": **,
            "count_audience": **,
            "count_vep": **,
            "picture": "**"
        }
    ],
    "first_page_url": "http://api.atribus.com/api/timeline_google_webs?page=1",
    "from": *,
    "last_page": **,
    "last_page_url": "http://api.atribus.com/api/timeline_google_webs?page=**",
    "next_page_url": "http://api.atribus.com/api/timeline_google_webs?page=2",
    "path": "http://api.atribus.com/api/timeline_google_blogs",
    "per_page": *,
    "prev_page_url": null,
    "to": *,
    "total": **
}

Google News

To get all the google webs that atribus has collect for you https://api.atribus.com/api/timeline_google_news

Request

Parameter Type Position # Description
authorization string Header Required Bearer token for the request.
category int Body Required Category that you want gather all the information.
search int Body Required Search that you want gather all the information.
date_start date Body Required Start time for the gather information.
date_end date Body Required End time for the gather information.

Response

{
    "current_page": 1,
    "data": [
        {
            "category_id": *,
            "search_id": **,
            "googles_news_id": ***,
            "title": "*****",
            "url": "***",
            "lang": "**",
            "host": "***",
            "summary": "*****",
            "date_created": "***",
            "sentiment_human": **,
            "share_twitter": **,
            "share_facebook": **,
            "share_pinterest": **,
            "share_reddit": **,
            "count_audience": **,
            "count_vep": **,
            "picture": "**"
        }
    ],
    "first_page_url": "http://api.atribus.com/api/timeline_google_news?page=1",
    "from": *,
    "last_page": **,
    "last_page_url": "http://api.atribus.com/api/timeline_google_news?page=**",
    "next_page_url": "http://api.atribus.com/api/timeline_google_news?page=2",
    "path": "http://api.atribus.com/api/timeline_google_news",
    "per_page": *,
    "prev_page_url": null,
    "to": *,
    "total": **
}

Google Discussions

To get all the google discussions that atribus has collect for you https://api.atribus.com/api/timeline_google_discussions

Request

Parameter Type Position # Description
authorization string Header Required Bearer token for the request.
category int Body Required Category that you want gather all the information.
search int Body Required Search that you want gather all the information.
date_start date Body Required Start time for the gather information.
date_end date Body Required End time for the gather information.

Response

{
    "current_page": 1,
    "data": [
        {
            "category_id": *,
            "search_id": **,
            "googles_discussions_id": ***,
            "title": "*****",
            "url": "***",
            "lang": "**",
            "host": "***",
            "summary": "*****",
            "date_created": "***",
            "sentiment_human": **,
            "share_twitter": **,
            "share_facebook": **,
            "share_pinterest": **,
            "share_reddit": **,
            "count_audience": **,
            "count_vep": **,
            "picture": "**"
        }
    ],
    "first_page_url": "http://api.atribus.com/api/timeline_google_discussions?page=1",
    "from": *,
    "last_page": **,
    "last_page_url": "http://api.atribus.com/api/timeline_google_discussions?page=**",
    "next_page_url": "http://api.atribus.com/api/timeline_google_discussions?page=2",
    "path": "http://api.atribus.com/api/timeline_google_discussions",
    "per_page": *,
    "prev_page_url": null,
    "to": *,
    "total": **
}

Google Blogs

To get all the google blogs that atribus has collect for you https://api.atribus.com/api/timeline_google_blogs

Request

Parameter Type Position # Description
authorization string Header Required Bearer token for the request.
category int Body Required Category that you want gather all the information.
search int Body Required Search that you want gather all the information.
date_start date Body Required Start time for the gather information.
date_end date Body Required End time for the gather information.

Response

{
    "current_page": 1,
    "data": [
        {
            "category_id": *,
            "search_id": **,
            "googles_blogs_id": ***,
            "title": "*****",
            "url": "***",
            "lang": "**",
            "host": "***",
            "summary": "*****",
            "date_created": "***",
            "sentiment_human": **,
            "share_twitter": **,
            "share_facebook": **,
            "share_pinterest": **,
            "share_reddit": **,
            "count_audience": **,
            "count_vep": **,
            "picture": "**"
        }
    ],
    "first_page_url": "http://api.atribus.com/api/timeline_google_blos?page=1",
    "from": *,
    "last_page": **,
    "last_page_url": "http://api.atribus.com/api/timeline_google_blogs?page=**",
    "next_page_url": "http://api.atribus.com/api/timeline_google_blogs?page=2",
    "path": "http://api.atribus.com/api/timeline_google_blogs",
    "per_page": *,
    "prev_page_url": null,
    "to": *,
    "total": **
}