Extremos

En esta página, se proporciona información sobre cada extremo disponible a través de la API de Tenor. En cada extremo, esta página proporciona lo siguiente:

  • La URL base que se usará
  • Prácticas recomendadas
  • Los parámetros disponibles
  • El formato de la respuesta
  • Ejemplos de solicitudes en cada idioma
https://tenor.googleapis.com/v2/search?<parameters>

Obtén un objeto JSON que contenga una lista de los GIFs más relevantes para un conjunto determinado de términos de búsqueda, categorías, emojis o cualquier combinación de estos.

Cuando incluyes el parámetro de URL searchfilter=sticker en la solicitud, el extremo de búsqueda de Tenor devuelve calcomanías en lugar de GIFs. Los objetos de respuesta en las respuestas de búsqueda de calcomanías incluyen formatos transparentes en el campo media_formats.

Para devolver los resultados en un orden aleatorio, en lugar de ordenarlos por relevancia, incluye el parámetro de URL random=true.

  • Para diferenciar tus integraciones, proporciona un parámetro client_key junto con el key de la API.
  • Proporciona la búsqueda del usuario tal como se escribió, incluidos los signos de puntuación y los caracteres especiales.
  • Cuando un usuario decide qué GIF o calcomanía compartir, te recomendamos que también incluyas una llamada correspondiente al extremo Register Share. Esta llamada opcional ayuda a la IA del motor de búsqueda de Tenor a ajustar sus resultados.
  • Para controlar la cantidad y el flujo de GIFs que se muestran, usa los parámetros limit y pos. Por ejemplo, puedes establecer limit = 10 para los resultados de la búsqueda inicial del usuario y cargar vistas previas de esos GIFs para que el usuario los explore. Si el usuario solicita más resultados, recopila los siguientes 10 realizando la misma llamada a la API, pero con pos establecido en el valor del campo next de la respuesta inicial. Puedes usar este patrón para crear una experiencia de carga diferida fluida. Esto ayuda a reducir el uso de ancho de banda y proporciona un tiempo de respuesta más rápido para el usuario, ya que se deben cargar menos vistas previas de GIFs en paralelo del lado del cliente.
  • Para mantener tus clasificaciones internas de seguridad del contenido de los GIFs que se muestran, usa el parámetro ContentFilter. El valor predeterminado es off.
  • Para reducir la cantidad de formatos de contenido que se devuelven, usa el parámetro media_filter. Esto puede reducir el tamaño del objeto de respuesta en más del 70%.

En la siguiente tabla, se proporcionan detalles sobre los parámetros del endpoint de Search:

Parámetros

En la siguiente tabla, se proporcionan detalles sobre el formato de respuesta del extremo de Search:

Clave

Curl

/* search for excited top 8 GIFs */
curl "https://tenor.googleapis.com/v2/search?q=excited&key=API_KEY&client_key=my_test_app&limit=8"

Python

# set the apikey and limit
apikey = "API_KEY"  # click to set to your apikey
lmt = 8
ckey = "my_test_app"  # set the client_key for the integration and use the same value for all API calls

# our test search
search_term = "excited"

# get the top 8 GIFs for the search term
r = requests.get(
    "https://tenor.googleapis.com/v2/search?q=%s&key=%s&client_key=%s&limit=%s" % (search_term, apikey, ckey,  lmt))

if r.status_code == 200:
    # load the GIFs using the urls for the smaller GIF sizes
    top_8gifs = json.loads(r.content)
    print(top_8gifs)
else:
    top_8gifs = None

Android/Java

import android.app.Application;

import org.json.JSONException;
import org.json.JSONObject;

import java.io.BufferedInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.StringWriter;
import java.net.ConnectException;
import java.net.HttpURLConnection;
import java.net.URL;

public class App extends Application {

    private static final String API_KEY = "API_KEY";
    private static final String CLIENT_KEY = "my_test_app"
    private static final String LogTag = "TenorTest";

    @Override
    public void onCreate() {
        super.onCreate();

        new Thread() {
            @Override
            public void run() {

                final String searchTerm = "excited";

                // make initial search request for the first 8 items
                JSONObject searchResult = getSearchResults(searchTerm, 8);

                // load the results for the user
                Log.v(LogTag, "Search Results: " + searchResult.toString());

            }
        }.start();
    }

    /**
     * Get Search Result GIFs
     */
    public static JSONObject getSearchResults(String searchTerm, int limit) {

        // make search request - using default locale of EN_US

        final String url = String.format("https://tenor.googleapis.com/v2/search?q=%1$s&key=%2$s&client_key=%3$s&limit=%4$s",
                searchTerm, API_KEY, CLIENT_KEY, limit);
        try {
            return get(url);
        } catch (IOException | JSONException ignored) {
        }
        return null;
    }

    /**
     * Construct and run a GET request
     */
    private static JSONObject get(String url) throws IOException, JSONException {
        HttpURLConnection connection = null;
        try {
            // Get request
            connection = (HttpURLConnection) new URL(url).openConnection();
            connection.setDoInput(true);
            connection.setDoOutput(true);
            connection.setRequestMethod("GET");
            connection.setRequestProperty("Content-Type", "application/json");
            connection.setRequestProperty("Accept", "application/json");
            connection.setRequestProperty("Content-Type", "application/json; charset=UTF-8");

            // Handle failure
            int statusCode = connection.getResponseCode();
            if (statusCode != HttpURLConnection.HTTP_OK && statusCode != HttpURLConnection.HTTP_CREATED) {
                String error = String.format("HTTP Code: '%1$s' from '%2$s'", statusCode, url);
                throw new ConnectException(error);
            }

            // Parse response
            return parser(connection);
        } catch (Exception ignored) {
        } finally {
            if (connection != null) {
                connection.disconnect();
            }
        }
        return new JSONObject("");
    }

    /**
     * Parse the response into JSONObject
     */
    private static JSONObject parser(HttpURLConnection connection) throws JSONException {
        char[] buffer = new char[1024 * 4];
        int n;
        InputStream stream = null;
        try {
            stream = new BufferedInputStream(connection.getInputStream());
            InputStreamReader reader = new InputStreamReader(stream, "UTF-8");
            StringWriter writer = new StringWriter();
            while (-1 != (n = reader.read(buffer))) {
                writer.write(buffer, 0, n);
            }
            return new JSONObject(writer.toString());
        } catch (IOException ignored) {
        } finally {
            if (stream != null) {
                try {
                    stream.close();
                } catch (IOException ignored) {
                }
            }
        }
        return new JSONObject("");
    }
}

Swift 2.0 o versiones posteriores/iOS

let apikey = "API_KEY"
let clientkey = "my_test_app"

  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    requestData()

    return true
  }

  /**
   Execute web request to retrieve the top GIFs returned (in batches of 8) for the given search term.
   */
  func requestData()
  {
    // the test search term
    let searchTerm = "excited"

    // Define the results upper limit
    let limit = 8

    // make initial search request for the first 8 items
    let searchRequest = URLRequest(url: URL(string: String(format: "https://tenor.googleapis.com/v2/search?q=%@&key=%@&client_key=%@&limit=%d",
                                                             searchTerm,
                                                             apikey,
                                                             clientkey,
                                                             limit))!)

    makeWebRequest(urlRequest: searchRequest, callback: tenorSearchHandler)

    // Data will be loaded by each request's callback
  }

  /**
   Async URL requesting function.
   */
  func makeWebRequest(urlRequest: URLRequest, callback: @escaping ([String:AnyObject]) -> ())
  {
    // Make the async request and pass the resulting JSON object to the callback
    let task = URLSession.shared.dataTask(with: urlRequest) { (data, response, error) in
      do {
        if let jsonResult = try JSONSerialization.jsonObject(with: data!, options: []) as? [String:AnyObject] {
          // Push the results to our callback
          callback(jsonResult)
        }
      } catch let error as NSError {
        print(error.localizedDescription)
      }
    }
    task.resume()
  }

  /**
   Web response handler for search requests.
   */
  func tenorSearchHandler(response: [String:AnyObject])
  {
    // Parse the JSON response
    let responseGifs = response["results"]!

    // Load the GIFs into your view
    print("Result GIFS: (responseGifs)")

  }

  }

JavaScript

<!DOCTYPE html>
<html>
<script>

// url Async requesting function
function httpGetAsync(theUrl, callback)
{
    // create the request object
    var xmlHttp = new XMLHttpRequest();

    // set the state change callback to capture when the response comes in
    xmlHttp.onreadystatechange = function()
    {
        if (xmlHttp.readyState == 4 && xmlHttp.status == 200)
        {
            callback(xmlHttp.responseText);
        }
    }

    // open as a GET call, pass in the url and set async = True
    xmlHttp.open("GET", theUrl, true);

    // call send with no params as they were passed in on the url string
    xmlHttp.send(null);

    return;
}

// callback for the top 8 GIFs of search
function tenorCallback_search(responsetext)
{
    // Parse the JSON response
    var response_objects = JSON.parse(responsetext);

    top_10_gifs = response_objects["results"];

    // load the GIFs -- for our example we will load the first GIFs preview size (nanogif) and share size (gif)

    document.getElementById("preview_gif").src = top_10_gifs[0]["media_formats"]["nanogif"]["url"];

    document.getElementById("share_gif").src = top_10_gifs[0]["media_formats"]["gif"]["url"];

    return;

}


// function to call the trending and category endpoints
function grab_data()
{
    // set the apikey and limit
    var apikey = "API_KEY";
    var clientkey = "my_test_app";
    var lmt = 8;

    // test search term
    var search_term = "excited";

    // using default locale of en_US
    var search_url = "https://tenor.googleapis.com/v2/search?q=" + search_term + "&key=" +
            apikey +"&client_key=" + clientkey +  "&limit=" + lmt;

    httpGetAsync(search_url,tenorCallback_search);

    // data will be loaded by each call's callback
    return;
}


// SUPPORT FUNCTIONS ABOVE
// MAIN BELOW

// start the flow
grab_data();

</script>

<body>

<h2># 1 GIF loaded - preview image</h2>
<img id="preview_gif" src="" alt="" style="width:220px;height:164px;">

<h2># 1 GIF loaded - share image</h2>
<img id="share_gif" src="" alt="" style="width:498px;height:372px;">

</body>
</html>

Objective-C

NSString *apiKey = @"API_KEY";
NSString *clientKey = @"my_test_app";

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

  [self requestData];
  return YES;
}

/**
 Execute web request to retrieve the top GIFs returned(in batches of 8) for the given search term.
 */
-(void)requestData
{
  // Define the results upper limit
  int limit = 8;

  // the test search term
  NSString *searchQuery = @"excited";

  // Get the top 10 trending GIFs (updated through out the day) - using the default locale of en_US
  NSString *UrlString = [NSString stringWithFormat:@"https://tenor.googleapis.com/v2/search?key=%@&client_key=%@&q=%@&limit=%d", apiKey, clientKey, searchQuery, limit];
  NSURL *searchUrl = [NSURL URLWithString:UrlString];
  NSURLRequest *searchRequest = [NSURLRequest requestWithURL:searchUrl];
  [self makeWebRequest:searchRequest withCallback:tenorSearchResultsHandler];

  // Data will be loaded by each request's callback
}

/**
 Async URL requesting function.
 */
