Here are the points I consider important when we're talking about Ajax APIs in JavaScript (Ajax implies that but you'd be surprised how often a REST API is advertised as Ajax): Good documentation / Usage examples to copy + paste / Modularity / Link results to entries / Offer flexible input / Allow for custom object transportation / Cover usability basics