From 7af5fa283c10c9e0e7c990c809649e72e4700579 Mon Sep 17 00:00:00 2001
From: akamhy <64683866+akamhy@users.noreply.github.com>
Date: Mon, 4 May 2020 20:17:56 +0530
Subject: [PATCH] Update README.md

---
 README.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/README.md b/README.md
index b94b18b..09aba3b 100644
--- a/README.md
+++ b/README.md
@@ -51,3 +51,18 @@ This returns the newest available archive for <https://www.microsoft.com/en-us>,
 ```
 http://web.archive.org/web/20200429033402/https://www.microsoft.com/en-us/
 ```
+
+### Retiving archive close to a specified year, month, day, hour and minute!. Using near().
+
+waybackpy.newest(url, year=2020, month=01, day=01, hour=01, minute=01, UA=user_agent)
+
+```python
+import waybackpy
+# retriving the the closest archive from a specified year.
+# Default user-agent (UA) is "waybackpy python package", if not specified in the call.
+# supported argumnets are year,month,day,hour and minute
+archive_near_year = waybackpy.near("https://www.facebook.com/", year=2010, UA ="Any-User-Agent")
+print(archive_near_year)
+```
+returns : ```http://web.archive.org/web/20100504071154/http://www.facebook.com/```
+