Greg Taylor

View Original

petfinder-api released

tldr; I have released petfinder-api, a Python client toPetfinder.com‘s web API. Important links: Documentation, source. petfinder-api is under the BSD License.

After months of waiting for things to settle down, Erin and I decided to spend the time to pick out our long-awaited second dog. Given that we wanted to rescue a dog, the obvious place to go is Petfinder.

We set out to find the perfect dog for Erin and I, and filtered down to what we were looking for. That only left… 36 pages to sort through. Petfinder’s filtering capabilities are very limited, the result display lists are somewhat hard to look through, and the whole thing is just pretty clunky.

Out of frustration (we had been half heartedly looking for months), my mind had often entertained the thought of trying to do better. Petfinder generously built in an API to get at their data, and it looked pretty simple. The problem was, I couldn’t find a packaged, maintained Petfinder API for Python. So it became my weekend project. This would be the first step towards making something more useful than Petfinder (getting on near equal footing as far as data goes).

I may or may not ever actually develop a Petfinder+, but I consider making it easier for developers to use their data a good cause, and am proud to announce the release of petfinder-api. It is a very thin wrapper around their web API, and includes documentation.

I’d love to hear any feedback, and hope this is useful to someone!