DataGranules().search() no longer works — suggest updating docs to use .bounding_box().get() pattern

[jeff-logixai]

Hello,
I wanted to report a potential documentation/code example issue and offer a verified update to help others.

Current Problem:

from earthaccess import DataGranules
granules = DataGranules().search(...)  # ❌ Now breaks

But DataGranules no longer has a .search() method, and using it raises:

AttributeError: 'DataGranules' object has no attribute 'search'

After testing with earthaccess 0.14.0, I confirmed the following approach does work and returns granules as expected:

from earthaccess import Auth, DataGranules
auth = Auth().login(strategy="netrc")
granules = (
    DataGranules()
    .short_name("SRTMGL1")
    .version("003")
    .temporal("2000-02-11", "2000-02-11")
    .bounding_box(-125.0, 24.0, -66.0, 50.0)  # CONUS
    .get()
)
for g in granules[:5]:
    print(g.data_links())

Hope this helps! Thanks for maintaining this incredible tool — it makes topography data so much more accessible.
Best,
JSchmidgall

[asteiker]

@jschmidgall1685 Thank you for reporting this and for suggesting this workaround!

I was searching our existing docs to identify where we are continuing to surface DataGranules().search but I want to make sure I'm not missing the place(s) where you were lead astray. I see that https://earthaccess.readthedocs.io/en/latest/tutorials/restricted-datasets/ is out of date as it is pointing to DataGranules().keyword which no longer exists. Could you confirm if this is the tutorial that you saw, or if there is other documentation that you identified that is currently out of date? In the meantime I will write up a new Issue that at least addresses this specific tutorial. Thank you again!

[jeff-logixai]

im so sorry it took me so long to get back to you. the tutorial I was originally referencing was indeed this one <https://earthaccess.readthedocs.io/en/latest/tutorials/restricted-datasets/>, which still points to DataGranules().keyword, and that’s where I initially ran into the issue. After that, I reviewed other parts of the docs and noticed that some example usages also referenced DataGranules().search, which also appears to be deprecated. It looks like both keyword and search were removed in favor of the newer earthaccess.search_data() interface, which worked great once I made the switch. Thanks again for following up — happy to test future updates or clarifications if helpful!

…

On Tue, Apr 22, 2025 at 9:48 AM Amy Steiker ***@***.***> wrote: @jschmidgall1685 <https://github.com/jschmidgall1685> Thank you for reporting this and for suggesting this workaround! I was searching our existing docs to identify where we are continuing to surface DataGranules().search but I want to make sure I'm not missing the place(s) where you were lead astray. I see that https://earthaccess.readthedocs.io/en/latest/tutorials/restricted-datasets/ is out of date as it is pointing to DataGranules().keyword which no longer exists. Could you confirm if this is the tutorial that you saw, or if there is other documentation that you identified that is currently out of date? In the meantime I will write up a new Issue that at least addresses this specific tutorial. Thank you again! — Reply to this email directly, view it on GitHub <#990 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BOUOMPJ3NPL6JGQE5KZKJED22ZJCVAVCNFSM6AAAAAB3OWYVCSVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTEOJRGE3DCOI> . You are receiving this because you were mentioned.Message ID: ***@***.***>