-(void)makeWebRequest:(NSURLRequest *)urlRequest withCallback:(void (^)(NSDictionary *))callback
{
  // Make the async request and pass the resulting JSON object to the callback
  NSURLSessionTask *task = [[NSURLSession sharedSession] dataTaskWithRequest:urlRequest completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
    NStopGifsError *jsonError = nil;
    NSDictionary *jsonResult = [NSJSONSerialization JSONObjectWithData:data options:NSJSONReadingMutableLeaves error:&jsonError];

    if(jsonError != nil) {
      NSLog(@"%@", jsonError.localizedDescription);
      return;
    }

    // Push the results to our callback
    callback(jsonResult);
  }];

  [task resume];
}

/**
 Web response handler for searches.
 */
void (^tenorSearchResultsHandler)(NSDictionary *) = ^void(NSDictionary *response)
{
  // Parse the JSON response
  NSDictionary *topGifs = response[@"results"];

  // Load the GIFs into your view
  NSLog(@"Search Results: %@", topGifs);
};
 
https://tenor.googleapis.com/v2/featured?<parameters>

Obtén un objeto JSON que contenga una lista de los GIFs destacados globales actuales. Tenor actualiza el stream destacado con regularidad durante el día.

Cuando el parámetro de URL searchfilter=sticker se incluye en la solicitud, el extremo de Tenor Featured devuelve calcomanías en lugar de GIFs. En las respuestas con stickers destacados, los objetos de respuesta incluyen formatos transparentes en el campo media.

  • Para diferenciar tus integraciones, proporciona un parámetro client_key junto con el key de la API.
  • Cuando un usuario decide qué GIF o calcomanía compartir, te recomendamos que también incluyas una llamada correspondiente al extremo Register Share. Esta llamada opcional ayuda a la IA del motor de búsqueda de Tenor a ajustar sus resultados.
  • Para controlar la cantidad y el flujo de GIFs que se muestran y cargan, usa los parámetros limit y pos. Por ejemplo, puedes establecer limit = 10 para los resultados de la solicitud inicial de tendencias del usuario y cargar vistas previas de esos GIFs para que el usuario los explore. Si el usuario solicita más resultados, recopila los siguientes 10 haciendo la misma llamada a la API, pero con pos establecido en el valor del campo next de la respuesta inicial. Puedes usar este patrón para crear una experiencia de carga diferida fluida. Esto ayuda a reducir el uso de ancho de banda y proporciona un tiempo de respuesta más rápido para el usuario, ya que se deben cargar menos vistas previas de GIFs en paralelo del lado del cliente.
  • Para especificar la clasificación de seguridad del contenido de GIF adecuada para tu servicio o aplicación, usa el parámetro ContentFilter.
  • Para reducir la cantidad de formatos de GIF que se muestran, usa el parámetro media_filter. Esto puede reducir el tamaño del objeto de respuesta en un 75%.

En la siguiente tabla, se proporcionan detalles sobre los parámetros del endpoint de Destacados:

Parámetros
client_key

Muy recomendada

string

Es una cadena especificada por el cliente que representa la integración.

La clave del cliente te permite usar la misma clave de API en diferentes integraciones, pero aún así podrás diferenciarlas.

Para una integración de la app, usa el mismo valor de client_key para todas las llamadas a la API.

Cualquier comportamiento personalizado del cliente se activa con la vinculación de los parámetros key y client_key.

No tiene un valor predeterminado.

En la siguiente tabla, se proporcionan detalles sobre el formato de respuesta del extremo Featured:

Clave

Curl

/* Featured GIFs call */
curl "https://tenor.googleapis.com/v2/featured?key=API_KEY&client_key=my_test_app"

Python

import requests
import json

# set the apikey and limit
apikey = "API_KEY"   # click to set to your apikey
ckey = "my_test_app"  # set the client_key for the integration
lmt = 10

# get the top 10 featured GIFs - using the default locale of en_US
r = requests.get("https://tenor.googleapis.com/v2/featured?key=%s&client_key=%s&limit=%s" % (apikey, ckey, lmt))

if r.status_code == 200:
    featured_gifs = json.loads(r.content)
else:
    featured_gifs = None

# load the featured GIFs
print (featured_gifs)

Android/Java

import android.app.Application;

import org.json.JSONException;
import org.json.JSONObject;

import java.io.BufferedInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.StringWriter;
import java.net.ConnectException;
import java.net.HttpURLConnection;
import java.net.URL;

public class App extends Application {

    private static final String API_KEY = "API_KEY";
    private static final String CLIENT_KEY = "my_test_app";
    private static final String LogTag = "TenorTest";

    @Override
    public void onCreate() {
        super.onCreate();

        new Thread() {
            @Override
            public void run() {

                // get the top 10 featured GIFs
                JSONObject featuredGifs = getFeaturedGifs(10);

                // load the results for the user
                Log.v(LogTag, "Featured GIFS: " + featuredGifs.toString());

            }
        }.start();
    }

    /**
     * Get featured GIFs
     */
    public static JSONObject getFeaturedGifs(int limit) {

        // get the Featured GIFS - using the default locale of en_US
        final String url = String.format("https://tenor.googleapis.com/v2/featured?key=%1$s&client_key=%2$s&limit=%3$s",
                API_KEY, CLIENT_KEY, limit);
        try {
            return get(url);
        } catch (IOException | JSONException ignored) {
        }
        return null;
    }


    /**
     * Construct and run a GET request
     */
    private static JSONObject get(String url) throws IOException, JSONException {
        HttpURLConnection connection = null;
        try {
            // Get request
            connection = (HttpURLConnection) new URL(url).openConnection();
            connection.setDoInput(true);
            connection.setDoOutput(true);
            connection.setRequestMethod("GET");
            connection.setRequestProperty("Content-Type", "application/json");
            connection.setRequestProperty("Accept", "application/json");
            connection.setRequestProperty("Content-Type", "application/json; charset=UTF-8");

            // Handle failure
            int statusCode = connection.getResponseCode();
            if (statusCode != HttpURLConnection.HTTP_OK && statusCode != HttpURLConnection.HTTP_CREATED) {
                String error = String.format("HTTP Code: '%1$s' from '%2$s'", statusCode, url);
                throw new ConnectException(error);
            }

            // Parse response
            return parser(connection);
        } catch (Exception ignored) {
        } finally {
            if (connection != null) {
                connection.disconnect();
            }
        }
        return new JSONObject("");
    }

    /**
     * Parse the response into JSONObject
     */
    private static JSONObject parser(HttpURLConnection connection) throws JSONException {
        char[] buffer = new char[1024 * 4];
        int n;
        InputStream stream = null;
        try {
            stream = new BufferedInputStream(connection.getInputStream());
            InputStreamReader reader = new InputStreamReader(stream, "UTF-8");
            StringWriter writer = new StringWriter();
            while (-1 != (n = reader.read(buffer))) {
                writer.write(buffer, 0, n);
            }
            return new JSONObject(writer.toString());
        } catch (IOException ignored) {
        } finally {
            if (stream != null) {
                try {
                    stream.close();
                } catch (IOException ignored) {
                }
            }
        }
        return new JSONObject("");
    }
}

Swift 2.0 o versiones posteriores/iOS

let apikey = "API_KEY"
let clientkey = "my_test_app"

  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    requestData()

    return true
  }

  /**
   Execute web requests to retrieve featured GIFs
   */
  func requestData()
  {
    // Define the results upper limit
    let limit = 10

    // Get the top 10 featured GIFs (updated throughout the day) - using the default locale of en_US
    let featuredRequest = URLRequest(url: URL(string: String(format: "https://tenor.googleapis.com/v2/featured?key=%@&client_key=%@&limit=%d",
                                                             apikey,
                                                             clientkey,
                                                             limit))!)
    makeWebRequest(urlRequest: featuredRequest, callback: tenorFeaturedResultsHandler)
    // Data will be loaded by the request's callback
  }

  /**
   Async URL requesting function.
   */
  func makeWebRequest(urlRequest: URLRequest, callback: @escaping ([String:AnyObject]) -> ())
  {
    // Make the async request and pass the resulting JSON object to the callback
    let task = URLSession.shared.dataTask(with: urlRequest) { (data, response, error) in
      do {
        if let jsonResult = try JSONSerialization.jsonObject(with: data!, options: []) as? [String:AnyObject] {
          // Push the results to our callback
          callback(jsonResult)
        }
      } catch let error as NSError {
        print(error.localizedDescription)
      }
    }
    task.resume()
  }

  /**
   Web response handler for featured top 10 GIFs.
   */
  func tenorFeaturedResultsHandler(response: [String:AnyObject])
  {
    // Parse the JSON response
    let topTenGifs = response["results"]!

    // Load the GIFs into your view
    print("Featured Results: (topTenGifs)")
  }

  }

JavaScript

<!DOCTYPE html>
<html>
<script>

// url Async requesting function
function httpGetAsync(theUrl, callback)
{
    // create the request object
    var xmlHttp = new XMLHttpRequest();

    // set the state change callback to capture when the response comes in
    xmlHttp.onreadystatechange = function()
    {
        if (xmlHttp.readyState == 4 && xmlHttp.status == 200)
        {
            callback(xmlHttp.responseText);
        }
    }

    // open as a GET call, pass in the url and set async = True
    xmlHttp.open("GET", theUrl, true);

    // call send with no params as they were passed in on the url string
    xmlHttp.send(null);

    return;
}

// callback for featured top 10 GIFs
function tenorCallback_featured(responsetext)
{
    // Parse the JSON response
    var response_objects = JSON.parse(responsetext);

    top_10_gifs = response_objects["results"];

    // load the GIFs -- for our example we will load the first GIFs preview size (nanogif) and share size (gif)

    document.getElementById("preview_gif").src = top_10_gifs[0]["media_formats"]["nanogif"]["url"];

    document.getElementById("share_gif").src = top_10_gifs[0]["media_formats"]["gif"]["url"];

    return;

}


// function to call the featured endpoint
function grab_data()
{
    // set the apikey and limit
    var apikey = "API_KEY";
    var clientkey = "my_test_app";
    var lmt = 10;

    // get the top 10 featured GIFs (updated throughout the day) - using the default locale of en_US
    var featured_url = "https://tenor.googleapis.com/v2/featured?key=" + apikey + "&client_key=" + clientkey + "&limit=" + lmt;


    httpGetAsync(featured_url,tenorCallback_featured);

    // data will be loaded by each call's callback
    return;
}


// SUPPORT FUNCTIONS ABOVE
// MAIN BELOW

// start the flow
grab_data();

</script>
<style>
.container {
    position: relative;
    text-align: center;
    color: white;
}
.title {
text-align: center;
}
.centered {
    position: absolute;
    top: 50%;
    left: 50%;
    transform: translate(-50%, -50%);
}
</style>

<body>

<h2 class="title">GIF loaded - preview image</h2>
<div class="container">
<img id="preview_gif" src="" alt="" style="">
</div>

<h2 class="title">GIF loaded - share image</h2>
<div class="container">
<img id="share_gif" src="" alt="" style="">
</div>

</body>
</html>

Objective-C

NSString *apiKey = @"API_KEY";
NSString *clientKey = @"my_test_app";

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

  [self requestData];
  return YES;
}

/**
 Execute web requests to retrieve featured GIFs
 */
