New York Times Article Searcher
The New York Times News Explorer is a web application that allows users to retrieve news articles from The New York Times using their API. Users can search for articles based on topics, choose the number of associated articles to display (1, 5, or 10), and optionally narrow down their search by specifying date ranges.
-
Search by Topic: Users can enter specific topics of interest to retrieve relevant news articles.
-
Select Number of Articles: Users have the flexibility to choose the number of associated articles they want to view (1, 5, or 10).
-
Date Range Filtering: Optionally, users can narrow down their search by specifying the dates between which they'd like to explore articles.
Follow these steps to set up and run the New York Times News Explorer locally:
-
Clone the repository:
git clone git@github.com:Sooey-99/automatic-umbrella.git
-
Navigate to the project directory:
cd automatic-umbrella
-
Obtain API Key:
-
Visit The New York Times Developer Portal to get your API key.
-
Create a
.env
file in the root directory and add your API key:REACT_APP_NYT_API_KEY=your-api-key
-
-
Start the application:
npm start
-
Open the application in your browser and navigate to view the result.
- Enter a topic in the search bar.
- Choose the number of associated articles (1, 5, or 10).
- Optionally, specify date ranges to narrow down your search.
- Click the "Search" button to retrieve and display news articles.
- React
- Axios (for API requests)
- Bootstrap (for styling)
- JavaScript
Contributions are welcome!
This project is licensed under the [MIT License] Copyright (c) 2024 Émile Siou.
- Thanks to The New York Times for providing the API.
For inquiries, please contact [emileluc99@outlook.com].