From e91c962fd21bb4f6919c4fa86bae65ce3dab3511 Mon Sep 17 00:00:00 2001
From: Oscar Martinez <82097051+OscarRunsCode@users.noreply.github.com>
Date: Fri, 26 Dec 2025 13:12:16 -0500
Subject: [PATCH] Update fred.py

Added code to deal with cases where searches fail due to out of bounds timestamps.

To recreate this issue, one can run

```
from fredapi import Fred
fred = Fred(api_key='your_api_key')
fs = fred.search('Consumer Price Index', order_by='popularity', limit=5, sort_order='desc').reset_index()
```
---
 fredapi/fred.py | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/fredapi/fred.py b/fredapi/fred.py
index c6c7cb3..31aec95 100644
--- a/fredapi/fred.py
+++ b/fredapi/fred.py
@@ -12,6 +12,7 @@
     import urllib2 as url_error
 
 import pandas as pd
+from pandas._libs.tslibs import OutOfBoundsDatetime
 
 urlopen = url_request.urlopen
 quote_plus = url_parse.quote_plus
@@ -92,9 +93,13 @@ def _parse(self, date_str, format='%Y-%m-%d'):
         """
         helper function for parsing FRED date string into datetime
         """
-        rv = pd.to_datetime(date_str, format=format)
-        if hasattr(rv, 'to_pydatetime'):
-            rv = rv.to_pydatetime()
+        try:
+            rv = pd.to_datetime(date_str, format=format, errors='raise')
+            if hasattr(rv, 'to_pydatetime'):
+                rv = rv.to_pydatetime()
+        except (ValueError, OutOfBoundsDatetime):
+            # Handle out-of-bounds or invalid dates
+            rv = None  # or set a default value
         return rv
 
     def get_series_info(self, series_id):
@@ -326,6 +331,7 @@ def __do_series_search(self, url):
             # parse datetime columns
             for field in ["realtime_start", "realtime_end", "observation_start", "observation_end", "last_updated"]:
                 data[field] = data[field].apply(self._parse, format=None)
+                data[field] = data[field].replace({pd.NaT: None})  # Replace NaT (Not a Time) with None
             # set index name
             data.index.name = 'series id'
         else: