Built-in External Search Integrations

This document will show you how to configure the built-in external search integrations. Those integrations search external databases like YouTube or Wikipedia and usually require little or no configuration

Network configuration

see External Search network table

Giphy

By default the Giphy integration uses the open beta public key. For normal usage this key will suffice, for heavy usage you will want to apply for an official API key at Giphy API.

To activate the integration please run grape configure --enable giphy and enter the key when asked.

After enabling and configuring services run grape install to activate the new configuration and to restart Grape.

Youtube

To activate the youtube integration you need to have a google account, if you do not have one already you can get one here: Create your Google Account.

Then go to Google Developers Console and create a new project, e.g. grape-mycompany.

Then select “YouTube Data API v3”, and create a sever key (Menu on the left side “Credentials” -> “Create credentials” -> “API key” -> “Server key”)

Give the key a name, e.g. “Youtube for Grape” and click “Create”.

You will get a key looking like this: AImnXrSS9gh6SggWH7VS8sdSlY2Lrt1ggPzWERQ

To activate the integration please run grape configure --enable youtube and enter the key when asked.

After enabling and configuring services run grape install to activate the new configuration and to restart Grape.

Imgur

For Imgur integration you need to apply for an official API key at Imgur API Version 3.

You will receive both a Client ID and a client secret.

To activate the integration please run grape configure --enable imgur and enter the key when asked.

After enabling and configuring services run grape install to activate the new configuration and to restart Grape.

Wikipedia

This integration needs no further configuration.

Stack Overflow

This integration needs no further configuration.

Spotify

This integration needs no further configuration.