Buy Domain_6 Account With Gif Profile Picture

Introduction
Ready to bring the engaging power of GIFs to your app through GIPHY?
By integrating with GIPHY, the first and largest GIF search engine, y'all proceeds costless admission to our always-growing content library of GIFs and Stickers — featuring the latest in amusement, sports, and breaking news from GIPHY's official content partners.
All of our content is searchable in over thirty languages and is available in various sizes so y'all go the highest quality images at the lowest file sizes. Plus, there'south all the classic reaction GIFs you'll ever need.
API Quickstart Guide
Welcome to GIPHY API, where you lot can seamlessly integrate your app with the largest GIF and Sticker library in the world.
GIPHY API is simple and fast to utilize, simply if y'all're looking for something with automatic updates and access to sectional features, our SDK might be an even better fit for you lot — check out GIPHY SDK!
Quickstart
The following guide will walk yous through the minimum feasible GIPHY API integration for a seamless GIPHY experience in your app. If you have whatsoever questions, email us at developers@giphy.com.
Utilize for an API Key(s)
-
Create a GIPHY API Key
by clicking “Create an App” on the [Programmer Dashboard](/dashboard/) (you need to create an business relationship commencement).
Notation: All API Keys start as beta keys, which are rate limited (42 reads per hour and 1000 searches/API calls per day.) -
Create separate keys for each platform (iOS, Android, Web) and department.
If you’re using a GIPHY integration in dissimilar sections of your app, GIPHY requires that each utilise of our service be delineated by a unlike central for each department per platform.
Implement Necessary API Endpoints
The GIPHY feel is brought to life with ii essential endpoints: Trending and Search.
The [Trending endpoint](/docs/api/endpoint#trending) automatically populates the about relevant and engaging content each and every day, while the [Search endpoint](/docs/api/endpoint/#search) lets users search our library of millions of GIFs and Stickers by inbound a word or phrase.
Delight Notation
All API calls need to be URL encoded.
Best Practices for Renditions
- Every GIF returned by the Trending and Search endpoints contains an
images
object with Media URLs (url
field). The
images
object returns multiple renditions. - We provide diverse renditions of each GIF in the
images
object to give your users the best experience possible. By and large, it’due south best to use the smaller fixed_height or fixed_width renditions on your preview filigree. - Once a user has selected a GIF, nowadays a higher resolution rendition.
- If you have bandwidth limitations consider using downsized_small(max 200kB), downsized (max 2MB), downsized_medium(max 5MB) renditions.
- Refer to our Rendition Guide for more information on what rendition is best suited for each use-case.
Upgrade API Cardinal(s) to Production Level
- Once your app is QA complete and close to going live, information technology’s time to upgrade your API key(s) to Production Level.
- In the Programmer Dashboard, click the “Upgrade to Production” push button for eachAPI central used in your app and consummate the instructions that follow.
Incorporate Analytics
GIPHY uses GIPHY Analytics to better search results for your users. By calling our Activity Annals Endpoint each time a user views, clicks, or sends a GIF or Sticker, nosotros volition be able to customize our responses to your user's beliefs. We highly recommend calling this endpoint on every user action in your app.
To add analytics to your app, head to our Action Register Endpoint.
Attribution
Nosotros crave all apps that employ GIPHY API to clearly brandish
"Powered Past GIPHY"
attribution marks where the API is utilized (see SDK attribution guide here). You can find canonical official logo marks here.
Earlier getting started with GIPHY API, please have a wait at our API Terms of Service.. If you currently are using GIPHY API, then the API Terms of Service apply.
Endpoints
If you desire to see these endpoints in action before getting started, you tin can utilise our API Explorer to input sample queries and view the live responses!
Trending Endpoint
GIPHY Trending returns a list of the most relevant and engaging content each and every day. Our feed of trending content is continuously updated, so y'all always accept the latest and greatest at your fingertips.
- GIPHY requires the Trending API phone call exist made from the client side.
- Optionally, use the
&rating
param to tailor the response per your preferences. Read more here about content ratings. - Optionally, you can use rendition on demand bundles to limit which renditions the API sends.
Gif URL | Sticker URL |
---|---|
api.giphy.com/v1/gifs/trending | api.giphy.com/v1/stickers/trending |
Request Parameters: | Case: | Description: |
---|---|---|
api_key: string(required) |
YOUR_API_KEY
|
GIPHY API Key. |
limit: integer (int32) |
20
|
The maximum number of objects to return. (Default: “25”) |
commencement: integer (int32) |
5
|
Specifies the starting position of the results. Default: “0” Maximum: “4999” |
rating: string |
thou
|
Filters results by specified rating. Acceptable values include thousand, pg, pg-13, r. If yous practise not specify a rating, you will receive results from all possible ratings. |
random_id: string |
e826c9fc5c929e0d6c6d423841a282aa
|
An ID/proxy for a specific user. |
parcel: string |
messaging_non_clips
|
Returns just renditions that stand for to the named package. Read more about renditions. |
Successful Response (200 OK)
- data: GIF Object[]
- pagination: Pagination Object
- meta: Meta Object
Search Endpoint
GIPHY Search gives you instant access to our library of millions of GIFs and Stickers by entering a give-and-take or phrase. With our unparalleled search algorithm, users can hands express themselves and animate their conversations.
- GIPHY requires the Search API call be fabricated from the client side.
- The search keyword should be sent to GIPHY in
&q
parameter in the API call. Search terms could simply exist words or phrases typed by the user. Users can also add the @ sign before a GIPHY username to return content from a specific GIPHY channel. All special characters should be supported and not re-encoded in your search request. - This keyword should be the exact terms the user searched for without any correction/enhancement
- Optionally, use the
&lang
parameter to point the language the user has typed in. This will help return unique regional content, if bachelor. Run across here for supported languages. - You may use the
&rating
param to tailor the response per your preferences. Read more here near content ratings - Optionally, y'all can use rendition on demand bundles to limit which renditions the API sends.
Gif URL | Sticker URL |
---|---|
api.giphy.com/v1/gifs/search | api.giphy.com/v1/stickers/search |
Request Parameters: | Example: | Clarification: |
---|---|---|
api_key: string(required) |
YOUR_API_KEY
|
GIPHY API Central. |
q: string(required) |
cheeseburgers
|
Search query term or phrase. Adding @ < username > anywhere in the q parameter effectively changes the search query to exist a search for a specific user’due south GIFs (user has to exist public and verified user past GIPHY.) If the q parameter contains one of these words: sticker, stickers, or transparent, the search will return stickers content. Maximum length: fifty chars. |
limit: integer (int32) |
20
|
The maximum number of objects to return. (Default: “25”).For beta keys max limit is 50
|
offset: integer (int32) |
5
|
Specifies the starting position of the results. Default: “0” Maximum: “4999” |
rating: string |
g
|
Filters results by specified rating. Acceptable values include g, pg, pg-13, r. If you exercise not specify a rating, y'all will receive results from all possible ratings. |
lang: string |
en
|
Specify default language for regional content; apply a 2-letter ISO 639-1 language code. |
random_id: cord |
e826c9fc5c929e0d6c6d423841a282aa
|
An ID/proxy for a specific user. |
bundle: string |
messaging_non_clips
|
Returns only renditions that stand for to the named bundle. Read more than virtually renditions. |
Successful Response (200 OK)
- data: GIF Object[]
- pagination: Pagination Object
- meta: Meta Object
Translate Endpoint
GIPHY Interpret converts words and phrases to the perfect GIF or Sticker using GIPHY's special sauce algorithm. This feature is best exhibited in GIPHY's Slack integration.
Gif URL | Sticker URL |
---|---|
api.giphy.com/v1/gifs/translate | api.giphy.com/v1/stickers/interpret |
Request Parameters: | Example: | Description: |
---|---|---|
api_key: string(required) |
YOUR_API_KEY
|
GIPHY API Key. |
due south: string(required) |
ryan gosling
|
Search term. |
weirdness: int |
10
|
Value from 0-10 which makes results weirder as you go up the scale. |
random_id: string |
e826c9fc5c929e0d6c6d423841a282aa
|
An ID/proxy for a specific user. |
Successful Response (200 OK)
- data: GIF Object
- meta: Meta Object
Random Endpoint
GIPHY Random lets you add together some weirdness to the conversation by returning a unmarried random GIF or Sticker related to the word or phrase entered. If no tag is specified, the GIF or Sticker returned is completely random.
Gif URL | Sticker URL |
---|---|
api.giphy.com/v1/gifs/random | api.giphy.com/v1/stickers/random |
Request Parameters: | Example: | Description: |
---|---|---|
api_key: cord(required) |
YOUR_API_KEY
|
GIPHY API Central. |
tag: string |
burrito
|
Filters results past specified tag.. |
rating: string |
g
|
Filters results by specified rating. If you do not specify a rating, yous will receive results from all possible ratings. |
random_id: string |
e826c9fc5c929e0d6c6d423841a282aa
|
An ID/proxy for a specific user. |
Successful Response (200 OK)
- data: GIF Object
- meta: Meta Object
Action Register Endpoint
GIPHY’s Action Register registers each time a user views, clicks, or sends a GIF or Sticker and plays an important role in helping GIPHY ameliorate your user’southward search results.
INSTRUCTIONS
On virtually all of our endpoints we return an Analytics Object for each of the GIF in the response for most endpoints.
To register an activity when user views/clicks/sends a GIF, y'all should make a request past hitting the corresponding URL in the Analytics Object equally such, and append the required params in the URL.
Impression | Click | Send |
---|---|---|
Become analytics- > onload- > url |
GET analytics- > onclick- > url |
GET analytics- > onsent- > url |
All-time Exercise
We recommend getting a Random ID for each user by using the Random ID Endpoint. This will allow GIPHY’S API to adjust responses to your users without the use of personally identifiable information.
Request Parameters: | Example: | Description: |
---|---|---|
random_id: string(required) |
e826c9fc5c929e0d6c6d423841a282aa
|
An ID/proxy for a specific user. |
ts: integer (int)(required) |
1527703430507
|
A UNIX timestamp in milliseconds corresponding to when the action occurred. |
Successful Response (200 OK)
Random ID Endpoint
GIPHY Random ID Endpoint allows GIPHY to generate a unique ID yous can assign to each new user in your app.
To go the nigh out of Random ID, nosotros recommend sending the random_id param with all compatible endpoints. This lets us conform the API response to your users’ preferences and improve their GIF experience while maintaining their privacy.
URL |
---|
api.giphy.com/v1/randomid |
Asking Parameters: | Example: | Description: |
---|---|---|
api_key: cord(required) |
YOUR_API_KEY
|
GIPHY API Key. |
Successful Response (200 OK)
- data: Random ID Object
- meta: Meta Object
Go GIF by ID Endpoint
Get GIF by ID returns a GIF’south metadata based on the GIF ID specified.
URL |
---|
api.giphy.com/v1/gifs/ { gif_id } |
Request Parameters: | Example: | Description: |
---|---|---|
api_key: cord(required) |
YOUR_API_KEY
|
GIPHY API Key. |
gif_id: string(required) |
xT4uQulxzV39haRFjG
|
The ID of the GIF yous desire details for. |
random_id: string |
e826c9fc5c929e0d6c6d423841a282aa
|
An ID/proxy for a specific user. |
Successful Response (200 OK)
- data: GIF Object
- meta: Meta Object
Get GIFs by ID Endpoint
Get GIFs by ID returns metadata of multiple GIFs based on the GIF IDs specified.
URL |
---|
api.giphy.com/v1/gifs |
Request Parameters: | Instance: | Description: |
---|---|---|
api_key: string(required) |
YOUR_API_KEY
|
GIPHY API Central. |
ids: string(required) |
xT4uQulxzV39haRFjG, 3og0IPxMM0erATueVW
|
Filters results by specified GIF IDs, separated by commas. |
random_id: string |
e826c9fc5c929e0d6c6d423841a282aa
|
An ID/proxy for a specific user. |
Successful Response (200 OK)
- data: GIF Object[]
- pagination: Pagination Object
- meta: Meta Object
Upload Endpoint
GIPHY Upload allows you to upload your content programmatically on GIPHY.com. We accept blithe GIFs or video files up to 100MB.
Note:
If y'all're using a rate-limited key assigned by the developer portal, you will not be able to specify a GIPHY channel username to your request and you will exist limited to 10 uploads per mean solar day. To have these limits removed, y'all tin apply for a production primal from your dashboard. Only approved apps volition be able to include a GIPHY channel username. You can use this endpoint to upload your content, adhere tags, and other meta tag in a unmarried HTTP or HTTPS Mail request.
URL |
---|
upload.giphy.com/v1/gifs |
Request Parameters: | Example: | Description: |
---|---|---|
api_key: cord(required) |
YOUR_API_KEY
|
GIPHY API Key. |
username: string |
JoeCool3000
|
Your assigned username (required for approved apps only). |
file: string(binary) |
The animated GIF or video file you'd like to upload. (Local file resource, required if no source_image_url supplied). | |
source_image_url: cord |
http://www.mysite.com/myfile.mp4
|
The URL for the image or video you wish to upload (required if no file parameter specified). |
tags: string |
pets, true cat, meow
|
A comma delimited listing of tags to exist applied to the upload. |
source_post_url: cord |
http://www.mysite.com/my-post/
|
The URL of the source of the asset. |
Successful Response (200 OK)
- meta: Meta Object
Categories API
Providers users a listing of Gif categories on the GIPHY network.
URL |
---|
api.giphy.com/v1/gifs/categories |
Request Parameters: | Example: | Description: |
---|---|---|
api_key: string(required) |
YOUR_API_KEY
|
GIPHY API Key. |
Successful Response (200 OK)
- data: Category Object[]
- pagination: Pagination Object
- meta: Meta Object
Autocomplete API
Providers users a list of valid terms that completes the given tag on the GIPHY network.
URL |
---|
api.giphy.com/v1/gifs/search/tags |
Asking Parameters: | Example: | Description: |
---|---|---|
api_key: string(required) |
YOUR_API_KEY
|
GIPHY API Key. |
q: string(required) |
foo
|
Tag term. |
limit: integer (int32) |
20
|
The maximum number of objects to return. (Default: 5) |
offset: integer (int32) |
5
|
Specifies the starting position of the results. (Default: 0) |
Successful Response (200 OK)
- data: Term Object[]
- meta: Meta Object
Aqueduct Search Endpoint
Channel Search endpoint returns all the GIPHY channels matching the query term
URL |
---|
api.giphy.com/v1/channels/search |
Request Parameters: | Example: | Description: |
---|---|---|
api_key: cord(required) |
YOUR_API_KEY
|
GIPHY API Key. |
q: string(required) |
foo
|
Accepts term to search through GIPHY’s channels |
limit: integer (int32) |
20
|
The maximum number of objects to return. Default: “25” Maximum: “50” |
offset: integer (int32) |
5
|
Specifies the starting position of the results. Default: “0” |
Successful Response (200 OK)
- data: Channel Object[]
- pagination: Pagination Object
- meta: Meta Object
Search Suggestions
Providers users a list of tag terms related to the given tag on the GIPHY network.
URL |
---|
api.giphy.com/v1/tags/related/ { term } |
Asking Parameters: | Example: | Description: |
---|---|---|
api_key: string(required) |
YOUR_API_KEY
|
GIPHY API Primal. |
term: string(required) |
haha
|
Tag term. |
Successful Response (200 OK)
- data: Term Object[]
- meta: Meta Object
Trending Search Terms API
Provides users a listing of the most popular trending search terms on the GIPHY network.
URL |
---|
api.giphy.com/v1/trending/searches |
Request Parameters: | Example: | Description: |
---|---|---|
api_key: cord(required) |
YOUR_API_KEY
|
GIPHY API Key. |
Successful Response (200 OK)
- data: String[]
- meta: Meta Object
Schema definitions
The GIF Object
GIF Objects are returned from most of GIPHY API'due south Endpoints. These objects contain a variety of information, such every bit the Image Object, which itself includes the URLS for multiple different GIFS formats and sizes.
Belongings | Example |
---|---|
type: string(default:"gif") By default, this is almost always GIF. |
"gif"
|
id: cord This GIF'due south unique ID |
"YsTs5ltWtEhnq"
|
slug: string The unique slug used in this GIF's URL |
"dislocated-flight-YsTs5ltWtEhnq"
|
url: string The unique URL for this GIF |
"http://giphy.com/gifs/dislocated-flying-YsTs5ltWtEhnq"
|
bitly_url: string The unique flake.ly URL for this GIF |
"http://gph.is/1gsWDcL"
|
embed_url: string A URL used for embedding this GIF |
"http://giphy.com/embed/YsTs5ltWtEhnq"
|
username: cord The username this GIF is attached to, if applicable |
"JoeCool4000"
|
source: cord The page on which this GIF was found |
"http://www.reddit.com/r/reactiongifs/comments/1xpyaa/superman_goes_to_hollywood/"
|
rating: string The MPAA-style rating for this content. Examples include Y, Grand, PG, PG-13 and R |
"yard"
|
content_url: cord Currently unused |
|
user: User An object containing information about the user associated with this GIF, if applicable. |
|
source_tld: string The superlative level domain of the source URL. |
"cheezburger.com"
|
source_post_url: string The URL of the webpage on which this GIF was establish. |
"http://cheezburger.com/5282328320"
|
update_datetime: string The date on which this GIF was last updated. |
"2013-08-01 12:41:48"
|
create_datetime: cord The date this GIF was added to the GIPHY database. |
"2013-08-01 12:41:48"
|
import_datetime: string The creation or upload date from this GIF's source. |
"2013-08-01 12:41:48"
|
trending_datetime: string The date on which this gif was marked trending, if applicative. |
"2013-08-01 12:41:48"
|
images: Images An object containing information for various available formats and sizes of this GIF. |
|
title: string The title that appears on giphy.com for this GIF. |
"Happy Dancing GIF"
|
alt_text: cord Alt text enables assistive programs to read descriptions of GIFs. |
"Barney the Regal Dinosaur blows out altogether candles."
|
The Images Object
The Images Object found in the GIF Object contains a series of Rendition Objects. These Rendition Objects includes the URLs and sizes for the many dissimilar renditions nosotros offer for each GIF. For more information and all-time practices on selecting the best prototype format for your needs, please see our Rendition Guide. (Delight note that some GIFs don’t have every property bachelor.)
Object | Property | Example |
---|---|---|
fixed_height: object Information on versions of this GIF with a fixed height of 200 pixels. Proficient for mobile employ. |
url: string The publicly-accessible direct URL for this GIF for this size of the GIF. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/200.gif"
|
width: string The width of this GIF in pixels. |
"320"
|
|
summit: string The height of this GIF in pixels. |
"200"
|
|
size: string The size of this GIF in bytes. |
"32381"
|
|
mp4: cord The URL for this GIF in .MP4 format. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/200.mp4"
|
|
mp4_size: string The size in bytes of the .MP4 file corresponding to this GIF. |
"25123"
|
|
webp: string The URL for this GIF in .webp format. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/200.webp"
|
|
webp_size: string The size in bytes of the .webp file corresponding to this GIF. |
"12321"
|
|
fixed_height_still: object Data on a static prototype of this GIF with a fixed elevation of 200 pixels. |
url: cord The publicly-accessible direct URL for this GIF. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/200_s.gif"
|
width: string The width of this GIF in pixels. |
"320"
|
|
peak: string The height of this GIF in pixels. |
"200"
|
|
fixed_height_downsampled: object Data on versions of this GIF with a fixed height of 200 pixels and the number of frames reduced to half dozen. |
url: cord The publicly-attainable direct URL for this GIF. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/200_d.gif"
|
width: string The width of this GIF in pixels. |
"320"
|
|
height: string The height of this GIF in pixels. |
"200"
|
|
size: string The size of this GIF in bytes. |
"32381"
|
|
webp: string The URL for this GIF in .webp format. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/200_d.webp"
|
|
webp_size: string The size in bytes of the .webp file respective to this GIF. |
"12321"
|
|
fixed_width: object Data on versions of this GIF with a fixed width of 200 pixels. Good for mobile use. |
url: string The publicly-accessible direct URL for this GIF. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/200w.gif"
|
width: string The width of this GIF in pixels. |
"320"
|
|
acme: string The summit of this GIF in pixels. |
"200"
|
|
size: string The size of this GIF in bytes. "32381" |
"32381"
|
|
mp4: cord The URL for this GIF in .MP4 format. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/200w.mp4"
|
|
mp4_size: cord The size in bytes of the .MP4 file respective to this GIF. |
"25123"
|
|
webp: string The URL for this GIF in .webp format. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/200w.webp"
|
|
webp_size: cord The size in bytes of the .webp file corresponding to this GIF. |
"12321"
|
|
fixed_width_still: object Information on a static image of this GIF with a fixed width of 200 pixels. |
url: string The publicly-accessible direct URL for this GIF. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/200w_s.gif"
|
width: cord The width of this GIF in pixels. |
"320"
|
|
pinnacle: cord The height of this GIF in pixels. |
"200"
|
|
fixed_width_downsampled: object Data on versions of this GIF with a fixed width of 200 pixels and the number of frames reduced to 6. |
url: string The publicly-accessible directly URL for this GIF. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/200w_d.gif"
|
width: string The width of this GIF in pixels. |
"320"
|
|
acme: string The height of this GIF in pixels. |
"200"
|
|
size: cord The size of this GIF in bytes. |
"32381"
|
|
webp: cord The URL for this GIF in .webp format. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/200w_d.webp"
|
|
webp_size: string The size in bytes of the .webp file corresponding to this GIF. |
"12321"
|
|
fixed_height_small: object Data on versions of this GIF with a fixed height of 100 pixels. Good for mobile keyboards. |
url: string The publicly-accessible directly URL for this GIF. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/100.gif"
|
width: cord The width of this GIF in pixels. |
"320"
|
|
top: string The height of this GIF in pixels. |
"100"
|
|
size: string The size of this GIF in bytes. |
"32381"
|
|
mp4: cord The URL for this GIF in .MP4 format. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/100.mp4"
|
|
mp4_size: string The size in bytes of the .MP4 file corresponding to this GIF. |
"25123"
|
|
webp: cord The URL for this GIF in .webp format. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/100.webp"
|
|
webp_size: string The size in bytes of the .webp file corresponding to this GIF. |
"12321"
|
|
fixed_height_small_still: object Information on a static image of this GIF with a stock-still height of 100 pixels. |
url: string The publicly-accessible direct URL for this GIF. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/100_s.gif"
|
width: cord The width of this GIF in pixels. |
"320"
|
|
tiptop: string The elevation of this GIF in pixels. |
"100"
|
|
fixed_width_small: object Data on versions of this GIF with a fixed width of 100 pixels. Practiced for mobile keyboards. |
url: string The publicly-accessible straight URL for this GIF. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/100w.gif"
|
width: string The width of this GIF in pixels. |
"100"
|
|
height: cord The acme of this GIF in pixels. |
"200"
|
|
size: cord The size of this GIF in bytes. |
"32381"
|
|
mp4: string The URL for this GIF in .MP4 format. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/100w.mp4"
|
|
mp4_size: cord The size in bytes of the .MP4 file corresponding to this GIF. |
"25123"
|
|
webp: string The URL for this GIF in .webp format. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/100w.webp"
|
|
webp_size: cord The size in bytes of the .webp file corresponding to this GIF. |
"12321"
|
|
fixed_width_small_still: object Data on a static image of this GIF with a stock-still width of 100 pixels. |
url: string The publicly-accessible direct URL for this GIF. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/100w_s.gif"
|
width: string The width of this GIF in pixels. |
"100"
|
|
height: cord The acme of this GIF in pixels. |
"200"
|
|
downsized: object Information on a version of this GIF downsized to be under 2mb. |
url: cord The publicly-accessible direct URL for this GIF. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy-downsized.gif"
|
width: string The width of this GIF in pixels. |
"320"
|
|
elevation: string The summit of this GIF in pixels. |
"200"
|
|
size: string The size of this GIF in bytes. |
"12381"
|
|
downsized_still: object Data on a static preview image of the downsized version of this GIF. |
url: string The publicly-accessible direct URL for this GIF. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy-downsized_s.gif"
|
width: cord The width of this GIF in pixels. |
"320"
|
|
height: string The height of this GIF in pixels. |
"200"
|
|
downsized_large: object Data on a version of this GIF downsized to be under 8mb. |
url: string The publicly-accessible direct URL for this GIF. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy-downsized-large.gif"
|
width: string The width of this GIF in pixels. |
"320"
|
|
height: cord The height of this GIF in pixels. |
"200"
|
|
size: string The size of this GIF in bytes. |
"12381"
|
|
downsized_medium: object Information on a version of this GIF downsized to be under 5mb. |
url: cord The publicly-accessible direct URL for this GIF. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy-downsized-medium.gif"
|
width: string The width of this GIF in pixels. |
"320"
|
|
tiptop: string The superlative of this GIF in pixels. |
"200"
|
|
size: string The size of this GIF in bytes. |
"12381"
|
|
downsized_small: object Data on a version of this GIF downsized to be nether 200kb. |
mp4: cord The publicly-attainable directly URL for this GIF. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/downsized_small.gif"
|
width: string The width of this GIF in pixels. |
"320"
|
|
summit: string The height of this GIF in pixels. |
"200"
|
|
mp4_size: cord The size of this GIF in bytes. |
"12381"
|
|
original: object Data on the original version of this GIF. Good for desktop use. |
width: cord The width of this GIF in pixels. |
"320"
|
height: string The height of this GIF in pixels. |
"200"
|
|
size: string The size of this GIF in bytes. |
"12381"
|
|
frames: string The number of frames in this GIF. |
"15"
|
|
mp4: cord The URL for this GIF in .MP4 format. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.mp4"
|
|
mp4_size: string The size in bytes of the .MP4 file corresponding to this GIF. |
"25123"
|
|
webp: string The URL for this GIF in .webp format. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy.webp"
|
|
webp_size: cord The size in bytes of the .webp file corresponding to this GIF. |
"12321"
|
|
original_still: object Data on a static preview image of the original GIF. |
url: cord The publicly-attainable straight URL for this GIF. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy_s.gif"
|
width: string The width of this GIF in pixels. |
"320"
|
|
height: string The height of this GIF in pixels. |
"200"
|
|
looping: object Data on the 15 2nd version of the GIF looping. |
mp4: string The URL for this GIF in .MP4 format. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/looping.mp4"
|
preview: object Information on a version of this GIF in .MP4 format limited to 50kb that displays the offset 1-2 seconds of the GIF. |
mp4: string he URL for this GIF in .MP4 format. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy-preview.mp4"
|
mp4_size: string The size of this file in bytes. |
"20241"
|
|
width: string The width of this file in pixels. |
"320"
|
|
summit: string The height of this file in pixels. |
"200"
|
|
preview_gif: object Data on a version of this GIF limited to 50kb that displays the first 1-ii seconds of the GIF. |
url: cord The URL for this preview GIF. |
"https://media1.giphy.com/media/cZ7rmKfFYOvYI/giphy-preview.gif"
|
width: cord The width of this GIF in pixels. |
"320"
|
|
height: string The height of this GIF in pixels. |
"200"
|
The Meta Object
The Meta Object contains basic information regarding the response and its condition. You can learn more about the different types of response codes the API might give you in the Response Codes department.
Belongings | Example |
---|---|
msg: string HTTP Response Message. (required) |
"OK"
|
status: integer (int32) HTTP Response Code. (required) |
200
|
response_id: string A unique ID paired with this response from the API. |
"57eea03c72381f86e05c35d2"
|
The Pagination Object
The Pagination Object contains information relating to the number of total results bachelor also as the number of results fetched and their relative positions.
Property | Example |
---|---|
offset: integer (int32) Position in pagination. |
2591
|
total_count: integer (int32) Total number of items available (not returned on every endpoint). |
250
|
count: integer (int32) Total number of items returned. |
25
|
The User Object
The User Object contains information about the user associated with a GIF and URLs to avails such as that user's avatar prototype, GIPHY contour, and more than.
Property | Example |
---|---|
avatar_url: string The URL for this user'south avatar prototype. |
"https://media1.giphy.com/avatars/election2016/XwYrZi5H87o6.gif"
|
banner_url: string The URL for the imprint image that appears atop this user'southward profile page. |
"https://media4.giphy.com/avatars/cheezburger/XkuejOhoGLE6.jpg"
|
profile_url: string The URL for this user'south GIPHY profile. |
"https://giphy.com/cheezburger/"
|
username: string The username associated with this user. |
"joecool4000"
|
display_name: string The display name associated with this user (contains formatting the base username might not). |
"JoeCool4000"
|
The Random ID Object
The Random ID Object contains a random hash.
Property | Example |
---|---|
random_id: cord Random ID hash. |
"3640f6095c9a1f0f4e544b764d238b25"
|
The Analytics Object
Well-nigh of our endpoints return an Analytics Object. The Analytics Object provides URLs so yous tin register actions, such equally when a user views, clicks, or sends a GIF. For detailed instructions, refer to the Action Register Endpoint.
Property | Example | |
---|---|---|
onload: object |
url: cord The URL to register a 'view' action by a user. |
"URL" |
onclick: object |
url: cord The URL to register a 'click' activeness past a user. |
"URL" |
onsent: object |
url: cord The URL to register a 'ship' activeness by a user. |
"URL" |
The Category Object
The category Object contains category data with links to Subcategory Object and featured Gif Object
Property | Case |
---|---|
name: cord Category name |
"category i"
|
name_encoded: string Encoded category name |
"category1"
|
subcategories: Subcategory Object[] List of subcategories |
|
gif: Gif Object Featured gif for category. |
The Sub category Object
The sub category Object contains category data
Property | Example |
---|---|
name: string Category name |
"sub category 1"
|
name_encoded: cord Encoded category proper noun |
"sub category1"
|
The Term Object
The term Object contains term value
Property | Example |
---|---|
proper name: string Term proper noun |
"lol"
|
The Channel Object
The Channel Object contains channel data with references to the parent and children channels
Holding | Instance |
---|---|
id: number Aqueduct unique ID |
42
|
url: string Channel relative URL |
"/giphystudios"
|
display_name: string The display proper noun of the channel |
"GIPHY Studios"
|
parent: number Parent Channel ID |
20
|
slug: string The unique channel slug. This slug is used in the channel URL |
"giphystudios"
|
type: string |
"community"
|
content_type: string |
"gif"
|
user: User An object containing data about the user associated with this Channel |
|
banner_image: string Channel banner image URL |
"https://media.giphy.com/headers/giphystudios/WWv21rRnktty.jpg"
|
short_display_name: cord The short display name of the aqueduct |
"GIPHY"
|
description: string Channel description |
"GIPHY Studios is making all the GIFs"
|
metadata_description: cord Channel metadata clarification |
"Making all the GIFs"
|
has_children: boolean Indicates that the aqueduct has sub-channels |
imitation
|
is_visible: boolean Indicates that the channel is visible |
true
|
is_private: boolean Indicates that the aqueduct is private |
true
|
is_live: boolean Indicates that the channel is live |
false
|
featured_gif: Gif An object containing data nearly the aqueduct's featured gif |
|
screensaver_gif: string Aqueduct screensaver GIF'south ID |
"4QEPRmyUtrWxKIkMq5"
|
tags: Channel Tag[] List of channel tags |
[]
|
live_since_datetime: string |
"2020-07-20T03:27:19+0000"
|
live_until_datetime: cord |
"2020-07-21T03:27:nineteen+0000"
|
ancestors: Channel[] Listing of parent channels |
[]
|
syncable_tags: Channel Tag[] List of channel syncable tags |
[]
|
analytics_response_payload: cord |
"e=ZXZlbnRfdHlwZT1DSEFOTkVMX1NFQVJDSCZjaWQ9YTMxNzNj..."
|
The Aqueduct Tag Object
Tag associated with the channel
Holding | Example |
---|---|
id: number Tag unique ID |
267
|
channel: number The ID of the aqueduct associated with the tag |
42
|
rank: number The rank of the tag |
i
|
tag: string The tag |
"happy"
|
Synthetic Response
GIPHY API returns a synthetic response when there are problems with GIPHY downstream systems. This API response object has a
meta.condition=200
,
meta.response_id=""
and the rest of the API object is empty. This should be treated as an mistake state and handled accordingly in the awarding.
Response Codes
The API will render a Meta Object in its response containing one of the post-obit codes to describe the upshot of your request.
Code | Type | Description |
---|---|---|
200 | OK | Your request was successful! |
400 | Bad Request | Your request was formatted incorrectly or missing a required parameter(due south). |
401 | Unauthorized | Your asking lacks valid authentication credentials for the target resource, which most likely indicates an effect with your API Cardinal or the API Key is missing. |
403 | Forbidden | Y'all weren't authorized to make your request; most likely this indicates an issue with your API Cardinal. |
404 | Not Found | The particular GIF or Sticker you are requesting was not constitute. This occurs, for case, if yous request a GIF past using an id that does not exist. |
414 | URI Too Long | The length of the search query exceeds 50 characters. |
429 | Too Many Requests | Your API Key is making too many requests. Read about requesting a Production Key to upgrade your API Key charge per unit limits. |
Source: https://developers.giphy.com/docs/api