Request for comments

The open web's hidden social graph

An API for sharing recommended feeds and podcasts using open standards. Help unlock the next generation of social experiences.

GET /.well-known/following.opml
HTTP/1.1 200 OK Content-Type: text/x-opml; charset=utf-8 Access-Control-Allow-Origin: * 
<opml version="2.0">
  <head>
    <title>Jordan Doe's followed feeds</title>
  </head>
  <body>
    <outline text="Anil Dash" xmlUrl="https://www.anildash.com/feed.xml" />
    <outline text="Caleb Hailey" xmlUrl="https://calebhailey.com/feeds/main.xml" />
    <outline text="Daring Fireball" xmlUrl="https://daringfireball.net/feeds/main" />
  </body>
</opml>

Jordan Doe

@jordandoe.com

Eager explorer, eternal optimist, passionate about taking the long way home.

I published my following list

Three feeds I think everyone should read.

First tomatoes of the year

Late, small, and absolutely worth it.

Small software, on purpose

Notes from a year of building less.

Anil Dash @anildash.com
Caleb Hailey @calebhailey.com
Daring Fireball @daringfireball.net
Eater @eater.com
HyperTexting @hypertexting.com
Kottke @kottke.org
Molly White @mollywhite.net
New York Times @nytimes.com
Platformer @platformer.news
Dave Winer @scripting.com
Spyglass @spyglass.org
The Verge @theverge.com
This American Life @thisamericanlife.org
map[body:Eager explorer, eternal optimist, passionate about taking the long way home. heading:Jordan Doe links:[]]

For publishers

From personal websites to CMS platforms

Use the FollowSpec API to share followed feeds and help your community make new connections.

That's it. That's all publishers need to implement.

Join the RFC →
Sitemap
  1. /index.html
  2. /.well-known/following.opml
Request Discovery
GET https://jordandoe.com/.well-known/following.opml Host: jordandoe.com Accept: text/x-opml If-None-Match: "5eb63bbbe01eeed093cb22bb8f5acdc3"
Response Verification
HTTP/1.1 200 OK TLS certificate for jordandoe.com: valid Content-Type: text/x-opml; charset=utf-8

For subscribers

From RSS feed readers to next-gen social experiences

Use the FollowSpec API to help users discover recommended feeds from websites they trust:

  • Discovery is a single HTTP GET request
  • Parse responses using standard XML libraries
  • Display feeds in "Following" tabs

That's it. That's all subscribers need to implement.

Join the RFC →

Open source, open process.

Help shape the future of the @followspec.org API.

Join the RFC 1