Add --date argument filter

README.md

@@ -12,6 +12,23 @@ The following command will search for Instagram locations nearby the coordinates
 
 Note that this requires an Instagram session ID in order to work! See below for how to obtain one from your account.
 
+## Example usage with date
+
+The following command will search for Instagram locations near Seattle's "Capitol Hill Autonomous Zone" during the George Floyd
+protests in early June, 2020. Not all location pages in the area will have posts relevant to the Zone, but some do. Open the
+resulting `map.html` file in your browser to view locations.
+
+```python3 instagram-locations.py --session "<session-id-token>" --lat 47.6164311 --lng -122.3203952 --map map.html --date 2020-06-09```
+
+When using the `--date` argument, links to Instagram location pages will be filtered to show posts created on this date or earlier.
+Instagram will usually first show a 3x3 grid of "Top Images and Videos" that are more recent, however once you scroll past that
+there is a section labeled "Most recent" which will show the posts sorted by date (if any).
+These links are only used together with the `--csv` and `--map` arguments, they aren't included in `--json` or `--geojson`.
+Note: Instagram treats these dates as "UTC", which is a timezone near Great Britain. If your target location is far from this zone,
+it's worth adding a couple of days to your filter to make sure you capture all relevant posts. Also, this only specifies the
+*maximum* post date that can be displayed. If nothing was posted that day at that location, it will show older posts (sometimes
+even multiple years older).
+
 ### Other output formats
 
 Using the `--json <output-location>` command line argument, the list can be saved as a JSON file, almost identical to the raw API response.