Social media API keys

Managed by | Updated .

Background

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

Facebook

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:

  1. App ID
  2. app secret

    To obtain these, login to https://developers.facebook.com/apps and create a new application.

  3. 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.

Twitter

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:

  1. OAUTH consumer key
  2. Consumer secret
  3. Access token
  4. Access token secret

    Visit https://dev.twitter.com/apps/new to create a new app and retrieve these values.

YouTube

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:

  1. API key

    Visit https://developers.google.com/youtube/registeringanapplication#CreateAPIKeys to learn how to retrieve a YouTube API key.

  2. Channel ID

    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.

Instagram

Please note: Instagram is not officially supported by Funnelback.

  1. Client identifier
  2. Client secret

    Visit http://instagram.com/developer/ to create a new app to obtain these values

  3. Access token

    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.

Was this artcle helpful?

Comments