@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Giphy API
@base https://api.giphy.com/v1
@version 1.0
@auth ApiKey api_key in query
@endpoints 10
@toc gifs(6), stickers(4)

@group gifs
@endpoint GET /gifs/search
@required {q: any}
@optional {limit: any, offset: any, rating: any, lang: any}
@returns(200)
@errors {400, 403, 404, 429}

@endpoint GET /gifs/trending
@optional {limit: any, offset: any, rating: any}
@returns(200)
@errors {400, 403, 404, 429}

@endpoint GET /gifs/translate
@required {s: any}
@returns(200)
@errors {400, 403, 404, 429}

@endpoint GET /gifs/random
@optional {tag: any, rating: any}
@returns(200)
@errors {400, 403, 404, 429}

@endpoint GET /gifs/{gifId}
@required {gifId: any}
@returns(200)
@errors {400, 403, 404, 429}

@endpoint GET /gifs
@optional {ids: any}
@returns(200)
@errors {400, 403, 404, 429}

@endgroup

@group stickers
@endpoint GET /stickers/search
@required {q: any}
@optional {limit: any, offset: any, rating: any, lang: any}
@returns(200)
@errors {400, 403, 404, 429}

@endpoint GET /stickers/trending
@optional {limit: any, offset: any, rating: any}
@returns(200)
@errors {400, 403, 404, 429}

@endpoint GET /stickers/translate
@required {s: any}
@returns(200)
@errors {400, 403, 404, 429}

@endpoint GET /stickers/random
@optional {tag: any, rating: any}
@returns(200)
@errors {400, 403, 404, 429}

@endgroup

@end