https://github.com/nazdridoy/unsplash-workers-api

The Unsplash Workers API is a serverless API built with Cloudflare Workers that allows you to efficiently fetch and serve images from Unsplash.
https://github.com/nazdridoy/unsplash-workers-api

Last synced: 3 months ago
JSON representation

The Unsplash Workers API is a serverless API built with Cloudflare Workers that allows you to efficiently fetch and serve images from Unsplash.

• Host: GitHub
• URL: https://github.com/nazdridoy/unsplash-workers-api
• Owner: nazdridoy
• License: mit
• Created: 2025-02-28T13:17:30.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2025-02-28T13:25:43.000Z (3 months ago)
• Last Synced: 2025-02-28T19:40:22.620Z (3 months ago)
• Language: JavaScript
• Size: 4.88 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Unsplash Workers API

## Description

The Unsplash Workers API is a serverless API built with Cloudflare Workers that allows you to efficiently fetch and serve images from Unsplash.

## Features

- Fetch random images from Unsplash

- Search for images based on keywords

- Lightweight and fast response times

- Built with Cloudflare Workers for serverless deployment

## Deploying the Worker

To deploy the Unsplash Workers API, click the button below:

[![Deploy to Cloudflare Workers](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/nazdridoy/unsplash-workers-api)

### API Endpoints

- **GET /random**: Fetch a random image from Unsplash.

  - **Query Parameters:**

    - `collections`: (optional) Comma-separated list of collection IDs to filter the images.

    - `orientation`: (optional) The orientation of the image. Default is `landscape`.

    - `dl`: (optional) Set to `true` to track downloads.

    - `addPhotoOfTheDay`: (optional) Set to `true` to include the photo of the day.

    - `url`: (optional) Specify the image type to return (e.g., `full`, `regular`, `small`, `thumb`, `raw`).

    - `w`: (optional) Width for dynamic resizing.

    - `h`: (optional) Height for dynamic resizing.

    - `crop`: (optional) Crop parameter for the image.

    - `fm`: (optional) Format of the image.

    - `q`: (optional) Quality of the image.

    - `fit`: (optional) Fit parameter for the image.

    - `dpr`: (optional) Device pixel ratio.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Acknowledgments

- [Unsplash](https://unsplash.com) for providing beautiful images.

- [Cloudflare Workers](https://workers.cloudflare.com) for enabling serverless functions.