-(void)requestData
{
  // Define the results upper limit
  int limit = 10;

  // Get the top 10 featured GIFs (updated throughout the day) - using the default locale of en_US
  NSString *featuredUrlString = [NSString stringWithFormat:@"https://tenor.googleapis.com/v2/featured?key=%@&client_key=%@&limit=%d", apiKey, clientKey, limit];
  NSURL *featuredUrl = [NSURL URLWithString:featuredUrlString];
  NSURLRequest *featuredRequest = [NSURLRequest requestWithURL:featuredUrl];
  [self makeWebRequest:featuredRequest withCallback:tenorFeaturedResultsHandler];

  // Data will be loaded by each request's callback
}

/**
 Async URL requesting function.
 */
-(void)makeWebRequest:(NSURLRequest *)urlRequest withCallback:(void (^)(NSDictionary *))callback
{
  // Make the async request and pass the resulting JSON object to the callback
  NSURLSessionTask *task = [[NSURLSession sharedSession] dataTaskWithRequest:urlRequest completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
    NSError *jsonError = nil;
    NSDictionary *jsonResult = [NSJSONSerialization JSONObjectWithData:data options:NSJSONReadingMutableLeaves error:&jsonError];

    if(jsonError != nil) {
      NSLog(@"%@", jsonError.localizedDescription);
      return;
    }

    // Push the results to our callback
    callback(jsonResult);
  }];

  [task resume];
}

/**
 Web response handler for featured top 10 GIFs.
 */
void (^tenorFeaturedResultsHandler)(NSDictionary *) = ^void(NSDictionary *response)
{
  // Parse the JSON response
  NSDictionary *topTenGifs = response[@"results"];

  // Load the GIFs into your view
  NSLog(@"Featured Results: %@", topTenGifs);
};

Categorías

URL base

https://tenor.googleapis.com/v2/categories?<parameters>

Obtén un objeto JSON que contenga una lista de categorías de GIFs asociadas con el tipo proporcionado. Cada categoría incluye una URL de búsqueda correspondiente para usar si el usuario hace clic en la categoría. La URL de búsqueda incluye todos los parámetros de la llamada original al endpoint de Categories.

Tipos admitidos

  • featured (predeterminado): Son las categorías actuales de GIFs destacados basados en emociones o reacciones. Esto incluye un GIF de vista previa para cada término.
  • trending: Son los términos de búsqueda populares actuales. Esto incluye un GIF de vista previa para cada término.

Prácticas recomendadas

  • Para diferenciar tus integraciones, proporciona un parámetro client_key junto con el key de la API.
  • Usa el parámetro locale para convertir los nombres de las categorías al idioma del usuario. El valor predeterminado es en_US.
  • Para especificar la clasificación de seguridad del contenido de GIF adecuada para tu servicio o aplicación, usa el parámetro ContentFilter. Cuando se usa, el parámetro ContentFilter se pasa a todas las URLs de búsqueda que se encuentran en el categories objeto Response.

Parámetros

En la siguiente tabla, se proporcionan detalles sobre los parámetros del endpoint de Categories:

Parámetros
key

Obligatorio

string

Clave de API para el acceso a la API con privilegios

No tiene un valor predeterminado.
client_key

Muy recomendada

string

Es una cadena especificada por el cliente que representa la integración.

Una clave de cliente te permite usar la misma clave de API en diferentes integraciones, pero aún así podrás diferenciarlas.

Para una integración de la app, usa el mismo valor de client_key para todas las llamadas a la API.

Cualquier comportamiento personalizado del cliente se activa con la vinculación de los parámetros key y client_key.

No tiene un valor predeterminado.
country

Muy recomendada

string (YY)

Especifica el país de origen de la solicitud. Para ello, proporciona el código de país ISO 3166-1 de dos letras.

El valor predeterminado es US.
locale

Muy recomendada

string (xx_YY)

Especifica el idioma predeterminado para interpretar la cadena de búsqueda. xx es el código de idioma ISO 639-1 del idioma, mientras que el valor opcional _YY es el código de país ISO 3166-1 de dos letras.

Puedes usar el código de país que proporcionas en locale para diferenciar entre los dialectos del idioma determinado.

El valor predeterminado es en_US.
type

Muy recomendada

string

Determina el tipo de categorías que se muestran.

El valor predeterminado es featured. Los valores aceptados son featured y trending.
contentfilter

Muy recomendada

enum

Especifica el nivel del filtro de seguridad del contenido.

El valor predeterminado es off. Los valores aceptados son off, low, medium y high.

Formato de respuesta

En la siguiente tabla, se proporcionan detalles sobre el formato de respuesta del endpoint de Categories:

Clave
tags

CATEGORY_OBJECT[]

Es un array de CATEGORY_OBJECTS, en el que el campo name se tradujo al idioma locale.

Solicitudes de ejemplo

Curl

/* categories call */
curl "https://tenor.googleapis.com/v2/categories?key=API_KEY&client_key=my_test_app"

Python

import requests
import json

# set the apikey and limit
apikey = "API_KEY"   # click to set to your apikey
ckey = "my_test_app"  # set the client_key for the integration

# get the current list of categories - using the default locale of en_US
r = requests.get("https://tenor.googleapis.com/v2/categories?key=%s&client_key=%s" % (apikey, ckey))

if r.status_code == 200:
    categories = json.loads(r.content)
else:
    categories = None

# load the categories below the search bar for the user
print (categories)

Android/Java

import android.app.Application;

import org.json.JSONException;
import org.json.JSONObject;

import java.io.BufferedInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.StringWriter;
import java.net.ConnectException;
import java.net.HttpURLConnection;
import java.net.URL;

public class App extends Application {

    private static final String API_KEY = "API_KEY";
    private static final String CLIENT_KEY = "my_test_app";
    private static final String LogTag = "TenorTest";

    @Override
    public void onCreate() {
        super.onCreate();

        new Thread() {
            @Override
            public void run() {

                // get the current list of categories
                JSONObject categories = getCategories();

                // load the results for the user
                Log.v(LogTag, "GIF Categories: " + categories.toString());

            }
        }.start();
    }


    /**
     * Get categories
     */
    public static JSONObject getCategories() {

        // get the categories - using the default locale of en_US
        final String url = String.format("https://tenor.googleapis.com/v2/categories?key=%1$s&client_key=%2$s",
                API_KEY, CLIENT_KEY);
        try {
            return get(url);
        } catch (IOException | JSONException ignored) {
        }
        return null;
    }

    /**
     * Construct and run a GET request
     */
    private static JSONObject get(String url) throws IOException, JSONException {
        HttpURLConnection connection = null;
        try {
            // Get request
            connection = (HttpURLConnection) new URL(url).openConnection();
            connection.setDoInput(true);
            connection.setDoOutput(true);
            connection.setRequestMethod("GET");
            connection.setRequestProperty("Content-Type", "application/json");
            connection.setRequestProperty("Accept", "application/json");
            connection.setRequestProperty("Content-Type", "application/json; charset=UTF-8");

            // Handle failure
            int statusCode = connection.getResponseCode();
            if (statusCode != HttpURLConnection.HTTP_OK && statusCode != HttpURLConnection.HTTP_CREATED) {
                String error = String.format("HTTP Code: '%1$s' from '%2$s'", statusCode, url);
                throw new ConnectException(error);
            }

            // Parse response
            return parser(connection);
        } catch (Exception ignored) {
        } finally {
            if (connection != null) {
                connection.disconnect();
            }
        }
        return new JSONObject("");
    }

    /**
     * Parse the response into JSONObject
     */
    private static JSONObject parser(HttpURLConnection connection) throws JSONException {
        char[] buffer = new char[1024 * 4];
        int n;
        InputStream stream = null;
        try {
            stream = new BufferedInputStream(connection.getInputStream());
            InputStreamReader reader = new InputStreamReader(stream, "UTF-8");
            StringWriter writer = new StringWriter();
            while (-1 != (n = reader.read(buffer))) {
                writer.write(buffer, 0, n);
            }
            return new JSONObject(writer.toString());
        } catch (IOException ignored) {
        } finally {
            if (stream != null) {
                try {
                    stream.close();
                } catch (IOException ignored) {
                }
            }
        }
        return new JSONObject("");
    }
}

Swift 2.0 o versiones posteriores/iOS

let apikey = "API_KEY"
let clientkey = "my_test_app"

  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    requestData()

    return true
  }

  /**
   Execute web requests to retrieve featured GIFs and GIF categories.
   */
  func requestData()
  {

    // Get the current list of categories - using the default locale of en_US
    let categoryRequest = URLRequest(url: URL(string: String(format: "https://tenor.googleapis.com/v2/categories?key=%@&client_key=%@",
                                                             apikey, clientkey))!)
    makeWebRequest(urlRequest: categoryRequest, callback: tenorCategoryResultsHandler)

    // Data will be loaded by each request's callback
  }

  /**
   Async URL requesting function.
   */
  func makeWebRequest(urlRequest: URLRequest, callback: @escaping ([String:AnyObject]) -> ())
  {
    // Make the async request and pass the resulting JSON object to the callback
    let task = URLSession.shared.dataTask(with: urlRequest) { (data, response, error) in
      do {
        if let jsonResult = try JSONSerialization.jsonObject(with: data!, options: []) as? [String:AnyObject] {
          // Push the results to our callback
          callback(jsonResult)
        }
      } catch let error as NSError {
        print(error.localizedDescription)
      }
    }
    task.resume()
  }

  /**
   Web response handler for GIF categories.
   */
  func tenorCategoryResultsHandler(response: [String:AnyObject])
  {
    // Parse the JSON response
    let categories = response["tags"]!

    // Load the categories into your view
    print("Category Results: (categories)")
  }

  }

JavaScript

<!DOCTYPE html>
<html>
<script>

// url Async requesting function
function httpGetAsync(theUrl, callback)
{
    // create the request object
    var xmlHttp = new XMLHttpRequest();

    // set the state change callback to capture when the response comes in
    xmlHttp.onreadystatechange = function()
    {
        if (xmlHttp.readyState == 4 && xmlHttp.status == 200)
        {
            callback(xmlHttp.responseText);
        }
    }

    // open as a GET call, pass in the url and set async = True
    xmlHttp.open("GET", theUrl, true);

    // call send with no params as they were passed in on the url string
    xmlHttp.send(null);

    return;
}

// callback for GIF categories
function tenorCallback_categories(responsetext)
{
    // Parse the JSON response
    var response_objects = JSON.parse(responsetext);

    categories = response_objects["tags"];

    // load the categories - example is for the first category

    // url to load:
    var imgurl = categories[0]["image"];

    // text to overlay on image:
    var txt_overlay = categories[0]["name"];


    // search to run if user clicks the category
    var category_search_path = categories[0]["path"];

    document.getElementById("category_gif").src = imgurl
    document.getElementById("catgif_caption").innerHTML = txt_overlay
    document.getElementById("cat_link").href = category_search_path

    return;
}

// function to call the category endpoints
function grab_data()
{
    // set the apikey and limit
    var apikey = "API_KEY";
    var clientkey = "my_test_app";

    // get the current list of categories - using the default locale of en_US
    var cat_url = "https://tenor.googleapis.com/v2/categories?key=" + apikey + "&client_key=" + clientkey;

    httpGetAsync(cat_url,tenorCallback_categories);

    // data will be loaded by each call's callback
    return;
}


// SUPPORT FUNCTIONS ABOVE
// MAIN BELOW

// start the flow
grab_data();

</script>
<style>
.container {
    position: relative;
    text-align: center;
    color: white;
}
.title {
text-align: center;
}
.centered {
    position: absolute;
    top: 50%;
    left: 50%;
    transform: translate(-50%, -50%);
}
</style>

