usage guide



to request an image, use the url api.yiff.download followed by query parameters. the first parameter should be the category (for example, femboy). by default, images are sfw. to request nsfw images, add sfw=no.



to request a gif, include the gif parameter. for example:

 api.yiff.download/?femboy&sfw=no&gif



to convert an image to a different format, add format and quality parameters. supported formats are jpeg (or jpg), png, webp, and gif (gif isn't available for normal images). for example:

 api.yiff.download/?femboy&sfw=no&format=jpeg&quality=20



to randomly select an image across all categories matching your criteria, use the everything option (sfw only). for example:

 api.yiff.download/?everything
back