• Skip to primary navigation
  • Skip to main content
  • Skip to primary sidebar
  • Skip to footer

Last Call - The RapidAPI Blog

  • Marketplace
  • Add Your API
  • About
  • Docs
    • API Glossary
  • Blog
    • API Tutorials
      • Google Sheets
      • Python
      • JavaScript
      • PHP
      • Java
      • Ruby on Rails
      • C#
    • Most Popular APIs
  • Teams
  • Sign Up
    • Log In
Blog > Case Study > API Smash > GIPHY and Twilio “Text a GIF” Project [API Smash]

GIPHY and Twilio “Text a GIF” Project [API Smash]

December 7, 2016 By Lindsey 3 Comments

Table of Contents

  • Demo: “Text a GIF” 
  • Step 1: Storing user inputs in variables
  • Step 2: Connecting to the GIPHY API
  • Step 3: Call the Twilio API
  • Ta-da! 

Update: Twilio’s official APIs are now available on RapidAPI. Be sure to check them out.

One of the reasons that we built RapidAPI is to make it easier to call multiple APIs through one console. No more juggling multiple API libraries!

We’re starting a series where we smash two APIs together to make a project. Today? We’re putting together GIPHY and Twilio to make “Text A GIF” script that texts someone a GIF based on a user-inputted phrase.

Related: Send SMS with Twilio’s API (in Ruby on Rails)

 

api-smash-5-copy

 Read on for more!

Demo: “Text a GIF” 

We created a “Text a GIF” app that runs in the Terminal.  The user types in a phrase and a phone number and the “Text A GIF” app sends a related, random GIF. See below for a demo!

giphytwilio_apismash_final

Aaaaaand here’s the source code.  You can also find it on GitHub.

We built this project by exporting JavaScript code snippets from RapidAPI’s GIPHY and Twilio API packages. You can recreate this app in your preferred language by filling in the parameters on RapidAPI and exporting the snippet in the language of your choice (ex. Python, PHP, Java, Objective-C and cURL).

 

giphy-5

 

Now, here’s how we built it!

Step 1: Storing user inputs in variables

The first lines of code call RapidAPI. (If you haven’t already installed it, you’ll be walked through that process when you sign up for a free RapidAPI account).

Next, the “Text a GIF” app requires the user to input text and a phone number from the command line. The following lines of code store these user inputs into two variables.

Note: In order for Twilio to read the phone number, it must be written in E.164 formatting. All that means is “+” then country code, then number, with no dashes or spacing. For example, +18008675309.

Step 2: Connecting to the GIPHY API

How to Call the GIPHY API

Our next step was connecting to the GIPHY via the RapidAPI package and exporting the code snippet in JavaScript.

The endpoint we used for this app was translateTextToGif.  This endpoint generates a GIF based on the word that you type in. You can even filter the results by rating (G, PG, PG-13, R) and language (using the ISO 639-1 country code–English is “en”).

You can test this endpoint right within your browser. Type in the parameters above and use dc6zaTOxFJmzC as an access_token. GIPHY provides a public beta key for anyone to use. (If you want to submit an app for production, you can request a production key here.)

 

giphy-6

 

 

Incorporating the GIPHY API into the code

Using the translateTextToGiF endpoint, the GIPHY API generates a GIF based on the text the user inputed into the Terminal (in this case, gifText ).

If the call is successful, the script will call Twilio’s API to text a MMS with the generated GIF. If the call isn’t successful, the script will read an error message that lets the user know the problem was with the GIF generation.

Have an API you want to add to our API Marketplace?
plus
Add your API to our marketplace

Step 3: Call the Twilio API

How to call the Twilio API

Our next step was connecting to the Twilio API to send a text message. In order to connect to the Twilio API, you’ll need an accountToken, accountSid, messagingSid and to generate a Twilio phone number. These can all be generated for free on the Twilio developer portal. Here’s a quick post on how to get the credentials that you need.

Note: If you generate a free “from” phone number with your Twilio developer account, then the phone number you associate with the free “from” number is the ONLY one you can send messages to. In this case, the “Text A GIF” app will only send GIFs to your phone number. In order to send a message to any number, you must purchase an upgrade (see more in the Twilio developer console). 

Incorporating the Twilio API into the code

For the “Text a GIF” project, we called the sendMms endpoint. Using this endpoint, Twilio can send a multi-media message to the phone number the user entered (in this case, the variable phoneNumber).

The GIPHY API translateTextToGiF endpoint returns a variety of data. To store the image URL, we created a variable called gif. (Scroll down through code to display).

If the GIPHY API call is successful in generating a GIF, then the Twilio API will retrieve the image URL (gif) and text it to the phone number the user inputted initially (phoneNumber). The script will then prompt the user with “Check your phone!” If the Twilio API call is unsuccessful, the script will return the prompt “Error sending MMS.”

Ta-da! 

giphy-4

This article wouldn’t be complete without at least one celebratory GIF. Let us know what you think of this project or the GIPHY API in the comments below. Or give us some suggestions on which APIs we should mash up next!

5 / 5 ( 171 votes )

Also published on Medium.

« How to Navigate and Connect to Instagram’s API [Tutorial]
Why We Invested in Automation and QA Early »

Related Blog Posts

How to Send SMS with Twilio (using Python & Flask)
How to Send SMS with Twilio (using Python & Flask)

How to Send SMS Messages with PHP (using Nexmo or Twilio)
How to Send SMS Messages with PHP (using Nexmo or Twilio)

How to Use the Twilio APIs on the RapidAPI Marketplace
How to Use the Twilio APIs on the RapidAPI Marketplace

List of Top SMS APIs to Send Text Messages (Updated for 2019)
List of Top SMS APIs to Send Text Messages (Updated for 2019)

Bing News Search API Example: News Sentiment Analysis & Summarization (with the AylienText Analysis API)
Bing News Search API Example: News Sentiment Analysis & Summarization (with the AylienText Analysis API)

How to Create Your Own RESTful API (20+ Tutorials by Programming Language)
How to Create Your Own RESTful API (20+ Tutorials by Programming Language)


Filed Under: API Smash, Case Study Tagged With: project, project api smash, twilio api

Lindsey

Content Marketer at RapidAPI.

Reader Interactions

Comments

  1. Joseph Golstein says

    June 28, 2018 at 2:25 am

    Nice

    Reply
  2. Joseph Golstein says

    July 3, 2018 at 2:09 am

    Wow

    Reply
    • RapidAPI Staff says

      July 3, 2018 at 9:49 am

      Thanks for dropping by Joseph! Hope this was helpful!

      Reply

Leave a Reply

Your email address will not be published. Required fields are marked *

Primary Sidebar

Build amazing apps, faster.

Discover, evaluate, and integrate with any API. RapidAPI is the world’s largest API marketplace with over 1,000,000 developers and 10,000 APIs.

Browse APIs

Footer

Learn

  • How to use an API
  • Skyscanner Travel API Overview
  • API Glossary
  • For Developers
  • For API Providers
  • About
  • Team
  • Jobs
  • Contact Us
  • API Directory
  • Press Room
  • Privacy Policy
  • Terms of Use

© 2019 RapidAPI. All rights reserved.