<body>

<h2 class="title">GIF Category</h2>
<div class="container">
    <a id="cat_link" href="">
        <img id="category_gif" src="" alt="" style="">
        <div id="catgif_caption" class="centered"></div>
    </a>
</div>

</body>
</html>

Objective-C

NSString *apiKey = @"API_KEY";
NSString *clientKey = @"my_test_app";

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

  [self requestData];
  return YES;
}

/**
 Execute web requests to retrieve GIF categories.
 */
-(void)requestData
{

  // Get the current list of categories - using the default locale of en_US
  NSString *categoryUrlString = [NSString stringWithFormat:@"https://tenor.googleapis.com/v2/categories?key=%@&client_key=%@", apiKey, clientKey];
  NSURL *categoryUrl = [NSURL URLWithString:categoryUrlString];
  NSURLRequest *categoryRequest = [NSURLRequest requestWithURL:categoryUrl];
  [self makeWebRequest:categoryRequest withCallback:tenorCategoryResultsHandler];

  // Data will be loaded by each request's callback
}

/**
 Async URL requesting function.
 */
-(void)makeWebRequest:(NSURLRequest *)urlRequest withCallback:(void (^)(NSDictionary *))callback
{
  // Make the async request and pass the resulting JSON object to the callback
  NSURLSessionTask *task = [[NSURLSession sharedSession] dataTaskWithRequest:urlRequest completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
    NSError *jsonError = nil;
    NSDictionary *jsonResult = [NSJSONSerialization JSONObjectWithData:data options:NSJSONReadingMutableLeaves error:&jsonError];

    if(jsonError != nil) {
      NSLog(@"%@", jsonError.localizedDescription);
      return;
    }

    // Push the results to our callback
    callback(jsonResult);
  }];

  [task resume];
}

/**
 Web response handler for GIF categories.
 */
void (^tenorCategoryResultsHandler)(NSDictionary *) = ^void(NSDictionary *response)
{
  // Parse the JSON response
  NSDictionary *categories = response[@"tags"];

  // Load the categories into your view
  NSLog(@"Category Results: %@", categories);
};

Sugerencias de búsqueda

URL base

https://tenor.googleapis.com/v2/search_suggestions?<parameters>

Obtén un objeto JSON que contenga una lista de términos de búsqueda alternativos para un término de búsqueda determinado.

Las sugerencias de búsqueda ayudan a los usuarios a acotar su búsqueda o descubrir términos de búsqueda relacionados para encontrar un GIF más preciso. La API devuelve los resultados en orden de lo que es más probable que genere un uso compartido para un término determinado, según el historial de búsquedas y el comportamiento de uso compartido de los usuarios.

Prácticas recomendadas

  • Para diferenciar tus integraciones, proporciona un parámetro client_key junto con el key de la API.
  • Mostrar los resultados en el orden que proporciona la respuesta

Parámetros

En la siguiente tabla, se proporcionan detalles sobre los parámetros del endpoint de Sugerencias de búsqueda:

Parámetros
key

Obligatorio

string

Clave de API para el acceso a la API con privilegios

No tiene un valor predeterminado.
q

Obligatorio

string

Una cadena de búsqueda

No tiene un valor predeterminado.
client_key

Muy recomendada

string

Es una cadena especificada por el cliente que representa la integración.

Una clave de cliente te permite usar la misma clave de API en diferentes integraciones, pero aún así podrás diferenciarlas.

Para una integración de la app, usa el mismo valor de client_key para todas las llamadas a la API.

Cualquier comportamiento personalizado del cliente se activa con la vinculación de los parámetros key y client_key.

No tiene un valor predeterminado.
country

Muy recomendada

string (YY)

Especifica el país de origen de la solicitud. Para ello, proporciona el código de país ISO 3166-1 de dos letras.

El valor predeterminado es US.
locale

Muy recomendada

string (xx_YY)

Especifica el idioma predeterminado para interpretar la cadena de búsqueda. xx es el código de idioma ISO 639-1 del idioma, mientras que el valor opcional _YY es el código de país ISO 3166-1 de dos letras.

Puedes usar el código de país que proporcionas en locale para diferenciar entre los dialectos del idioma determinado.

El valor predeterminado es en_US.
limit

Opcional

integer

Recupera hasta la cantidad especificada de resultados.

El valor predeterminado es 20 y el valor máximo es 50.

Formato de respuesta

En la siguiente tabla, se proporcionan detalles sobre el formato de respuesta del extremo de sugerencias de búsqueda:

Clave
results

string[]

Es un array de términos de búsqueda sugeridos.

Solicitudes de ejemplo

Curl

/* search suggestion */
curl "https://tenor.googleapis.com/v2/search_suggestions?key=API_KEY&client_key=my_test_app&q=smile&limit=5"

Python

# set the apikey and limit the # coming back
apikey = "API_KEY"   # click to set to your apikey
ckey = "my_test_app"  # set the client_key for the integration
lmt = 5

# partial search
search = "smile"

r = requests.get(
 "https://tenor.googleapis.com/v2/search_suggestions?key=%s&client_key=%s&q=%s&limit=%s" % (apikey, ckey, search, lmt))

if r.status_code == 200:
    # return the search suggestions
    search_suggestion_list = json.loads(r.content)["results"]
    print search_suggestion_list
else:
    # handle a possible error
    search_suggestion_list = []

Android/Java

import android.app.Application;

import org.json.JSONException;
import org.json.JSONObject;

import java.io.BufferedInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.StringWriter;
import java.net.ConnectException;
import java.net.HttpURLConnection;
import java.net.URL;

public class App extends Application {

    private static final String API_KEY = "API_KEY";
    private static final String CLIENT_KEY = "my_test_app";
    private static final String LogTag = "TenorTest";

    @Override
    public void onCreate() {
        super.onCreate();

        new Thread() {
            @Override
            public void run() {

                // for testing, the last search
                final String lastSearch = "smile";
                int limit = 5;

                // make the search suggestion call
                JSONObject searchSuggestionResult = searchSuggestionRequest(lastSearch, limit);

                // load the results for the user
                Log.v(LogTag, "Search Suggestion Results: " + searchSuggestionResult.toString());

            }
        }.start();
    }

    /**
     * Autocomplete Request
     */
    public static JSONObject searchSuggestionRequest(String lastSearch, int limit) {

        // make an autocomplete request - using default locale of EN_US
        final String url = String.format("https://tenor.googleapis.com/v2/search_suggestions?key=%1$s&client_key=%2$s&q=%3$s&limit=%4$s",
                API_KEY, CLIENT_KEY, lastSearch, limit);
        try {
            return get(url);
        } catch (IOException | JSONException ignored) {
        }
        return null;
    }

    /**
     * Construct and run a GET request
     */
    private static JSONObject get(String url) throws IOException, JSONException {
        HttpURLConnection connection = null;
        try {
            // Get request
            connection = (HttpURLConnection) new URL(url).openConnection();
            connection.setDoInput(true);
            connection.setDoOutput(true);
            connection.setRequestMethod("GET");
            connection.setRequestProperty("Content-Type", "application/json");
            connection.setRequestProperty("Accept", "application/json");
            connection.setRequestProperty("Content-Type", "application/json; charset=UTF-8");

            // Handle failure
            int statusCode = connection.getResponseCode();
            if (statusCode != HttpURLConnection.HTTP_OK && statusCode != HttpURLConnection.HTTP_CREATED) {
                String error = String.format("HTTP Code: '%1$s' from '%2$s'", statusCode, url);
                throw new ConnectException(error);
            }

            // Parse response
            return parser(connection);
        } catch (Exception ignored) {
        } finally {
            if (connection != null) {
                connection.disconnect();
            }
        }
        return new JSONObject("");
    }

    /**
     * Parse the response into JSONObject
     */
    private static JSONObject parser(HttpURLConnection connection) throws JSONException {
        char[] buffer = new char[1024 * 4];
        int n;
        InputStream stream = null;
        try {
            stream = new BufferedInputStream(connection.getInputStream());
            InputStreamReader reader = new InputStreamReader(stream, "UTF-8");
            StringWriter writer = new StringWriter();
            while (-1 != (n = reader.read(buffer))) {
                writer.write(buffer, 0, n);
            }
            return new JSONObject(writer.toString());
        } catch (IOException ignored) {
        } finally {
            if (stream != null) {
                try {
                    stream.close();
                } catch (IOException ignored) {
                }
            }
        }
        return new JSONObject("");
    }
}

Swift 2.0 o versiones posteriores/iOS

let apikey = "API_KEY"
let clientkey = "my_test_app"

  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    requestData()

    return true
  }

  /**
   Execute web requests to get search suggestions.
   */
  func requestData()
  {
    // for testing, the partial search
    let lastsearch = "smile"
    let limit = 5

    // Get the top 5 search suggestions - using the default locale of en_US
    let suggestRequest = URLRequest(url: URL(string: String(format: "https://tenor.googleapis.com/v2/search_suggestions?key=%@&client_key=%@&q=%@&limit=%d",
                                                             apikey,
                                                             clientkey,
                                                             lastsearch,
                                                             limit))!)
    makeWebRequest(urlRequest: suggestRequest, callback: tenorSuggestResultsHandler)

    // Data will be loaded by each request's callback
  }

  /**
   Async URL requesting function.
   */
  func makeWebRequest(urlRequest: URLRequest, callback: @escaping ([String:AnyObject]) -> ())
  {
    // Make the async request and pass the resulting JSON object to the callback
    let task = URLSession.shared.dataTask(with: urlRequest) { (data, response, error) in
      do {
        if let jsonResult = try JSONSerialization.jsonObject(with: data!, options: []) as? [String:AnyObject] {
          // Push the results to our callback
          callback(jsonResult)
        }
      } catch let error as NSError {
        print(error.localizedDescription)
      }
    }
    task.resume()
  }

  /**
   Web response handler for search suggestion requests.
   */
  func tenorSuggestResultsHandler(response: [String:AnyObject])
  {
    // Parse the JSON response
    let searchSuggestion = response["results"]!

    // Load the GIFs into your view
    print("Search Suggestion Results: (searchSuggestion)")
  }

  }

JavaScript

<!DOCTYPE html>
<html>
<script>

// url Async requesting function
function httpGetAsync(theUrl, callback)
{
    // create the request object
    var xmlHttp = new XMLHttpRequest();

    // set the state change callback to capture when the response comes in
    xmlHttp.onreadystatechange = function()
    {
        if (xmlHttp.readyState == 4 && xmlHttp.status == 200)
        {
            callback(xmlHttp.responseText);
        }
    }

    // open as a GET call, pass in the url and set async = True
    xmlHttp.open("GET", theUrl, true);

    // call send with no params as they were passed in on the url string
    xmlHttp.send(null);

    return;
}

// callback for share event
function tenorCallback_searchSuggestion(responsetext)
{
    var response_objects = JSON.parse(responsetext);

    predicted_words = response_objects["results"];

    document.getElementById("ac_1").innerHTML = predicted_words[0];
    document.getElementById("ac_2").innerHTML = predicted_words[1];
    document.getElementById("ac_3").innerHTML = predicted_words[2];
    document.getElementById("ac_4").innerHTML = predicted_words[3];
}


// SUPPORT FUNCTIONS ABOVE
// MAIN BELOW

//search term
psearch_term = "smile";

