subimpact WhatsApp us

Giphy Scraper (Keyless)

Giphy Scraper reads Giphy's public API without an API key and returns one JSON record per GIF, sticker, clip or emoji: giphyId, gifTitle, url, embedUrl, rating, tags, creator details, variantUrls for preview, downsized, original and mp4, plus a kvsUrl when you download the media. It costs $0.001 per result ($1.00 per 1,000) and $0.002 per downloaded file, run from the Apify Console, API or MCP.

from $0.001 per result, $1.00 per 1,000 · Updated Nov 2026, version 0.1.24

Key facts

Price
from $0.001 per result, $1.00 per 1,000
Pricing model
Pay per event
Output
JSON, CSV, Excel, XML, RSS via Apify datasets
Access
Apify Console, REST API, Python and JS clients
Version
Updated Nov 2026, version 0.1.24
Usage
37 users · 100.0% successful runs (30 days)
Actor
subimpact/giphy-scraper

Who it is for

  • Chat and bot builders who need a searchable GIF library in their own store
  • Social and meme teams archiving trending reactions by term
  • App developers building sticker and emoji pickers
  • Analysts tracking which GIFs trend and who made them

Use cases

Build a searchable GIF index

Set mode to search and pass a list of searchTerms, for example ["funny cat", "celebrate"]. Each term is one API call, and every row carries giphyId, gifTitle, tags, rating and variantUrls, so you can index the media by keyword in your own database instead of calling Giphy at request time. Add maxItems to cap the spend of a large term list.

Snapshot the trending feed

Run with mode set to trending and leave the term fields empty. You get the current trending GIFs and stickers with createDatetime, trendingDatetime, username and userVerified, which is enough to build a daily leaderboard of creators and formats. Schedule the run and diff giphyId lists between days to see what entered and left the feed.

Download files for offline use

Turn on downloadMedia and pick a downloadFormat of preview, downsized or original. Each file lands in the run's key-value store and the record gains a kvsUrl plus a localFilePath field. maxDownloadSizeMb skips files above your limit by checking images[].size first, which keeps a bulk download inside the storage budget you planned.

Refresh a known GIF library

When you already store Giphy IDs, use mode byIds with the gifIds array. The run re-fetches current titles, ratings and variant URLs for exactly those items, so a moderation pass or a dead-link check works on a fixed list rather than a fresh search. Rows that Giphy no longer returns come back as a status row with an error message.

Fuel a sticker or emoji picker

Mode categories returns category records with their child gifs, and mode emoji returns Giphy's emoji set. Combined with the rating filter (g, pg, pg-13, r), that gives an app a pre-filtered set of safe assets with embedUrl and bitlyUrl ready to use, and the lang input localises titles and tags for non-English interfaces.

Output fields

FieldTypeDescription
giphyId any
gifType any
gifTitle any
username any
userVerified any
rating any
url any
embedUrl any
searchTerm any
createDatetime any
localFilePath any
kvsUrl any

Sample output

From one of our own test runs on 20 Nov 2026, trimmed. Personal data is redacted.

2 rows, first 3 shown

