Once you get the hang of it it'll get easier. It's a lot of learning by trial and error - they just switched the look of their API reference website and I could swear they used to have code samples you could use. That's mostly what I learned from, after that they all follow mostly the same pattern. My understanding is that most objects have a search object with properties that you can filter with (i.e. Device -> DeviceSearch) that is the actual object in search={} (the {}), so the word 'DeviceSearch' is not explicitly specified if you are getting a Device. But you can also use DeviceSearch in other search objects, for example a StatusDataSearch.
For example, if you want to retrieve a Device you would use a DeviceSearch object to filter them, and in that there is a Groups property that is an array of GroupSearch objects BUT only allows for an Id. So, the DeviceSearch object would be search={}, and then you'd have a groups property that is an array, search={groups:[]}, and in that array you'd have GroupSearch objects with only ids specified, search={groups:[{'id':'GroupCompanyId'}]}
The final product would look like:
devices = api.get('Device', search={'groups':[{'id':'GroupCompanyId'}]})
print(devices)Hopefully this makes sense and I didn't mispeak.
Good luck,