// set the apikey and limit
var apikey = "API_KEY";
var clientkey = "my_test_app";
var lmt = 5;

// using default locale of en_US
var autoc_url = "https://tenor.googleapis.com/v2/search_suggestions?key=" + apikey + "&client_key=" + clientkey + "&q=" + psearch_term + "&limit=" + lmt;

// send search suggestion request
httpGetAsync(autoc_url,tenorCallback_searchSuggestion);


</script>

<body>

<h2>Search Suggestion for "smile":</h2>
<h3 id = "ac_1"></h3>
<h3 id = "ac_2"></h3>
<h3 id = "ac_3"></h3>
<h3 id = "ac_4"></h3>

</body>
</html>

Objective-C

NSString *apiKey = @"API_KEY";
NSString *clientKey = @"my_test_app";

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

  [self requestData];
  return YES;
}

/**
   Execute web requests to get search suggestions.
   */
-(void)requestData
{
  // Define the results upper limit
  int limit = 5;

  // the test search term
  NSString *lastSearch = @"smile";

  // Get the search suggestions for the given last search - using the default locale of en_US
  NSString *UrlString = [NSString stringWithFormat:@"https://tenor.googleapis.com/v2/search_suggestions?key=%@&client_key=%@&q=%@&limit=%d", apiKey, clientKey, lastSearch, limit];
  NSURL *searchUrl = [NSURL URLWithString:UrlString];
  NSURLRequest *searchRequest = [NSURLRequest requestWithURL:searchUrl];
  [self makeWebRequest:searchRequest withCallback:tenorSearchSuggestionResultsHandler];

  // Data will be loaded by each request's callback
}

/**
 Async URL requesting function.
 */
-(void)makeWebRequest:(NSURLRequest *)urlRequest withCallback:(void (^)(NSDictionary *))callback
{
  // Make the async request and pass the resulting JSON object to the callback
  NSURLSessionTask *task = [[NSURLSession sharedSession] dataTaskWithRequest:urlRequest completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
    NStopGifsError *jsonError = nil;
    NSDictionary *jsonResult = [NSJSONSerialization JSONObjectWithData:data options:NSJSONReadingMutableLeaves error:&jsonError];

    if(jsonError != nil) {
      NSLog(@"%@", jsonError.localizedDescription);
      return;
    }

    // Push the results to our callback
    callback(jsonResult);
  }];

  [task resume];
}

/**
 Web response handler for search suggestions
 */
void (^tenorSearchSuggestionResultsHandler)(NSDictionary *) = ^void(NSDictionary *response)
{
  // Parse the JSON response
  NSDictionary *results = response[@"results"];

  // Load the GIFs into your view
  NSLog(@"Search Suggestion Result: %@", results);
};

Autocompletar

URL base

https://tenor.googleapis.com/v2/autocomplete?q=<term>&key=<API KEY>

Obtén un objeto JSON que contenga una lista de términos de búsqueda completados para un término de búsqueda parcial determinado. La lista se ordena según la IA de Tenor, y la cantidad de resultados disminuye a medida que la IA de Tenor se vuelve más precisa.

Prácticas recomendadas

  • Para diferenciar tus integraciones, proporciona un parámetro client_key junto con el key de la API.
  • Usa el parámetro locale para ajustar los resultados al idioma del usuario. El valor predeterminado es en_US.
  • Mostrar los resultados en el orden que proporciona la respuesta

Parámetros

En la siguiente tabla, se proporcionan detalles sobre los parámetros del extremo de Autocomplete:

Parámetros
key

Obligatorio

string

Clave de API para el acceso a la API con privilegios

No tiene un valor predeterminado.
q

Obligatorio

string

Una cadena de búsqueda

No tiene un valor predeterminado.
client_key

Muy recomendada

string

Es una cadena especificada por el cliente que representa la integración.

Una clave de cliente te permite usar la misma clave de API en diferentes integraciones, pero aún así podrás diferenciarlas.

Para una integración de la app, usa el mismo valor de client_key para todas las llamadas a la API.

Cualquier comportamiento personalizado del cliente se activa con la vinculación de los parámetros key y client_key.

No tiene un valor predeterminado.
country

Muy recomendada

string (YY)

Especifica el país de origen de la solicitud. Para ello, proporciona el código de país ISO 3166-1 de dos letras.

El valor predeterminado es US.
locale

Muy recomendada

string (xx_YY)

Especifica el idioma predeterminado para interpretar la cadena de búsqueda. xx es el código de idioma ISO 639-1 del idioma, mientras que el valor opcional _YY es el código de país ISO 3166-1 de dos letras.

Puedes usar el código de país que proporcionas en locale para diferenciar entre los dialectos del idioma determinado.

El valor predeterminado es en_US.
limit

Opcional

integer

Recupera hasta la cantidad especificada de resultados.

El valor predeterminado es 20 y el valor máximo es 50.

Formato de respuesta

En la siguiente tabla, se proporcionan detalles sobre el formato de respuesta del endpoint de Autocomplete:

Clave
results

string[]

Es un array de términos de búsqueda sugeridos.

Solicitudes de ejemplo

Curl

/* autocomplete */
curl "https://tenor.googleapis.com/v2/autocomplete?key=API_KEY&client_key=my_test_app&q=exc"

Python

apikey = "API_KEY"   # click to set to your apikey
ckey = "my_test_app"  # set the client_key for the integration
lmt = 5

# partial search
psearch = "exc"

r = requests.get(
    "https://tenor.googleapis.com/v2/autocomplete?key=%s&client_key=%s&q=%s&limit=%s" % (apikey, ckey, psearch, lmt))

if r.status_code == 200:
    # return the search predictions
    search_term_list = json.loads(r.content)["results"]
    print(search_term_list)
else:
    # handle a possible error
    search_term_list = []

Android/Java

import android.app.Application;

import org.json.JSONException;
import org.json.JSONObject;

import java.io.BufferedInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.StringWriter;
import java.net.ConnectException;
import java.net.HttpURLConnection;
import java.net.URL;

public class App extends Application {

    private static final String API_KEY = "API_KEY";
    private static final String CLIENT_KEY = "my_test_app";
    private static final String LogTag = "TenorTest";

    @Override
    public void onCreate() {
        super.onCreate();

        new Thread() {
            @Override
            public void run() {

                // for testing, the partial search
                final String partialSearch = "exc";
                int limit = 5;

                // make the autocomplete call
                JSONObject autoCompleteResult = autoCompleteRequest(partialSearch, limit);

                // load the results for the user
                Log.v(LogTag, "AutoComplete Results: " + autoCompleteResult.toString());

            }
        }.start();
    }

    /**
     * Autocomplete Request
     */
    public static JSONObject autoCompleteRequest(String partialSearch, int limit) {

        // make an autocomplete request - using default locale of EN_US
        final String url = String.format("https://tenor.googleapis.com/v2/autocomplete?key=%1$s&client_key=%2$s&q=%3$s&limit=%4$s",
                API_KEY, CLIENT_KEY, partialSearch, limit);
        try {
            return get(url);
        } catch (IOException | JSONException ignored) {
        }
        return null;
    }

    /**
     * Construct and run a GET request
     */
    private static JSONObject get(String url) throws IOException, JSONException {
        HttpURLConnection connection = null;
        try {
            // Get request
            connection = (HttpURLConnection) new URL(url).openConnection();
            connection.setDoInput(true);
            connection.setDoOutput(true);
            connection.setRequestMethod("GET");
            connection.setRequestProperty("Content-Type", "application/json");
            connection.setRequestProperty("Accept", "application/json");
            connection.setRequestProperty("Content-Type", "application/json; charset=UTF-8");

            // Handle failure
            int statusCode = connection.getResponseCode();
            if (statusCode != HttpURLConnection.HTTP_OK && statusCode != HttpURLConnection.HTTP_CREATED) {
                String error = String.format("HTTP Code: '%1$s' from '%2$s'", statusCode, url);
                throw new ConnectException(error);
            }

            // Parse response
            return parser(connection);
        } catch (Exception ignored) {
        } finally {
            if (connection != null) {
                connection.disconnect();
            }
        }
        return new JSONObject("");
    }

    /**
     * Parse the response into JSONObject
     */
    private static JSONObject parser(HttpURLConnection connection) throws JSONException {
        char[] buffer = new char[1024 * 4];
        int n;
        InputStream stream = null;
        try {
            stream = new BufferedInputStream(connection.getInputStream());
            InputStreamReader reader = new InputStreamReader(stream, "UTF-8");
            StringWriter writer = new StringWriter();
            while (-1 != (n = reader.read(buffer))) {
                writer.write(buffer, 0, n);
            }
            return new JSONObject(writer.toString());
        } catch (IOException ignored) {
        } finally {
            if (stream != null) {
                try {
                    stream.close();
                } catch (IOException ignored) {
                }
            }
        }
        return new JSONObject("");
    }
}

Swift 2.0 o versiones posteriores/iOS

let apikey = "API_KEY"
let clientkey = "my_test_app"

  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    requestData()

    return true
  }

  /**
   Execute web requests to get autocomplete suggestions.
   */
  func requestData()
  {
    // for testing, the partial search
    let partialSearch = "exc"
    let limit = 5

    // Get up to 5 results from the autocomplete suggestions - using the default locale of en_US
    let autoRequest = URLRequest(url: URL(string: String(format: "https://tenor.googleapis.com/v2/autocomplete?key=%@&client_key=%@&q=%@&limit=%d",
                                                             apikey,
                                                             clientkey,
                                                             partialSearch,
                                                             limit))!)
    makeWebRequest(urlRequest: autoRequest, callback: tenorAutoCompleteResultsHandler)

    // Data will be loaded by each request's callback
  }

  /**
   Async URL requesting function.
   */
  func makeWebRequest(urlRequest: URLRequest, callback: @escaping ([String:AnyObject]) -> ())
  {
    // Make the async request and pass the resulting JSON object to the callback
    let task = URLSession.shared.dataTask(with: urlRequest) { (data, response, error) in
      do {
        if let jsonResult = try JSONSerialization.jsonObject(with: data!, options: []) as? [String:AnyObject] {
          // Push the results to our callback
          callback(jsonResult)
        }
      } catch let error as NSError {
        print(error.localizedDescription)
      }
    }
    task.resume()
  }

  /**
   Web response handler for autocomplete requests.
   */
  func tenorAutoCompleteResultsHandler(response: [String:AnyObject])
  {
    // Parse the JSON response
    let autoSuggestions = response["results"]!

    // Load the GIFs into your view
    print("Autocomplete Results: (autoSuggestions)")
  }

  }

JavaScript

<!DOCTYPE html>
<html>
<script>

// url Async requesting function
function httpGetAsync(theUrl, callback)
{
    // create the request object
    var xmlHttp = new XMLHttpRequest();

    // set the state change callback to capture when the response comes in
    xmlHttp.onreadystatechange = function()
    {
        if (xmlHttp.readyState == 4 && xmlHttp.status == 200)
        {
            callback(xmlHttp.responseText);
        }
    }

    // open as a GET call, pass in the url and set async = True
    xmlHttp.open("GET", theUrl, true);

    // call send with no params as they were passed in on the url string
    xmlHttp.send(null);

    return;
}

// callback for share event
function tenorCallback_autocomplete(responsetext)
{
    var response_objects = JSON.parse(responsetext);

    predicted_words = response_objects["results"];

    document.getElementById("ac_1").innerHTML = predicted_words[0];
    document.getElementById("ac_2").innerHTML = predicted_words[1];
}

