GIFs
Search GIFs
Searches GIFs by keyword via the OnlyFans Giphy proxy. Requires permission api_gifs_search.
https://public-api.fansmetric.comAuthorization
defaultAuthorizationBearer <token>Send your FansMetric API key as a Bearer token in the Authorization header.
In: header
Query Parameters
q*stringSearch query, e.g.
"hello".limitintegerDefault 20. Min 1, max 50.
offsetintegerPagination offset.
Response Fields
data.data[].idstringGiphy GIF ID — pass as
giphyIdwhen sending a message.data.data[].titlestringHuman-readable GIF title from Giphy.
data.data[].alt_textstringAccessibility alt text. May be empty.
data.data[].ratingstringGiphy content rating (e.g.
g,pg,pg-13,r).data.data[].is_stickerinteger1if the asset is a sticker, otherwise0.data.data[].typestringAsset type — typically
gif.data.data[].urlstringCanonical Giphy page URL.
data.data[].embed_urlstringGiphy embed URL.
data.data[].imagesobjectSlim image rendition map:
fixed_height,fixed_width,original,original_mp4,preview_gif. Per-rendition fields:url,width,height, andmp4(only when present).data.paginationobjectGiphy pagination block:
total_count,count,offset.dataobject | arrayEndpoint-specific payload. See the fields below for this route.
_meta._credits.usedintegerCredits consumed by this request (currently always
1)._meta._rate_limits.limit_minuteintegerMaximum requests per minute for the organization.
_meta._rate_limits.remaining_minuteintegerRemaining requests in the current minute window.
_meta._rate_limits.limit_dayintegerMaximum requests per day for the organization.
_meta._rate_limits.remaining_dayintegerRemaining requests in the current day window.
| Field | Type | Description |
|---|---|---|
| data.data[].id | string | Giphy GIF ID — pass as giphyId when sending a message. |
| data.data[].title | string | Human-readable GIF title from Giphy. |
| data.data[].alt_text | string | Accessibility alt text. May be empty. |
| data.data[].rating | string | Giphy content rating (e.g. g, pg, pg-13, r). |
| data.data[].is_sticker | integer | 1 if the asset is a sticker, otherwise 0. |
| data.data[].type | string | Asset type — typically gif. |
| data.data[].url | string | Canonical Giphy page URL. |
| data.data[].embed_url | string | Giphy embed URL. |
| data.data[].images | object | Slim image rendition map: fixed_height, fixed_width, original, original_mp4, preview_gif. Per-rendition fields: url, width, height, and mp4 (only when present). |
| data.pagination | object | Giphy pagination block: total_count, count, offset. |
| data | object | array | Endpoint-specific payload. See the fields below for this route. |
| _meta._credits.used | integer | Credits consumed by this request (currently always 1). |
| _meta._rate_limits.limit_minute | integer | Maximum requests per minute for the organization. |
| _meta._rate_limits.remaining_minute | integer | Remaining requests in the current minute window. |
| _meta._rate_limits.limit_day | integer | Maximum requests per day for the organization. |
| _meta._rate_limits.remaining_day | integer | Remaining requests in the current day window. |
curl --request GET "https://public-api.fansmetric.com/v1/gifs/search?q=sample_q&limit=20&offset=0" \
--header "Authorization: Bearer YOUR_API_KEY"Response
200