API reference
1 endpoint, served at https://orbitwrite.com/api/v1. Each one lists the credentials it accepts, its parameters and every response it can give.
Searches GIPHY and returns a normalised result shape ready to attach to a post. With no q, returns what's trending. Results are rated pg-13. Anywhere these render must show a 'Powered by GIPHY' attribution.
An API key or OAuth access token as a bearer token, or a signed-in session.
qstringSearch terms. Omit or leave empty for trending GIFs.
At most 200 characters.
limitintegerBetween 1 and 50. Defaults to 24.
offsetinteger | nullPagination cursor — pass the next from a prior page.
Between 0 and 4999. Defaults to 0.
200GifSearchResultsMatching GIFs
resultsGif[]RequiredidstringRequireddescriptionstringRequiredpreviewUrlstringRequiredSmall, fast variant for grid rendering.
previewWidthintegerRequiredpreviewHeightintegerRequiredgifUrlstringRequiredStandard-resolution GIF to attach to a post. Attach this URL directly — Orbitwrite does not re-host it, which keeps sourceUrl intact for adapters that embed rather than upload.
gifWidthintegerRequiredgifHeightintegerRequiredgifBytesintegermp4UrlstringMP4 alternative where GIPHY provides one. Platforms that publish GIFs as video (X, LinkedIn, Threads) need this to animate.
nextstringOffset to pass as offset for the next page. Absent when there are no more results.
curl -X GET "https://orbitwrite.com/api/v1/gifs/search" \
-H "Authorization: Bearer $ORBITWRITE_API_KEY"{
"results": [
{
"id": "string",
"description": "string",
"previewUrl": "string",
"previewWidth": 0,
"previewHeight": 0,
"gifUrl": "string",
"gifWidth": 0,
"gifHeight": 0,
"gifBytes": 0,
"mp4Url": "string"
}
],
"next": "string"
}