Skip to content

Latest commit

 

History

History
96 lines (74 loc) · 2.46 KB

README.md

File metadata and controls

96 lines (74 loc) · 2.46 KB

unsplash-images-json

Fetch images from Unsplash and write the fetched images data to a JSON file.

Unsplash images to JSON demo

Motivation

I wanted to use a random list of specified images on a project. There are various approaches to achieve this result:

  • Manually download the images and save them to disk
  • Create a JSON file with the properties of the images

I decided to implement a simple logic where I fetch images from Unsplash and then write the image data to a JSON file. From the JSON file, I could easily consume the data. Using this process, I saved storage space since I wouldn't have to download the images.

Getting started

  1. Register as a developer on Unsplash from this link: https://unsplash.com/developers.

  2. Clone this repository:

git clone https://github.com/khwilo/unsplash-images-json.git
  1. Create a .env file and add your API access key. View the format in the .env-sample that is provided in the project root directory.

  2. Run yarn or npm install to install the project dependencies.

  3. Run yarn start or npm start to run the application.

How to use

This project has a function called fetchListOfVariousPhotos that takes two arguments: queries and transform. queries is a list of search terms. transform is a boolean value. Specifying the transform property to the equal the value true; transforms the format of the written JSON file to the following:

Property Type
id string
description string
alt_description string
imgThumb string
img string
link string
userId string
userName string
userLink string
tags [ ] string

The saved JSON file can be found in the project data directory.

TODO

  • Make this project to be a CLI app

Credits

Author: Khwilo Kabaka