// SUPPORT FUNCTIONS ABOVE
// MAIN BELOW

//partial search term
psearch_term = "exc";

// set the apikey and limit
var apikey = "API_KEY";
var clientkey = "my_test_app";
var lmt = 5;

// using default locale of en_US
var autoc_url = "https://tenor.googleapis.com/v2/autocomplete?key=" + apikey + "&client_key=" + clientkey + "&q=" + psearch_term + "&limit=" + lmt;

// send autocomplete request
httpGetAsync(autoc_url,tenorCallback_autocomplete);


</script>

<body>

<h2>Partial Search "exc":</h2>
<h3 id = "ac_1"></h3>
<h3 id = "ac_2"></h3>

</body>
</html>

Objective-C

NSString *apiKey = @"API_KEY";
NSString *clientKey = @"my_test_app";

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

  [self requestData];
  return YES;
}

/**
   Execute web requests to get autocomplete suggestions.
   */
-(void)requestData
{
  // Define the results upper limit
  int limit = 8;

  // the test search term
  NSString *partialSearch = @"exc";

  // Get the auto complete predictions for the given partial search - using the default locale of en_US
  NSString *UrlString = [NSString stringWithFormat:@"https://tenor.googleapis.com/v2/autocomplete?key=%@&client_key=%@&q=%@&limit=%d", apiKey, clientKey, partialSearch, limit];
  NSURL *searchUrl = [NSURL URLWithString:UrlString];
  NSURLRequest *searchRequest = [NSURLRequest requestWithURL:searchUrl];
  [self makeWebRequest:searchRequest withCallback:tenorAutoCompleteResultsHandler];

  // Data will be loaded by each request's callback
}

/**
 Async URL requesting function.
 */
-(void)makeWebRequest:(NSURLRequest *)urlRequest withCallback:(void (^)(NSDictionary *))callback
{
  // Make the async request and pass the resulting JSON object to the callback
  NSURLSessionTask *task = [[NSURLSession sharedSession] dataTaskWithRequest:urlRequest completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
    NStopGifsError *jsonError = nil;
    NSDictionary *jsonResult = [NSJSONSerialization JSONObjectWithData:data options:NSJSONReadingMutableLeaves error:&jsonError];

    if(jsonError != nil) {
      NSLog(@"%@", jsonError.localizedDescription);
      return;
    }

    // Push the results to our callback
    callback(jsonResult);
  }];

  [task resume];
}

/**
 Web response handler for auto complete predictions
 */
void (^tenorAutoCompleteResultsHandler)(NSDictionary *) = ^void(NSDictionary *response)
{
  // Parse the JSON response
  NSDictionary *results = response[@"results"];

  // Load the GIFs into your view
  NSLog(@"Auto Complete Result: %@", results);
};
 
https://tenor.googleapis.com/v2/trending_terms?<parameters>

Obtén un objeto JSON que contenga una lista de los términos de búsqueda más populares actuales. La IA de Tenor actualiza la lista cada hora.

  • Para diferenciar tus integraciones, proporciona un parámetro client_key junto con el key de la API.
  • Mostrar los resultados en el orden que proporciona la respuesta

En la siguiente tabla, se proporcionan detalles sobre los parámetros del endpoint de Trending Search Terms:

Parámetros

En la siguiente tabla, se proporcionan detalles sobre el formato de respuesta del extremo de Trending Search Terms:

Clave

Curl

/* trending Terms call */
curl "https://tenor.googleapis.com/v2/trending_terms?key=API_KEY&client_key=my_test_app"

Python

import requests
import json


apikey = "API_KEY"   # click to set to your apikey
ckey = "my_test_app"  # set the client_key for the integration

# get the current list of categories - using the default locale of en_US
r = requests.get("https://tenor.googleapis.com/v2/trending_terms?key=%s&client_key=%s" % (apikey,ckey))

if r.status_code == 200:
    trending_terms = json.loads(r.content)
else:
    trending_terms = None

# load the results
print(trending_terms)

Android/Java

import android.app.Application;

import org.json.JSONException;
import org.json.JSONObject;

import java.io.BufferedInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.StringWriter;
import java.net.ConnectException;
import java.net.HttpURLConnection;
import java.net.URL;

public class App extends Application {

    private static final String API_KEY = "API_KEY";
    private static final String CLIENT_KEY = "my_test_app";
    private static final String LogTag = "TenorTest";

    @Override
    public void onCreate() {
        super.onCreate();

        new Thread() {
            @Override
            public void run() {

                // get the current list of categories
                JSONObject terms = getTrendingTerms();

                // load the results for the user
                Log.v(LogTag, "Trending Terms: " + terms.toString());

            }
        }.start();
    }

    /**
     * Get trending terms
     */
    public static JSONObject getTrendingTerms() {

        // get the categories - using the default locale of en_US
        final String url = String.format("https://tenor.googleapis.com/v2/trending_terms?key=%1$s&client_key=%2$s",
                API_KEY, CLIENT_KEY);
        try {
            return get(url);
        } catch (IOException | JSONException ignored) {
        }
        return null;
    }

    /**
     * Construct and run a GET request
     */
    private static JSONObject get(String url) throws IOException, JSONException {
        HttpURLConnection connection = null;
        try {
            // Get request
            connection = (HttpURLConnection) new URL(url).openConnection();
            connection.setDoInput(true);
            connection.setDoOutput(true);
            connection.setRequestMethod("GET");
            connection.setRequestProperty("Content-Type", "application/json");
            connection.setRequestProperty("Accept", "application/json");
            connection.setRequestProperty("Content-Type", "application/json; charset=UTF-8");

            // Handle failure
            int statusCode = connection.getResponseCode();
            if (statusCode != HttpURLConnection.HTTP_OK && statusCode != HttpURLConnection.HTTP_CREATED) {
                String error = String.format("HTTP Code: '%1$s' from '%2$s'", statusCode, url);
                throw new ConnectException(error);
            }

            // Parse response
            return parser(connection);
        } catch (Exception ignored) {
        } finally {
            if (connection != null) {
                connection.disconnect();
            }
        }
        return new JSONObject("");
    }

    /**
     * Parse the response into JSONObject
     */
    private static JSONObject parser(HttpURLConnection connection) throws JSONException {
        char[] buffer = new char[1024 * 4];
        int n;
        InputStream stream = null;
        try {
            stream = new BufferedInputStream(connection.getInputStream());
            InputStreamReader reader = new InputStreamReader(stream, "UTF-8");
            StringWriter writer = new StringWriter();
            while (-1 != (n = reader.read(buffer))) {
                writer.write(buffer, 0, n);
            }
            return new JSONObject(writer.toString());
        } catch (IOException ignored) {
        } finally {
            if (stream != null) {
                try {
                    stream.close();
                } catch (IOException ignored) {
                }
            }
        }
        return new JSONObject("");
    }
}

Swift 2.0 o versiones posteriores/iOS

let apikey = "API_KEY"
let clientkey = "my_test_app"

  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    requestData()

    return true
  }

  /**
   Execute web requests to retrieve trending terms.
   */
  func requestData()
  {

    // Get the current list of categories - using the default locale of en_US
    let categoryRequest = URLRequest(url: URL(string: String(format: "https://tenor.googleapis.com/v2/trending_terms?key=%@&client_key=%@",
                                                             apikey, clientkey))!)
    makeWebRequest(urlRequest: categoryRequest, callback: tenorTermsResultsHandler)

    // Data will be loaded by each request's callback
  }

  /**
   Async URL requesting function.
   */
  func makeWebRequest(urlRequest: URLRequest, callback: @escaping ([String:AnyObject]) -> ())
  {
    // Make the async request and pass the resulting JSON object to the callback
    let task = URLSession.shared.dataTask(with: urlRequest) { (data, response, error) in
      do {
        if let jsonResult = try JSONSerialization.jsonObject(with: data!, options: []) as? [String:AnyObject] {
          // Push the results to our callback
          callback(jsonResult)
        }
      } catch let error as NSError {
        print(error.localizedDescription)
      }
    }
    task.resume()
  }

  /**
   Web response handler for GIF categories.
   */
  func tenorTermsResultsHandler(response: [String:AnyObject])
  {
    // Parse the JSON response
    let terms = response["results"]!

    // Load the categories into your view
    print("Trending Terms Results: (terms)")
  }

  }

JavaScript

<!DOCTYPE html>
<html>
<script>

// url Async requesting function
function httpGetAsync(theUrl, callback)
{
    // create the request object
    var xmlHttp = new XMLHttpRequest();

    // set the state change callback to capture when the response comes in
    xmlHttp.onreadystatechange = function()
    {
        if (xmlHttp.readyState == 4 && xmlHttp.status == 200)
        {
            callback(xmlHttp.responseText);
        }
    }

    // open as a GET call, pass in the url and set async = True
    xmlHttp.open("GET", theUrl, true);

    // call send with no params as they were passed in on the url string
    xmlHttp.send(null);

    return;
}

// callback for GIF categories
function tenorCallback_terms(responsetext)
{
    // Parse the JSON response
    var response_objects = JSON.parse(responsetext);

    terms = response_objects["results"];

    document.getElementById("res").innerHTML = terms

    return;
}

// function to call the trending terms
function grab_data()
{
    // set the apikey and limit
    var apikey = "API_KEY";
    var clientkey = "my_test_app";
    var lmt = 10;

    // get the current list of trending terms - using the default locale of en_US
    var cat_url = "https://tenor.googleapis.com/v2/trending_terms?key=" + apikey + "&client_key=" + clientkey;

    httpGetAsync(cat_url,tenorCallback_terms);

    // data will be loaded by each call's callback
    return;
}


// SUPPORT FUNCTIONS ABOVE
// MAIN BELOW

// start the flow
grab_data();

</script>
<style>
.container {
    position: relative;
    text-align: center;
    color: white;
}
.title {
text-align: center;
}
.centered {
    position: absolute;
    top: 50%;
    left: 50%;
    transform: translate(-50%, -50%);
}
</style>

<body>

<h2 class="title">Trending Terms</h2>
<div class="container" id="res">
</div>

</body>
</html>

Objective-C

NSString *apiKey = @"API_KEY";
NSString *clientKey = @"my_test_app";

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

  [self requestData];
  return YES;
}

/**
 Execute web requests to retrieve trending terms.
 */
-(void)requestData
{

  // Get the current list of categories - using the default locale of en_US
  NSString *categoryUrlString = [NSString stringWithFormat:@"https://tenor.googleapis.com/v2/trending_terms?key=%@&client_key=%@", apiKey, clientkey];
  NSURL *categoryUrl = [NSURL URLWithString:categoryUrlString];
  NSURLRequest *categoryRequest = [NSURLRequest requestWithURL:categoryUrl];
  [self makeWebRequest:categoryRequest withCallback:tenorTermsResultsHandler];

  // Data will be loaded by each request's callback
}

/**
 Async URL requesting function.
 */
-(void)makeWebRequest:(NSURLRequest *)urlRequest withCallback:(void (^)(NSDictionary *))callback
{
  // Make the async request and pass the resulting JSON object to the callback
  NSURLSessionTask *task = [[NSURLSession sharedSession] dataTaskWithRequest:urlRequest completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
    NSError *jsonError = nil;
    NSDictionary *jsonResult = [NSJSONSerialization JSONObjectWithData:data options:NSJSONReadingMutableLeaves error:&jsonError];

    if(jsonError != nil) {
      NSLog(@"%@", jsonError.localizedDescription);
      return;
    }

    // Push the results to our callback
    callback(jsonResult);
  }];

  [task resume];
}


