RSS Feeds
Feeds give you access to Kiva's data in a very simple format that many tools and applications already know how to use. We've specifically designed these for folks casual users, feed mashers, and anyone else looking for syndicated content in RSS form.
Feeds are subject to many of the same conventions as the API, but the format of the responses are very different. Rather than sticking to very strict rules about how data is formatted, feeds focus on making syndicated information human-readable within a wide range of applications. As a result, if you find feeds aren't giving you the control you want over presenting data, you might want to check out our other response formats.
We provide feed formats for API calls in cases where we think a wide range of users can get a lot of milage out of the the data using existing tools and apps. The Kiva API currently only supports the RSS 2.0 format which we assume that either you or your reader already know how to use. All requests for RSS data end in the extension rss, for example:
We're still in the process of updating all of our feeds to snazzy new versions based on the Kiva API. In the meantime, you'll find the formal documentation for both our new and legacy RSS feed collection. We've documented how to call each feed and what inputs, if any, it takes. For detail on the RSS returned by each, we encourage you to call the feed and take a look at the results.
loans/:id/updates
Returns a mix of items sorted by age from newest to oldest. Each item describes some event in the lifetime of the loan, typically a journal entry or information about a repayment.
Example:http://api.kivaws.org/v1/loans/76950/updates.rss
Parameters
- id
- the unique identifier of the loan for which you want detail
rss/businesses
Returns a descriptive item for every business (i.e., loan) matching the input criteria provided. The results are analogous to what is returned by a search or filter on the "Lend" tab on the Kiva website.
Example:http://www.kiva.org/rss/businesses?country=uganda
Parameters
- countries
- a string matching the name of country by which to filter results
- gender
- one of
maleorfemaleto specific the gender of the entrepreneurs associated with a results - partner_id
- the unique partner identifier by which to filter results
- queryString
- a generic query string used to attempt a substring match against many of the values for a business
- regions
- the region name (e.g., "North America") by which to filter results
- sectors
- the names of business sectors (e.g. "Construction") by which to filter results
- sortBy
- the order to sort the resting RSS items
- status
- the names of the status by which to filter results (default:
fundRaising)
Kiva API Sibling:/loans/search
rss/lender/[name]
Returns a descriptive item for every loan made by the lender with the identifier name. The profile of the lender must be public.
Example:http://www.kiva.org/rss/lender/matt
Parameters
- name
- The public ID of a lender, as found in his Lender Page URL or at http://www.kiva.org/myLenderId.
Kiva API Sibling: /lender/[lender_id]/loans
rss/partner/[name]
Returns a descriptive item for each fundraising loan associated with the specified Kiva Field Partner.
Example:http://www.kiva.org/rss/partner/AMK
Parameters
One of:
- partnerId
- the unique identifier of the partner by which to filter results
- name
- the name of the partner by which to filter results.
Kiva API Sibling: /loans/search?partner=[id]
rss/partnerCountries
Returns a descriptive item for every Kiva Field Partner. Each item also includes geospatial information for the location of the country in which the partner primarily operates.
Example:http://www.kiva.org/rss/partnerCountries
Parameters
NONE
Kiva API Sibling: /partners
rss/siteStats
Returns a list of items, each describing a different aggregate statistic for the Kiva site.
Example:http://www.kiva.org/rss/siteStats
Parameters
NONE
Kiva API Sibling: (NONE)
- © 2009 Kiva. All rights reserved.
- Terms Of Service
- Kiva is a 501(c)(3) nonprofit.