FAQ

The Image API is a service that provides programmatic access to thousands of high-quality images. You can use it to fetch random images, browse different collections, and integrate images into your applications or projects.

To get an API key, you need to create an account and log in to the dashboard. From there, you can generate a new API key and start making requests to our image endpoints.

Our main API endpoint is:

• /api/{collection}/random - Get a random image from a specific collection
• /api/{collection}/images/{filename} - Direct access to specific images

The API key is required for the random endpoint, while direct image URLs are publicly accessible.

You can authenticate with your API key in two ways:

Yes, we have rate limits to ensure fair usage:

• Daily API Quota: Default 1000 requests per day (resets at 00:00 UTC)
• Upload Rate Limiting: Separate limits for image uploads

If you exceed limits, you'll receive a temporary cooldown period before you can make more requests.

Our API serves images in various formats including:

• PNG
• JPEG/JPG
• WebP

The format depends on the original image in our collection. SVG files are not supported.

Our API returns the image URL when you call the random endpoint. We don't provide additional metadata like dimensions, file size, or image tags - you'll need to load the image to get that information from the file itself.

Currently available collections:

• cats - Various cat images
• dogs - Various dog images

New collections are added regularly through community uploads. You can view all available collections on the main page, and the API automatically updates to include new images as they're accepted by moderators.

Direct image URLs follow the pattern: /api/{collection}/images/{filename}

New images are added regularly based on community uploads and content curation. We review all uploaded images for quality and appropriateness before adding them to our collections.

Yes! Registered users can upload images through the dashboard. All uploads go through a moderation process to ensure they meet our quality standards and guidelines. Check the upload rules before contributing.

This usually means there's an issue with your API key:

• Make sure you're including the API key in the correct header format
• Verify your API key is active and valid
• Check that you're not accidentally sharing your API key publicly
• Try generating a new API key if the problem persists

This means you've hit the rate limit for your account:

• Wait for reset: Daily quota resets at 00:00 UTC each day
• Implement backoff: Add delays between requests in your code
• Cache responses: Store API responses to reduce request frequency
• Request increase: Contact us for higher daily quotas if needed

If some images aren't loading, try:

• Checking for browser/ad blocker blocking our image domain
• Verifying your internet connection
• Using HTTPS for requests
• Contacting support if the issue persists

Our API returns random images, so you can't search for specific images. This is by design to keep the service simple and fast. If you need specific images, consider using our collection endpoints to browse relevant categories.

To request a daily quota increase, contact us at [email protected] with:

• Your Discord username
• Discord user ID
• Reason for needing higher quota (explain your use case)

Note: We have additional rate limiting to prevent abuse - only daily quotas can be adjusted.

Yes, you can delete your account from the user menu in the top navigation. This will permanently remove:

• Your profile and account data
• All uploaded images
• API keys and usage history
• All leaderboard rankings

Warning: This action cannot be undone!

When you delete your account, all images you've uploaded will be permanently removed from our collections. However, images that have been downloaded/cached by other users may still be accessible through their local copies.

For support, you can:

• Check our documentation for technical details
• Look through this FAQ for common solutions
• Contact us directly via Discord
• Email us at [email protected]

we love feedback! You can:

• Email detailed reports to [email protected]

Please include as much detail as possible when reporting issues.