API documentation

Documentation

Misc

When creating a Source there are certain fields that take numeric identifiers - these are defined below.


Identifiers
Network IDs
Source Type IDs


Network IDs

When filtering Posts using the network_id parameter use the following integers to represent the desired network:

network_idNetwork Name
1Twitter
2Instagram
3Facebook
5Google
7Flickr
8Youtube
9Tumblr
10RSS
11Linkedin
12Vimeo
13Diffbot
15Glassdoor
17Yelp
18DeviantArt
19Behance
21Slack
22Giphy
23Reddit
25Tiktok

Source Type IDs

When creating a Source you can define the source_type using the follow integers:

source_typeDescriptionTag format
1Twitter taghashtag
3Twitter userusername
5Facebook pageurl part
9Flickr taghashtag
10YouTube taghashtag
11Tumblr taghashtag
13YouTube channelusername/channel id
14Tumblr userusername
15Flickr userusername
16RSSurl
18Linkedin Pagecompany id
20Twitter user mentionusername
21Twitter geolocationlat,long,distance
24Facebook visitor postsurl part
25Twitter timelineusername
27Flickr albumalbum id
28Vimeo taghashtag
29Diffbot crawlbotcrawl bot id
32Glassdoor employeremployer name
33Instagram Businessusername
34Instagram Timelineusername*
35Youtube Playlistplaylist id
38Instagram taghashtag
57Tiktok taghashtag
58Google Reviews (Lite)placeId
59Google ReviewsplaceId
62Linkedn Profileprofile url

Note: * For Instagram Timeline & Instagram Business - the username must match an existing Connection created through the Admin Dashboard.


Tag format

hashtag a string keyword without the # usually does not include spaces or none url
username a unique string identifier of the a user on the social network
url part the last part of a url identifying the source
channel id unique string id representing a YouTube Channel
lat,long,distance a location in the format latitude, longitude and radial distance (in miles) placeId place ID used by google maps to identify a place.


Source description

1 - Twitter Tag - pulls Twitter posts based on a hashtag. tag should be Twitter hashtag without the # .

3 - Twitter user - pulls Twitter posts from a users public timeline. tag should be the Twitter username without the @.

5 - Facebook page - pulls posts from a Facebook page. tag should be the last part of the Facebook page's url.

9 - Flickr Tag - pulls Flickr+ posts based on a hashtag. tag should be Flickr hashtag without the #.

10 - YouTube tag - pulls YouTube posts based on a hashtag. tag should be YouTube hashtag without the #.

11 - Tumblr tag - pulls Tumblr posts based on a hashtag. tag should be Google+ Tumblr without the #.

13 - YouTube channel - pulls YouTube posts from a users channel. tag should be the channel identifier (either a username or channel id).

14 - Tumblr user- pulls Tumblr posts from a users public timeline. tag should be the Tumblr username without the @.

15 - Flickr user - pulls Flickr posts from a users public timeline. tag should be the Flickr username without the @.

16 - RSS - pulls posts from a public RSS feed. tag should be the full URL to the feed.

18 - Linkedin page - pulls LinkedIn posts from a companies public timeline. tag should be the Company Id - this can be found as the last part of the URL to a company page.

20 - Twitter user mention - pulls Twitter posts that mention a specific username. tag should be the Twitter username without the @.

21 - Twitter geolocation - pulls Twitter posts around a specific location. tag is a location in the format latitude, longitude and radial distance (in miles)

24 - Facebook visitor posts - pulls visitor posts from a Facebook page. tag should be the last part of the Facebook page's url.

25 - Twitter - pull Twitter timeline for a particular user. tag shoudld be the username without the @.

27 - Flickr album - pulls in post from a Flickr Album. tag should be the ID of the album (found at the end of the Album URL eg: https://www.flickr.com/photos/145167874@N03/albums/72157671881444944)

28 - Vimeo tag - pulls Vimeo posts based on a hashtag. tag should be Vimeo hashtag without the # .

29 - Diffbot Crawlbot - Pulls in posts from Crawl Bot (https://www.diffbot.com/products/crawlbot/).

32 - Glassdoor employer - pulls in reviews from a Glassdoor employer. tag should be the name of the employer.

33 - Instagram Business Account - pulls posts from a Instagram Business page. tag should be the Instagram Business name.

34 - Instagram Timeline - pulls Instagram posts from a users public timeline. tag should be the Instagram username without the @. Note the username must match an existing Connection created through the Admin Dashboard.

35 - Youtube Playlist - pulls YouTube posts from a playlist. tag should be the playlist identifier.

38 - Instagram Business Tag - pulls Instagram posts based on a hashtag. tag should be Instagram hashtag without the #.

57 - Tiktok Hashtag - pulls Tiktok posts based on a hashtag. tag should be Tiktok hashtag without the #.

58 - Google Reviews (Lite) - pulls 5 reviews of a specified place from Google Maps. tag parameter must be a valid Google Place ID associated with the desired location.

59 - Google Reviews - pulls reviews of a specified place from Google Maps. tag parameter must be a valid Google Place ID associated with the desired location.

Depreciated Source Types

The following sources are depreciated due to changes in various Social Networks.

source_typeDescriptionTag format
2Instagram taghashtag
4Instagram Accountusername
6Vine taghashtag
8Google+ tagusername
8Google+ userusername
19Vine userusername
22Instagram geolocationlat,long,distance
23Instagram locationFacebook Place ID
26NOT USED
30NOT USED
31NOT USED

2 - Instagram Tag - [DEPRECIATED] - pulls Instagram posts based on a hashtag. tag should be Instagram hashtag without the #.

4 - Instagram user - [DEPRECIATED] pulls Instagram posts from a users public timeline. tag should be the Instagram username without the @.

6 - Vine Tag - [DEPRECIATED] - pulls Vine posts based on a hashtag. tag should be Vine hashtag without the #.

8 - Google+ Tag - [DEPRECIATED] - pulls Google+ posts based on a hashtag. tag should be Google+ hashtag without the #.

12 - Google+ user - [DEPRECIATED] - pulls Google+ posts from a users public timeline. tag should be the Google+ username without the @.

19 - Vine user - [DEPRECIATED] - pulls Vine posts from a users public timeline. tag should be the Vine username without the @.

22 - Instagram geolocation - [DEPRECIATED] - pulls Instagram posts around a specific location. tag is a location in the format latitude, longitude and radial distance (in miles)

23 - Instagram location - [DEPRECIATED] - pulls Instagram posts around a specific location. tag is a Facebook Place ID that identifies the location tag