/**
 Web response handler for GIF categories.
 */
void (^tenorTermsResultsHandler)(NSDictionary *) = ^void(NSDictionary *response)
{
  // Parse the JSON response
  NSDictionary *terms = response[@"results"];

  // Load the categories into your view
  NSLog(@"Trending Terms: %@", terms);
};

Registro de uso compartido

URL base

https://tenor.googleapis.com/v2/registershare?<parameters>

Registra el uso compartido de un GIF o una calcomanía por parte de un usuario.

Prácticas recomendadas

  • Para diferenciar tus integraciones, proporciona un parámetro client_key junto con el key de la API.
  • Proporciona el término de búsqueda. Esto ayuda a ajustar aún más la IA del motor de búsqueda de Tenor, lo que ayuda a los usuarios a encontrar más fácilmente el GIF o la calcomanía perfectos.
  • Usa el parámetro locale para mejorar la relevancia regional del indicador de uso compartido. El valor predeterminado es en_US.

Parámetros

En la siguiente tabla, se proporcionan detalles sobre los parámetros del endpoint de Register Share:

Parámetros
key

Obligatorio

string

Clave de API para el acceso a la API con privilegios

No tiene un valor predeterminado.
id

Obligatorio

string

El id de un objeto de respuesta

No tiene un valor predeterminado.
client_key

Muy recomendada

string

Es una cadena especificada por el cliente que representa la integración.

Una clave de cliente te permite usar la misma clave de API en diferentes integraciones, pero aún así podrás diferenciarlas.

Para una integración de la app, usa el mismo valor de client_key para todas las llamadas a la API.

Cualquier comportamiento personalizado del cliente se activa con la vinculación de los parámetros key y client_key.

No tiene un valor predeterminado.
country

Muy recomendada

string (YY)

Especifica el país de origen de la solicitud. Para ello, proporciona el código de país ISO 3166-1 de dos letras.

El valor predeterminado es US.
locale

Muy recomendada

string (xx_YY)

Especifica el idioma predeterminado para interpretar la cadena de búsqueda. xx es el código de idioma ISO 639-1 del idioma, mientras que el valor opcional _YY es el código de país ISO 3166-1 de dos letras.

Puedes usar el código de país que proporcionas en locale para diferenciar entre los dialectos del idioma determinado.

El valor predeterminado es en_US.
q

Muy recomendada

string

Es la cadena de búsqueda que lleva a este recurso compartido.

No tiene un valor predeterminado.

Formato de respuesta

No hay una respuesta formal al extremo de Register Share. Los desarrolladores pueden verificar el código de respuesta HTTPS para determinar si accedieron correctamente a la API.

Solicitudes de ejemplo

Curl

/* register share */
curl "https://tenor.googleapis.com/v2/registershare?id=16989471141791455574&key=API_KEY&client_key=my_test_app&q=excited"

Python

# set the apikey
apikey = "API_KEY"   # click to set to your apikey
ckey = "my_test_app"  # set the client_key for the integration

# get the GIF's id and search used
shard_gifs_id = top_8gifs["results"][0]["id"]

search_term = "excited"

r = requests.get("https://tenor.googleapis.com/v2/registershare?id=%s&key=%s&client_key=%s&q=%s" % (shard_gifs_id, apikey, ckey, search_term))

if r.status_code == 200:
    pass
    # move on
else:
    pass
    # handle error

Android/Java

import android.app.Application;

import org.json.JSONException;
import org.json.JSONObject;

import java.io.BufferedInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.StringWriter;
import java.net.ConnectException;
import java.net.HttpURLConnection;
import java.net.URL;

public class App extends Application {

    private static final String API_KEY = "API_KEY";
    private static final String CLIENT_KEY = "my_test_app";
    private static final String LogTag = "TenorTest";

    @Override
    public void onCreate() {
        super.onCreate();

        new Thread() {
            @Override
            public void run() {

                // test values for the share example
                final String gifId = "16989471141791455574";
                final String searchTerm = "excited";

                // make the register share call
                JSONObject shareResult = registerShare(gifId, searchTerm);

                // load the results for the user
                Log.v(LogTag, "Share Results: " + shareResult.toString());

            }
        }.start();
    }

    /**
     * Register the GIF share
     */
    public static JSONObject registerShare(String gifId, String searchTerm) {

        // make register share request - using default locale of EN_US
        final String url = String.format("https://tenor.googleapis.com/v2/registershare?key=%1$s&client_key=%2$s&id=%3$s&q=%4$s",
                API_KEY, CLIENT_KEY, gifId, searchTerm);
        try {
            return get(url);
        } catch (IOException | JSONException ignored) {
        }
        return null;
    }

    /**
     * Construct and run a GET request
     */
    private static JSONObject get(String url) throws IOException, JSONException {
        HttpURLConnection connection = null;
        try {
            // Get request
            connection = (HttpURLConnection) new URL(url).openConnection();
            connection.setDoInput(true);
            connection.setDoOutput(true);
            connection.setRequestMethod("GET");
            connection.setRequestProperty("Content-Type", "application/json");
            connection.setRequestProperty("Accept", "application/json");
            connection.setRequestProperty("Content-Type", "application/json; charset=UTF-8");

            // Handle failure
            int statusCode = connection.getResponseCode();
            if (statusCode != HttpURLConnection.HTTP_OK && statusCode != HttpURLConnection.HTTP_CREATED) {
                String error = String.format("HTTP Code: '%1$s' from '%2$s'", statusCode, url);
                throw new ConnectException(error);
            }

            // Parse response
            return parser(connection);
        } catch (Exception ignored) {
        } finally {
            if (connection != null) {
                connection.disconnect();
            }
        }
        return new JSONObject("");
    }

    /**
     * Parse the response into JSONObject
     */
    private static JSONObject parser(HttpURLConnection connection) throws JSONException {
        char[] buffer = new char[1024 * 4];
        int n;
        InputStream stream = null;
        try {
            stream = new BufferedInputStream(connection.getInputStream());
            InputStreamReader reader = new InputStreamReader(stream, "UTF-8");
            StringWriter writer = new StringWriter();
            while (-1 != (n = reader.read(buffer))) {
                writer.write(buffer, 0, n);
            }
            return new JSONObject(writer.toString());
        } catch (IOException ignored) {
        } finally {
            if (stream != null) {
                try {
                    stream.close();
                } catch (IOException ignored) {
                }
            }
        }
        return new JSONObject("");
    }
}

Swift 2.0 o versiones posteriores/iOS

let apikey = "API_KEY"
let clientkey = "my_test_app"

  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    // test values for the share example
    let gifId = "16989471141791455574"
    let searchTerm = "excited"

    // register the user's share
    registerShare(gifId: gifId, searchTerm: searchTerm)

    return true
  }

  // Function for handling a user's selection of a GIF to share.
  // In a production application, the GIF id should be the "id" field of the GIF response object that the user selected
  // to share. The search term should be the user's last search.
  func registerShare(gifId: String, searchTerm: String) {

    // Register the user's share - using the default locale of en_US
    let shareRequest = URLRequest(url: URL(string: String(format: "https://tenor.googleapis.com/v2/registershare?key=%@&client_key=%@&id=%@&q=%@",
                                                             apikey,
                                                             clientkey,
                                                             gifId,
                                                             searchTerm))!)
    makeWebRequest(urlRequest: shareRequest, callback: tenorShareHandler)

    // Data will be loaded by each request's callback
  }

  /**
   Async URL requesting function.
   */
  func makeWebRequest(urlRequest: URLRequest, callback: @escaping ([String:AnyObject]) -> ())
  {
    // Make the async request and pass the resulting JSON object to the callback
    let task = URLSession.shared.dataTask(with: urlRequest) { (data, response, error) in
      do {
        if let jsonResult = try JSONSerialization.jsonObject(with: data!, options: []) as? [String:AnyObject] {
          // Push the results to our callback
          callback(jsonResult)
        }
      } catch let error as NSError {
        print(error.localizedDescription)
      }
    }
    task.resume()
  }

  /**
   Web response handler for search requests.
   */
  func tenorShareHandler(response: [String:AnyObject])
  {
   // no response expected from the registershare endpoint

  }

JavaScript

<!DOCTYPE html>
<html>
<script>

// url Async requesting function
function httpGetAsync(theUrl, callback)
{
    // create the request object
    var xmlHttp = new XMLHttpRequest();

    // set the state change callback to capture when the response comes in
    xmlHttp.onreadystatechange = function()
    {
        if (xmlHttp.readyState == 4 && xmlHttp.status == 200)
        {
            callback(xmlHttp.responseText);
        }
    }

    // open as a GET call, pass in the url and set async = True
    xmlHttp.open("GET", theUrl, true);

    // call send with no params as they were passed in on the url string
    xmlHttp.send(null);

    return;
}

// callback for share event
function tenorCallback_share(responsetext)
{
    // no action is needed in the share callback
}


// function to call the register share endpoint
function send_share(search_term,shared_gifs_id)
{
    // set the apikey and limit
    var apikey = "API_KEY";
    var clientkey = "my_test_app";

    var share_url = "https://tenor.googleapis.com/v2/registershare?id=" + shared_gifs_id + "&key=" + apikey + "&client_key=" + clientkey + "&q=" + search_term;

    httpGetAsync(share_url,tenorCallback_share);
}

// SUPPORT FUNCTIONS ABOVE
// MAIN BELOW

// grab search term from cookies or some other storage
search_term = "excited";

// GIF id from the shared gif
// shared_gifs_id = gif_json_response_object_from_search["results"][0]["id"]
shared_gifs_id = "16989471141791455574"; // example

// send the share notifcation back to Tenor
send_share(search_term,shared_gifs_id);

alert("share sent!");


</script>

<body>

</body>
</html>

Objective-C

NSString *apiKey = @"API_KEY";
NSString *clientKey = @"my_test_app";

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

  [self requestData];
  return YES;
}

/**
 Function for handling a user's selection of a GIF to share.
 In a production application, the GIF id should be the "id" field of the GIF response object that the user selected
 to share. The search term should be the user's last search.
 */
-(void)requestData
{


  // the test search term
  NSString *searchQuery = @"excited";
  NSString *gifId = @"16989471141791455574";

  //  Send the share event for the GIF id and search query
  NSString *UrlString = [NSString stringWithFormat:@"https://tenor.googleapis.com/v2/registershare?id=%@&key=%@&client_key=%@&q=%@", gifId, apiKey, clientKey, searchQuery];
  NSURL *searchUrl = [NSURL URLWithString:UrlString];
  NSURLRequest *searchRequest = [NSURLRequest requestWithURL:searchUrl];
  [self makeWebRequest:searchRequest withCallback:tenorSearchResultsHandler];

  // Data will be loaded by each request's callback
}

/**
 Async URL requesting function.
 */
