From 68259fd2d929c3d9b16ac8d6c80ba6e27232009d Mon Sep 17 00:00:00 2001
From: Akash <64683866+akamhy@users.noreply.github.com>
Date: Sat, 18 Jul 2020 16:53:27 +0530
Subject: [PATCH] Update index.rst

---
 index.rst | 45 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)

diff --git a/index.rst b/index.rst
index 16544b1..0bd4d91 100644
--- a/index.rst
+++ b/index.rst
@@ -144,3 +144,48 @@ This print the newest available archive for
 https://www.microsoft.com/en-us, something just like this:
 
    http://web.archive.org/web/20200429033402/https://www.microsoft.com/en-us/
+
+Receiving archive close to a specified year, month, day, hour, and minute using near()
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. code:: python
+
+   import waybackpy
+   # retriving the the closest archive from a specified year.
+   # supported argumnets are year,month,day,hour and minute
+   target_url = waybackpy.Url(https://www.facebook.com/", "Any-User-Agent")
+   archive_near_year = target_url.near(year=2010)
+   print(archive_near_year)
+
+returns :
+http://web.archive.org/web/20100504071154/http://www.facebook.com/
+
+   Please note that if you only specify the year, the current month and
+   day are default arguments for month and day respectively. Just
+   putting the year parameter would not return the archive closer to
+   January but the current month you are using the package. You need to
+   specify the month “1” for January , 2 for february and so on.
+
+..
+
+   Do not pad (don’t use zeros in the month, year, day, minute, and hour
+   arguments). e.g. For January, set month = 1 and not month = 01.
+
+Get the content of webpage using get()
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. code:: python
+
+   import waybackpy
+   # retriving the webpage from any url including the archived urls. Don't need to import other libraies :)
+   # supported argumnets encoding and user_agent
+   target = waybackpy.Url("google.com", "any-user_agent")
+   oldest_url = target.oldest()
+   webpage = target.get(oldest_url) # We are getting the source of oldest archive of google.com.
+   print(webpage)
+
+..
+
+   This should print the source code for oldest archive of google.com.
+   If no URL is passed in get() then it should retrive the source code
+   of google.com and not any archive.