# 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.

## 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, build 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.

## Price events

- result (`result-item`): $0.001, lowest tier $0.001. Single GIF/sticker/clip/emoji/category record in the output dataset.
- media file download (`media-download`): $0.002, lowest tier $0.002. One GIF/WebP/MP4 file downloaded into the run key-value store.

Prices from the Apify Store. 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, checked 20 Nov 2026.

| 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) | $1.00 | $1.00 | None | Included | 37 | No reviews yet | 18 Nov 2026 |
| [GIPHY Scraper](https://apify.com/parseforge/giphy-scraper) | $0.14 | $0.13 | $0.02 | Included | 9 | No reviews yet | 8 Oct 2026 |
| [Giphy Api](https://apify.com/alizarin_refrigerator-owner/giphy-api) | Charges per API call to each endpoint, plus a start fee and a small charge per row stored. | Same unit, see the first price column | $0.1 | Included | 25 | No reviews yet | 2 Nov 2026 |

### 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

- 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.

## Input

- `mode` (string, optional): Which Giphy endpoint to hit
- `searchTerms` (array, optional): Terms to search (search mode). Each term = one API call.
- `gifIds` (array, optional): Explicit Giphy IDs for byIds mode
- `randomTags` (array, optional): Tags for random mode
- `translateText` (string, optional): Text for translate mode
- `limit` (integer, optional): 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.
- `offset` (integer, optional): Pagination offset
- `maxItems` (integer, optional): Optional global safety cap on delivered (and charged) rows across all terms, types and modes. Leave empty or 0 for unlimited.
- `deepPagination` (boolean, optional): Keep paging (offset += limit) until an empty page or offset >= 250, because Giphy deep pagination stops advancing around 250
- `includeStickers` (boolean, optional): 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.
- `includeClips` (boolean, optional): Also hit /v1/clips/search for each term (clips have mp4_720 variants)
- `rating` (string, optional): Content rating filter.
- `lang` (string, optional): Language (ISO 639-1, e.g. en, es).
- `downloadMedia` (boolean, optional): 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).
- `downloadFormat` (string, optional): Which image variant to download (preview=preview_gif/url small, downsized=downsized media, original=original)
- `maxDownloadSizeMb` (integer, optional): Skip files larger than this (check images[].size before downloading)
- `apiKey` (string, optional): Optional user's own Giphy API key. Defaults to the embedded public web-client key (no key needed).

### Example input

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

## Output fields

- `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

Trimmed from one of our own test runs. Personal data is redacted.

```json
[
  {
    "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"
  }
]
```

## 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

```bash
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

```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

```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 below.

## 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.

## FAQ

### 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.

## Links

- Page: https://subimpact.net/apis/giphy-scraper/
- Category: https://subimpact.net/apis/category/social-media/
- Run on Apify: https://apify.com/subimpact/giphy-scraper
- All data APIs: https://subimpact.net/apis/
- Catalogue JSON: https://subimpact.net/apis/catalogue.json
