api January 15, 2010

What Would a Stack Overflow API Look Like?

We are now gearing up to build the first official Stack Overflow API. Please bear in mind that the first version of the API will be read-only by design. We’d rather attack the much harder problem of writing (that is, submitting questions, answers, and comments) in V2 with improvements rolled in from our experience having…
Avatar for Jeff Atwood
Co-Founder (Former)

We are now gearing up to build the first official Stack Overflow API.

Please bear in mind that the first version of the API will be read-only by design. We’d rather attack the much harder problem of writing (that is, submitting questions, answers, and comments) in V2 with improvements rolled in from our experience having the read-only V1 API out there first.

To get an idea of what working with this imaginary Stack Overflow API could look like, browse the project Stack Overflow user Kevin Montrose set up:

Stack Exchange API on Google Code

To be 100% clear, we are NOT blessing this as an official API, but we’d like to take advantage of the hard work Kevin has rolled into his code to help produce a proper Stack Overflow API that doesn’t suck.

Because what currently passes for an API on Stack Overflow was never truly intended as such, it’s important to regard what’s in place now as a preliminary sketch, a temporary crutch, a placeholder for something better.

To produce a decent read-only V1 API for Stack Overflow, we need your input:

  1. Read through the highest voted questions tagged [api] on meta.

  2. Browse Kevin’s document Desired Stack Overflow API which is based on his experience writing SXAPI.

Done? Good.

Now, what do you want to build that uses the API? The perfect API for this task, called from your preferred programming language, would do … what, exactly? What’s clean? What’s simple? What’s supportable and scalable?

If WordPress comments are too limiting, and you’d like to post some code samples or use Markdown formatting, feel free to use the SXAPI Meta question to do so — or any place on Meta, really, as long as it’s properly tagged with [api].

Podcast logo The Stack Overflow Podcast is a weekly conversation about working in software development, learning to code, and the art and culture of computer programming.

Related

newsletter April 9, 2021

The Overflow #68: Our first piece of hardware?

Welcome to ISSUE #68 of the Overflow! This newsletter is by developers, for developers, written and curated by the Stack Overflow team and Cassidy Williams at Netlify. This week: we April fooled ‘em with custom hardware, can you use general relativity to lengthen your day, and a look at a refreshing new language for SPAs. From the blog…
newsletter October 16, 2020

The Overflow #43: Simulated keyboards

Welcome to ISSUE #43 of the Overflow! This newsletter is by developers, for developers, written and curated by the Stack Overflow team and Cassidy Williams at Netlify. This week, we’re coding for the long game, learning the difference between cats and not cats, and translating our favorite JRPGs into English. From the blog Play the long game when…