{"files":{"SKILL.md":"---\nname: giphy-api\ndescription: \"Giphy API skill. Use when working with Giphy for gifs, stickers. Covers 10 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Giphy API\nAPI version: 1.0\n\n## Auth\nApiKey api_key in query\n\n## Base URL\nhttps://api.giphy.com/v1\n\n## Setup\n1. Set your API key in the appropriate header\n2. GET /gifs/search -- search gifs\n3. Explore available endpoints below\n\n## Endpoints\n10 endpoints across 2 groups. See references/api-spec.lap for full details.\n\n### Gifs\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /gifs/search | Search GIFs |\n| GET | /gifs/trending | Trending GIFs |\n| GET | /gifs/translate | Translate phrase to GIF |\n| GET | /gifs/random | Random GIF |\n| GET | /gifs/{gifId} | Get GIF by Id |\n| GET | /gifs | Get GIFs by ID |\n\n### Stickers\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /stickers/search | Search Stickers |\n| GET | /stickers/trending | Trending Stickers |\n| GET | /stickers/translate | Translate phrase to Sticker |\n| GET | /stickers/random | Random Sticker |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Search search?\" -> GET /gifs/search\n- \"List all trending?\" -> GET /gifs/trending\n- \"List all translate?\" -> GET /gifs/translate\n- \"List all random?\" -> GET /gifs/random\n- \"Get gif details?\" -> GET /gifs/{gifId}\n- \"List all gifs?\" -> GET /gifs\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Paginated endpoints accept limit/offset or cursor parameters\n- Error responses include status codes and descriptions in the spec\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Giphy API\n@base https://api.giphy.com/v1\n@version 1.0\n@auth ApiKey api_key in query\n@endpoints 10\n@toc gifs(6), stickers(4)\n\n@group gifs\n@endpoint GET /gifs/search\n@desc Search GIFs\n@required {q: any # Search query term or prhase.}\n@optional {limit: any # The maximum number of records to return., offset: any # An optional results offset., rating: any # Filters results by specified rating., lang: any # Specify default language for regional content; use a 2-letter ISO 639-1 language code.}\n@returns(200) Search results\n@errors {400: Your request was formatted incorrectly or missing required parameters., 403: You weren't authorized to make your request; most likely this indicates an issue with your API Key., 404: The particular GIF you are requesting was not found. This occurs, for example, if you request a GIF by an id that does not exist., 429: Your API Key is making too many requests. Read about [requesting a Production Key](https://developers.giphy.com/docs/#access) to upgrade your API Key rate limits.}\n\n@endpoint GET /gifs/trending\n@desc Trending GIFs\n@optional {limit: any # The maximum number of records to return., offset: any # An optional results offset., rating: any # Filters results by specified rating.}\n@returns(200)\n@errors {400: Your request was formatted incorrectly or missing required parameters., 403: You weren't authorized to make your request; most likely this indicates an issue with your API Key., 404: The particular GIF you are requesting was not found. This occurs, for example, if you request a GIF by an id that does not exist., 429: Your API Key is making too many requests. Read about [requesting a Production Key](https://developers.giphy.com/docs/#access) to upgrade your API Key rate limits.}\n\n@endpoint GET /gifs/translate\n@desc Translate phrase to GIF\n@required {s: any # Search term.}\n@returns(200)\n@errors {400: Your request was formatted incorrectly or missing required parameters., 403: You weren't authorized to make your request; most likely this indicates an issue with your API Key., 404: The particular GIF you are requesting was not found. This occurs, for example, if you request a GIF by an id that does not exist., 429: Your API Key is making too many requests. Read about [requesting a Production Key](https://developers.giphy.com/docs/#access) to upgrade your API Key rate limits.}\n\n@endpoint GET /gifs/random\n@desc Random GIF\n@optional {tag: any # Filters results by specified tag., rating: any # Filters results by specified rating.}\n@returns(200)\n@errors {400: Your request was formatted incorrectly or missing required parameters., 403: You weren't authorized to make your request; most likely this indicates an issue with your API Key., 404: The particular GIF you are requesting was not found. This occurs, for example, if you request a GIF by an id that does not exist., 429: Your API Key is making too many requests. Read about [requesting a Production Key](https://developers.giphy.com/docs/#access) to upgrade your API Key rate limits.}\n\n@endpoint GET /gifs/{gifId}\n@desc Get GIF by Id\n@required {gifId: any # Filters results by specified GIF ID.}\n@returns(200)\n@errors {400: Your request was formatted incorrectly or missing required parameters., 403: You weren't authorized to make your request; most likely this indicates an issue with your API Key., 404: The particular GIF you are requesting was not found. This occurs, for example, if you request a GIF by an id that does not exist., 429: Your API Key is making too many requests. Read about [requesting a Production Key](https://developers.giphy.com/docs/#access) to upgrade your API Key rate limits.}\n\n@endpoint GET /gifs\n@desc Get GIFs by ID\n@optional {ids: any # Filters results by specified GIF IDs, separated by commas.}\n@returns(200)\n@errors {400: Your request was formatted incorrectly or missing required parameters., 403: You weren't authorized to make your request; most likely this indicates an issue with your API Key., 404: The particular GIF you are requesting was not found. This occurs, for example, if you request a GIF by an id that does not exist., 429: Your API Key is making too many requests. Read about [requesting a Production Key](https://developers.giphy.com/docs/#access) to upgrade your API Key rate limits.}\n\n@endgroup\n\n@group stickers\n@endpoint GET /stickers/search\n@desc Search Stickers\n@required {q: any # Search query term or prhase.}\n@optional {limit: any # The maximum number of records to return., offset: any # An optional results offset., rating: any # Filters results by specified rating., lang: any # Specify default language for regional content; use a 2-letter ISO 639-1 language code.}\n@returns(200) Search results\n@errors {400: Your request was formatted incorrectly or missing required parameters., 403: You weren't authorized to make your request; most likely this indicates an issue with your API Key., 404: The particular GIF you are requesting was not found. This occurs, for example, if you request a GIF by an id that does not exist., 429: Your API Key is making too many requests. Read about [requesting a Production Key](https://developers.giphy.com/docs/#access) to upgrade your API Key rate limits.}\n\n@endpoint GET /stickers/trending\n@desc Trending Stickers\n@optional {limit: any # The maximum number of records to return., offset: any # An optional results offset., rating: any # Filters results by specified rating.}\n@returns(200)\n@errors {400: Your request was formatted incorrectly or missing required parameters., 403: You weren't authorized to make your request; most likely this indicates an issue with your API Key., 404: The particular GIF you are requesting was not found. This occurs, for example, if you request a GIF by an id that does not exist., 429: Your API Key is making too many requests. Read about [requesting a Production Key](https://developers.giphy.com/docs/#access) to upgrade your API Key rate limits.}\n\n@endpoint GET /stickers/translate\n@desc Translate phrase to Sticker\n@required {s: any # Search term.}\n@returns(200)\n@errors {400: Your request was formatted incorrectly or missing required parameters., 403: You weren't authorized to make your request; most likely this indicates an issue with your API Key., 404: The particular GIF you are requesting was not found. This occurs, for example, if you request a GIF by an id that does not exist., 429: Your API Key is making too many requests. Read about [requesting a Production Key](https://developers.giphy.com/docs/#access) to upgrade your API Key rate limits.}\n\n@endpoint GET /stickers/random\n@desc Random Sticker\n@optional {tag: any # Filters results by specified tag., rating: any # Filters results by specified rating.}\n@returns(200)\n@errors {400: Your request was formatted incorrectly or missing required parameters., 403: You weren't authorized to make your request; most likely this indicates an issue with your API Key., 404: The particular GIF you are requesting was not found. This occurs, for example, if you request a GIF by an id that does not exist., 429: Your API Key is making too many requests. Read about [requesting a Production Key](https://developers.giphy.com/docs/#access) to upgrade your API Key rate limits.}\n\n@endgroup\n\n@end\n"}}