Managed by | Updated .
When creating a social media collection, the
custom_gather.groovy script will require specific API keys in order to update the collection with the data from the social media. Depending on which template chosen when the collection was created, use the information below to obtain the correct keys.
Note that this information may get outdated as social media platforms evolve. Retrieving API keys for social media platforms is usually well documented on the social media platform developer website, so it may be useful to refer to it. It is also usually documented by third-parties in blog posts or tutorial that may be worth looking up.
Social media custom gather API keys
The following keys are required and can be obtained from https://developers.facebook.com/apps/. The client will need to login to their Facebook account and create an app. They should go to the dashboard and provide:
- App ID
- App secret
To obtain these, login to https://developers.facebook.com/apps and create a new application.
- Access token
A never expiring token will need to be retrieved. Follow: this article for details.
- Page ID
This can be found in the page settings. Please see this article for details: https://www.facebook.com/help/community/question/?id=378910098941520. Alternativly use a tool such as https://findmyfbid.com/ to obtain the page ID from your page name.
The following keys are required and can be obtained from https://apps.twitter.com/. The client will need to login to their Twitter account and create an App. They should go to key and access tokens and provide:
- OAUTH consumer key
- Consumer secret
- Access token
Access token secret
Visit https://dev.twitter.com/apps/new to create a new app and retrieve these values.
The following keys are required and can be obtained from https://console.developers.google.com/project. The client will need to login in their google account associated with YouTube and go to credentials. They should create a new credential and provide:
Visit https://developers.google.com/youtube/registeringanapplication#CreateAPIKeys to learn how to retrieve a YouTube API key.
Visit https://support.google.com/youtube/answer/3250431?hl=en to learn how to retrieve your channel identifier. Alternatively 3rd party tools such as https://johnnythetank.github.io/youtube-channel-name-converter/ can also be used.
Please note: Instagram is not officially supported by Funnelback.
- Client identifier
Visit http://instagram.com/developer/ to create a new app to obtain these values
Retrieving an access token can be challenging as Instagram doesn't provide an automated way to do so. The easiest way is to use third-party tools such as http://instagram.pixelunion.net/ , or follow manual instructions from http://jelled.com/instagram/access-token.