[
  {
    "giphyId": "WykUqckDqi95YIqtFZ",
    "gifType": "gif",
    "url": "https://giphy.com/gifs/cat-salam-salamualaikum-alaikum-WykUqckDqi95YIqtFZ",
    "gifTitle": "Funny Cat GIF",
    "altText": "",
    "username": "Hakimkurdi",
    "userDisplayName": "Hakim",
    "userVerified": false,
    "userAvatarUrl": "https://media4.giphy.com/avatars/Hakimkurdi/J2vSgtLdvXSY.gif",
    "rating": "g",
    "source": "",
    "tags": [
      "cat",
      "funny cat",
      "cat meme",
      "..."
    ],
    "createDatetime": "2026-09-28 16:35:32",
    "trendingDatetime": "0000-00-00 00:00:00",
    "embedUrl": "https://giphy.com/embed/WykUqckDqi95YIqtFZ",
    "bitlyUrl": "https://gph.is/g/EGPWWPn",
    "variantUrls": {
      "preview": {
        "url": "https://media4.giphy.com/media/v1.Y2lkPWVjZjA1ZTQ3cWFxZG1uYW9wejR1OTg5c3BibHZhdmpjYXc3aW9lbHVoN2I1aDN4NyZlcD12MV9naWZzX3NlYXJjaCZjdD1n/WykUqckDqi95YIqtFZ/giphy-preview.gif",
        "size": "17748",
        "width": "76",
        "height": "76"
      },
      "downsized": {
        "url": "https://media4.giphy.com/media/v1.Y2lkPWVjZjA1ZTQ3cWFxZG1uYW9wejR1OTg5c3BibHZhdmpjYXc3aW9lbHVoN2I1aDN4NyZlcD12MV9naWZzX3NlYXJjaCZjdD1n/WykUqckDqi95YIqtFZ/giphy-downsized.gif",
        "size": "651134",
        "width": "198",
        "height": "198"
      },
      "original": {
        "url": "https://media4.giphy.com/media/v1.Y2lkPWVjZjA1ZTQ3cWFxZG1uYW9wejR1OTg5c3BibHZhdmpjYXc3aW9lbHVoN2I1aDN4NyZlcD12MV9naWZzX3NlYXJjaCZjdD1n/WykUqckDqi95YIqtFZ/giphy.gif",
        "size": "4519070",
        "width": "480",
        "height": "480"
      },
      "mp4": null
    },
    "searchTerm": "funny cat"
  },
  {
    "giphyId": "GB0XWhoCDNNAW8M9vv",
    "gifType": "gif",
    "url": "https://giphy.com/gifs/cat-ice-cream-GB0XWhoCDNNAW8M9vv",
    "gifTitle": "Ice Cream Cats GIF",
    "altText": "",
    "username": "muntasermari",
    "userDisplayName": "mkl.6.3",
    "userVerified": false,
    "userAvatarUrl": "https://media4.giphy.com/avatars/muntasermari/ryJmJErtVlho.gif",
    "rating": "g",
    "source": "",
    "tags": [
      "cats",
      "ice cream",
      "pets",
      "..."
    ],
    "createDatetime": "2026-07-26 17:03:22",
    "trendingDatetime": "0000-00-00 00:00:00",
    "embedUrl": "https://giphy.com/embed/GB0XWhoCDNNAW8M9vv",
    "bitlyUrl": "https://gph.is/g/4on28JL",
    "variantUrls": {
      "preview": {
        "url": "https://media0.giphy.com/media/v1.Y2lkPWVjZjA1ZTQ3cWFxZG1uYW9wejR1OTg5c3BibHZhdmpjYXc3aW9lbHVoN2I1aDN4NyZlcD12MV9naWZzX3NlYXJjaCZjdD1n/GB0XWhoCDNNAW8M9vv/giphy-preview.gif",
        "size": "16026",
        "width": "42",
        "height": "76"
      },
      "downsized": {
        "url": "https://media0.giphy.com/media/v1.Y2lkPWVjZjA1ZTQ3cWFxZG1uYW9wejR1OTg5c3BibHZhdmpjYXc3aW9lbHVoN2I1aDN4NyZlcD12MV9naWZzX3NlYXJjaCZjdD1n/GB0XWhoCDNNAW8M9vv/giphy-downsized.gif",
        "size": "1878344",
        "width": "270",
        "height": "480"
      },
      "original": {
        "url": "https://media0.giphy.com/media/v1.Y2lkPWVjZjA1ZTQ3cWFxZG1uYW9wejR1OTg5c3BibHZhdmpjYXc3aW9lbHVoN2I1aDN4NyZlcD12MV9naWZzX3NlYXJjaCZjdD1n/GB0XWhoCDNNAW8M9vv/giphy.gif",
        "size": "3251704",
        "width": "270",
        "height": "480"
      },
      "mp4": null
    },
    "searchTerm": "funny cat"
  }
]