-(void)makeWebRequest:(NSURLRequest *)urlRequest withCallback:(void (^)(NSDictionary *))callback
{
  // Make the async request and pass the resulting JSON object to the callback
  NSURLSessionTask *task = [[NSURLSession sharedSession] dataTaskWithRequest:urlRequest completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
    NStopGifsError *jsonError = nil;
    NSDictionary *jsonResult = [NSJSONSerialization JSONObjectWithData:data options:NSJSONReadingMutableLeaves error:&jsonError];

    if(jsonError != nil) {
      NSLog(@"%@", jsonError.localizedDescription);
      return;
    }

    // Push the results to our callback
    callback(jsonResult);
  }];

  [task resume];
}

/**
 Web response handler for registered shares
 */
void (^tenorShareResultsHandler)(NSDictionary *) = ^void(NSDictionary *response)
{
// no response expected from the registershare endpoint.
};

Publicaciones

URL base

https://tenor.googleapis.com/v2/posts?<parameters>

Obtiene los GIFs, las calcomanías o una combinación de ambos para los IDs especificados.

Prácticas recomendadas

  • Para diferenciar tus integraciones, proporciona un parámetro client_key junto con el key de la API.
  • Para reducir la cantidad de formatos de GIF que se muestran, usa el parámetro media_filter. Esto puede reducir el tamaño del objeto de respuesta en un 75%.

Parámetros

En la siguiente tabla, se proporcionan detalles sobre los parámetros del endpoint de Posts:

Parámetros
key

Obligatorio

string

Clave de API para el acceso a la API con privilegios

No tiene un valor predeterminado.
ids

Obligatorio

string

Es una lista separada por comas de los IDs de los objetos de respuesta.

No tiene un valor predeterminado y el valor máximo es 50.
client_key

Muy recomendada

string

Es una cadena especificada por el cliente que representa la integración.

Una clave de cliente te permite usar la misma clave de API en diferentes integraciones, pero aún así podrás diferenciarlas.

Para una integración de la app, usa el mismo valor de client_key para todas las llamadas a la API.

Cualquier comportamiento personalizado del cliente se activa con la vinculación de los parámetros key y client_key.

No tiene un valor predeterminado.
media_filter

Muy recomendada

string

Lista separada por comas de los formatos de GIF para filtrar los objetos de respuesta. De forma predeterminada, media_filter devuelve todos los formatos para cada objeto Response.

Ejemplo: media_filter=gif,tinygif,mp4,tinymp4

No tiene un valor predeterminado.

Formato de respuesta

En la siguiente tabla, se proporcionan detalles sobre el formato de respuesta del endpoint de Posts:

Clave
results

RESPONSE_OBJECT[]

Es un array de objetos de respuesta que corresponden a los que se pasaron en la lista ids.

Solicitudes de ejemplo

Curl

/* Posts endpoint */
curl "https://tenor.googleapis.com/v2/posts?key=API_KEY&client_key=my_test_app&ids=11586094175715197775"

Python

apikey = "API_KEY"   # click to set to your apikey
ckey = "my_test_app"  # set the client_key for the integration

# our gif id
gifid = "11586094175715197775"

# get the specific gif
r = requests.get(
    "https://tenor.googleapis.com/v2/posts?ids=%s&key=%s&client_key=%s" % (gifid, apikey,ckey))

if r.status_code == 200:
    # load the GIFs using the urls for the smaller GIF sizes
    gifs = json.loads(r.content)
    print(gifs)
else:
    gifs = None

Android/Java

import android.app.Application;

import org.json.JSONException;
import org.json.JSONObject;

import java.io.BufferedInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.StringWriter;
import java.net.ConnectException;
import java.net.HttpURLConnection;
import java.net.URL;

public class App extends Application {

    private static final String API_KEY = "API_KEY";
    private static final String CLIENT_KEY = "my_test_app";
    private static final String LogTag = "TenorTest";

    @Override
    public void onCreate() {
        super.onCreate();

        new Thread() {
            @Override
            public void run() {

                final String gif_id ="11586094175715197775";

                // get the requested gif
                JSONObject gifResult = getGifResults(gif_id);

                // load the results for the user
                Log.v(LogTag, "Gif Results: " + gifResult.toString());

            }
        }.start();
    }

    /**
     * Get Search Result GIFs
     */
    public static JSONObject getGifResults(String gif_id) {


        final String url = String.format("https://tenor.googleapis.com/v2/posts?ids=%1$s&key=%2$s&client_key=%3$s",
                gif_id, API_KEY, CLIENT_KEY);
        try {
            return get(url);
        } catch (IOException | JSONException ignored) {
        }
        return null;
    }

    /**
     * Construct and run a GET request
     */
    private static JSONObject get(String url) throws IOException, JSONException {
        HttpURLConnection connection = null;
        try {
            // Get request
            connection = (HttpURLConnection) new URL(url).openConnection();
            connection.setDoInput(true);
            connection.setDoOutput(true);
            connection.setRequestMethod("GET");
            connection.setRequestProperty("Content-Type", "application/json");
            connection.setRequestProperty("Accept", "application/json");
            connection.setRequestProperty("Content-Type", "application/json; charset=UTF-8");

            // Handle failure
            int statusCode = connection.getResponseCode();
            if (statusCode != HttpURLConnection.HTTP_OK && statusCode != HttpURLConnection.HTTP_CREATED) {
                String error = String.format("HTTP Code: '%1$s' from '%2$s'", statusCode, url);
                throw new ConnectException(error);
            }

            // Parse response
            return parser(connection);
        } catch (Exception ignored) {
        } finally {
            if (connection != null) {
                connection.disconnect();
            }
        }
        return new JSONObject("");
    }

    /**
     * Parse the response into JSONObject
     */
    private static JSONObject parser(HttpURLConnection connection) throws JSONException {
        char[] buffer = new char[1024 * 4];
        int n;
        InputStream stream = null;
        try {
            stream = new BufferedInputStream(connection.getInputStream());
            InputStreamReader reader = new InputStreamReader(stream, "UTF-8");
            StringWriter writer = new StringWriter();
            while (-1 != (n = reader.read(buffer))) {
                writer.write(buffer, 0, n);
            }
            return new JSONObject(writer.toString());
        } catch (IOException ignored) {
        } finally {
            if (stream != null) {
                try {
                    stream.close();
                } catch (IOException ignored) {
                }
            }
        }
        return new JSONObject("");
    }
}

Swift 2.0 o versiones posteriores/iOS

let apikey = "API_KEY"
let clientkey = "my_test_app"

  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    requestData()

    return true
  }

  /**
   Execute web request to the requested gif.
   */
  func requestData()
  {
    // the test gif id
    let gifid = "11586094175715197775"

    // request the gif
    let searchRequest = URLRequest(url: URL(string: String(format: "https://tenor.googleapis.com/v2/posts?ids=%@&key=%@&client_key=%@",
                                                             gifid,
                                                             apikey,
                                                             clientkey))!)

    makeWebRequest(urlRequest: searchRequest, callback: tenorgifHandler)

    // Data will be loaded by each request's callback
  }

  /**
   Async URL requesting function.
   */
  func makeWebRequest(urlRequest: URLRequest, callback: @escaping ([String:AnyObject]) -> ())
  {
    // Make the async request and pass the resulting JSON object to the callback
    let task = URLSession.shared.dataTask(with: urlRequest) { (data, response, error) in
      do {
        if let jsonResult = try JSONSerialization.jsonObject(with: data!, options: []) as? [String:AnyObject] {
          // Push the results to our callback
          callback(jsonResult)
        }
      } catch let error as NSError {
        print(error.localizedDescription)
      }
    }
    task.resume()
  }

  /**
   Web response handler for search requests.
   */
  func tenorgifHandler(response: [String:AnyObject])
  {
    // Parse the JSON response
    let responseGifs = response["results"]!

    // Load the GIFs into your view
    print("Result GIFS: (responseGifs)")

  }

  }

JavaScript

<!DOCTYPE html>
<html>
<script>

// url Async requesting function
function httpGetAsync(theUrl, callback)
{
    // create the request object
    var xmlHttp = new XMLHttpRequest();

    // set the state change callback to capture when the response comes in
    xmlHttp.onreadystatechange = function()
    {
        if (xmlHttp.readyState == 4 && xmlHttp.status == 200)
        {
            callback(xmlHttp.responseText);
        }
    }

    // open as a GET call, pass in the url and set async = True
    xmlHttp.open("GET", theUrl, true);

    // call send with no params as they were passed in on the url string
    xmlHttp.send(null);

    return;
}

// callback for the requested gif
function tenorCallback_gifs(responsetext)
{
    // Parse the JSON response
    var response_objects = JSON.parse(responsetext);

    var gif = response_objects["results"];

    // load the GIFs -- for our example we will load the first GIFs preview size (nanogif) and share size (gif)

    document.getElementById("preview_gif").src = gif[0]["media_formats"]["nanogif"]["url"];

    document.getElementById("share_gif").src = gif[0]["media_formats"]["gif"]["url"];

    return;

}


// function to call the trending and category endpoints
function grab_data()
{
    // set the apikey and limit
    var apikey = "API_KEY";
    var clientkey = "my_test_app";

    // GIF id
    var gif_id = "11586094175715197775";

    // using default locale of en_US
    var search_url = "https://tenor.googleapis.com/v2/posts?ids=" + gif_id + "&key=" +
            apikey + "&client_key=" + clientkey;

    httpGetAsync(search_url,tenorCallback_gifs);

    // data will be loaded by each call's callback
    return;
}


// SUPPORT FUNCTIONS ABOVE
// MAIN BELOW

// start the flow
grab_data();

</script>

<body>

<h2># 1 GIF loaded - preview image</h2>
<img id="preview_gif" src="" alt="" style="width:220px;height:164px;">

<h2># 1 GIF loaded - share image</h2>
<img id="share_gif" src="" alt="" style="width:498px;height:372px;">

</body>
</html>

Objective-C

NSString *apiKey = @"API_KEY";
NSString *clientKey = @"my_test_app";

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

  [self requestData];
  return YES;
}

/**
 Execute web request to retrieve the requested gif.
 */
-(void)requestData
{

  NSString *gifid = @"11586094175715197775";

  // Get the GIF
  NSString *UrlString = [NSString stringWithFormat:@"https://tenor.googleapis.com/v2/posts?key=%@&client_key=%@&ids=%@", apiKey, clientKey, gifid];
  NSURL *searchUrl = [NSURL URLWithString:UrlString];
  NSURLRequest *searchRequest = [NSURLRequest requestWithURL:searchUrl];
  [self makeWebRequest:searchRequest withCallback:tenorgifResultsHandler];

  // Data will be loaded by each request's callback
}

/**
 Async URL requesting function.
 */
-(void)makeWebRequest:(NSURLRequest *)urlRequest withCallback:(void (^)(NSDictionary *))callback
{
  // Make the async request and pass the resulting JSON object to the callback
  NSURLSessionTask *task = [[NSURLSession sharedSession] dataTaskWithRequest:urlRequest completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
    NStopGifsError *jsonError = nil;
    NSDictionary *jsonResult = [NSJSONSerialization JSONObjectWithData:data options:NSJSONReadingMutableLeaves error:&jsonError];

    if(jsonError != nil) {
      NSLog(@"%@", jsonError.localizedDescription);
      return;
    }

    // Push the results to our callback
    callback(jsonResult);
  }];

  [task resume];
}

/**
 Web response handler for searches.
 */
void (^tenorgifResultsHandler)(NSDictionary *) = ^void(NSDictionary *response)
{
  // Parse the JSON response
  NSDictionary *gif = response[@"results"];

  // Load the GIFs into your view
  NSLog(@"GIF Results: %@", gif);
};