Input

FieldTypeRequiredDescriptionDefault
mode string No Which Giphy endpoint to hit search
searchTerms array No Terms to search (search mode). Each term = one API call. ["funny cat"]
gifIds array No Explicit Giphy IDs for byIds mode -
randomTags array No Tags for random mode ["cat"]
translateText string No Text for translate mode -
limit integer No Items to fetch PER CONTENT TYPE per term/per call (hard cap 150 per API). With includeStickers on (the default), limit=5 delivers up to 5 GIFs plus 5 stickers - i.e. up to 2x this many rows, each charged as a delivered result-item. 50
offset integer No Pagination offset 0
maxItems integer No Optional global safety cap on delivered (and charged) rows across all terms, types and modes. Leave empty or 0 for unlimited. -
deepPagination boolean No Keep paging (offset += limit) until an empty page or offset >= 250, because Giphy deep pagination stops advancing around 250 false
includeStickers boolean No Also fetch stickers for each search term (ON by default). Sticker rows are delivered and charged as result-items IN ADDITION to the GIF rows, at the per-content-type limit above. true
includeClips boolean No Also hit /v1/clips/search for each term (clips have mp4_720 variants) false
rating string No Content rating filter. g
lang string No Language (ISO 639-1, e.g. en, es). en
downloadMedia boolean No Download each GIF/WebP/MP4 file into the run (stored in the run's default key-value store, dataset record gets a localFilePath + kvsUrl field). false
downloadFormat string No Which image variant to download (preview=preview_gif/url small, downsized=downsized media, original=original) preview
maxDownloadSizeMb integer No Skip files larger than this (check images[].size before downloading) 10
apiKey string No Optional user's own Giphy API key. Defaults to the embedded public web-client key (no key needed). -

Example input

{
  "mode": "search",
  "searchTerms": [
    "funny cat"
  ],
  "limit": 10
}

Pricing

EventWhat it meansPriceLowest tier
result-item Single GIF/sticker/clip/emoji/category record in the output dataset. $0.001 $0.001
media-download One GIF/WebP/MP4 file downloaded into the run key-value store. $0.002 $0.002

$1.00 for 1,000 results at the listed price.

Prices from the Apify Store on 20 November 2026. Apify shows the final price before each run.

How it compares with other Apify actors

Price per 1,000 results at Apify Store list prices. Every row is a live listing on the Store, read on 20 Nov 2026, so a buyer can check each number at the source.

Actor Price per 1,000 results (Free plan) Higher plans (Gold) Start fee per run Platform usage Users Rating Last build
Giphy Scraper (keyless) This API Pay per event $1.00 $1.00 None Included 37 No reviews yet 18 Nov 2026
GIPHY Scraper Partial match, pay per event $0.14 $0.13 $0.02 Included 9 No reviews yet 8 Oct 2026
Giphy Api Partial match, pay per event Charges per API call to each endpoint, plus a start fee and a small charge per row stored. $0.1 Included 25 No reviews yet 2 Nov 2026
Where GIPHY Scraper is stronger

Where GIPHY Scraper is stronger

  • Single job and almost nothing to configure: trending GIFs from the Giphy homepage
  • Returns author, aspect ratio, background colour and sticker flag per item

Where this API is stronger

  • Search, trending, translate, random, by id, categories and emoji modes in one actor
  • Stickers and clips can be included in the same run
  • Optional media downloads straight into the key-value store
Where Giphy Api is stronger

Where Giphy Api is stronger

  • Covers the official Giphy API endpoints including random, by id and emoji
  • Reports total count and offset alongside each payload

Where this API is stronger

  • Charges per result item stored rather than per API call, so wide pages cost in line with what you keep
  • Works without an API key, and accepts your own key when you have one
  • Deep pagination and media downloads handled in the same run

All three actors read Giphy's own API, so the data is the same family. The two other listings are simpler or cheaper to start with, while one of them is aimed at trending GIFs only and the other prices per API call. Ours is the widest single actor: many modes, stickers and clips, plus optional media downloads, with no API key required.

Prices are Apify Store list prices, checked 20 Nov 2026. Platform usage 'Paid separately' means Apify bills compute on top of the event price. Check each listing before you buy.

How to run it

  1. Set mode to search, the default, and put your terms in searchTerms, for example ["funny cat"].
  2. Set limit per content type, up to 150 per API call, and decide whether includeStickers stays on, since stickers are fetched and charged by default.
  3. Optional: set rating to pg or g and lang to your interface language to filter and localise results.
  4. Turn on downloadMedia if you want the files, choosing preview, downsized or original as downloadFormat.
  5. Start the run in the Apify Console; rows stream into the dataset in batches of up to 10 as pages arrive.
  6. Export the dataset as JSON, CSV or Excel, and collect downloaded files from the run key-value store through kvsUrl.

cURL

curl -X POST "https://api.apify.com/v2/acts/subimpact~giphy-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"search","searchTerms":["funny cat"],"limit":10}'

Python

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("subimpact/giphy-scraper").call(run_input={"mode":"search","searchTerms":["funny cat"],"limit":10})

for item in client.dataset(run["default_dataset_id"]).iterate_items():
    print(item)

JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('subimpact/giphy-scraper').call({"mode":"search","searchTerms":["funny cat"],"limit":10});
const { items } = await client.dataset(run.defaultDatasetId).listItems();

console.log(items);

n8n

Use the Apify node (Run an Actor).
Actor ID: subimpact/giphy-scraper
Input JSON: paste the example input above.

Limits

  • Giphy deep pagination stops advancing around offset 250, which caps how far back a single term can reach.
  • limit is hard-capped at 150 per content type per API call.
  • Stickers are fetched and charged by default, so a run can deliver twice the rows you expected.
  • localFilePath only resolves inside a local run; after a cloud run the file must be read through kvsUrl.

Questions people ask

Do I need a Giphy API key?

No. The Actor uses the public web-client key that Giphy's own site embeds, so plain HTTP calls work without a key. If you hold your own key, pass it in the apiKey input or the GIPHY_API_KEY environment variable and it is used instead. The facts also note there is no browser and no proxy involved.

What do a run and a media download cost?

$0.001 per delivered result item, which is $1.00 per 1,000 rows, plus $0.002 per media file when downloadMedia is on. Only delivered rows are charged, and they are charged in batches as they are streamed, so a timeout keeps and bills only what it collected.

How many results can one term return?

limit applies per content type and per call, and Giphy hard-caps it at 150; asking for more returns an empty page. deepPagination keeps advancing the offset until an empty page or offset 250, because Giphy's pagination stops advancing around that point.

Why do I get more rows than my limit?

includeStickers is on by default, and limit applies separately per content type. With limit 5 you can receive up to 5 GIFs plus 5 stickers, and every one of those rows is charged as a result item. Turn includeStickers off, or set maxItems as a global cap, if you want a fixed row count.

Where do downloaded files go?

Into the run's default key-value store, with the record gaining a kvsUrl that points at the downloadable file. The localFilePath field is kept for local runs only, because container storage is not readable after a cloud run finishes. Use kvsUrl as the durable link.

Which modes are available?

search, trending, byIds, random, translate, categories and emoji. Search also hits sticker search by default and clips search when includeClips is on; clips carry mp4_720 variants. Random takes randomTags, translate takes translateText, and byIds takes an explicit gifIds array.

What happens if Giphy returns a malformed record?

The Actor drops it and writes an uncharged status row with an error message, so the dataset shows what was skipped rather than failing the whole run. Requests time out after 20 seconds and retry up to three times with backoff on server errors, rate limits and network failures.

Need a data source that is not here?

We build and run scrapers for sites that have no public API. Tell us the site, the fields and how often you need them.