Info for Site Owners

Why Should I Add My Site to

Blogs come in all shapes and sizes from newspapers, to personal blogs to twitter-like microblogs, and is the open search directory for it all. Adding your site to's growing index of blogs, microblogs, and photoblogs can help your site get more exposure and help users more easily discover and recommend your site. Additionally, directory is available to other apps via the official API, so once you add your site to, it will show up in any app using's API.

What Happens When I Add My Site?

When a user submits a link to's index, a request is sent to the site and its contents are crawled to determine if it's a feed, or a site. Feeds are added directly to the Pine index with a link to their parent site. A site, however, is inspected for any feeds on the given page and any feeds found this way are tied to the site.

Once a site has been inspected, needs to determine which feed (if multiple) is the site's main feed since, by default, when a user follows a site they're subscribed to its main feed. will always prefer links to Feedburner and JSON Feeds when multiple feeds are found. If no feed falls into this category, then the feed with the shortest URL is used (since this is most likely to be the home feed of the site). In all cases, feeds that are most likely comments feeds (i.e. WordPress Comments Feeds) are almost never considered the main feed.

In an effort to simplify and to prevent spam, populates a site's data with information found in its feeds. No attempts are made to gather information from the host site since RSS and JSON Feeds provide all the information needed.

Subscriber Counts

When crawls a feed on your site looking for new posts, the User-Agent header in the request will have two important pieces of information that you can use for your own analytics: the id of the feed in, and the number of users on that are subscribed to that feed. For reference, the header you'll find will look something like this:

User-Agent: Feed Crawler (156 subscribers; feed-id=some-uuid; +

Important Note: also requests various resources from your site when importing a site for the first time, or when a feed changes. These requests are often made to your site's home page or to any media that's linked in new posts. Requests made this way will not include any subscriber counts. Counts are only present in requests for the actual feed.

Additionally, tries to determine various metadata about a post from its contents and although does make requests to your site for linked media, they are not cached or stored by Users will always request resources and media directly from your servers.

Addition Crawling Info

Please ensure the following servers are not prevented from accessing your site. Blocking these servers will cause all users from being able to receive updates from your site.


Standard Caching Headers are obeyed for up to 1 day. will automatically refetch the contents of your site at least once per day.

Payments and Contact Information

When crawls your feed, it may make additional requests to the pages linked to by the feed. When doing so, collects rel=payment and rel=contact links. will show icons on your site's pages and in the app to encourage people to contact you and support your work. does not handle or process your payments in any way nor does handle any communications between your site and your readers. It just displays a link to any resources you've added to let your readers know how to support your work and get in touch.

Webmentions sends and receives Webmentions. When a user likes, comments on, or replies to a post, will send Webmentions to the relevant site. To receive Webmentions for, all you need to do is ensure that your site is compatible with the Endpoint Discovery methods described in the Webmention Specification (all methods are supported).

Webmention Requests will always be made with the following User-Agent string. Webmention Discovery also receives Webmentions. You can send Webmentions to the following URL:

Webmention Icons and Follower Status uses h-entry classes in the target page's markup to determine what icons, name, and URL to show in the content of the Webmention. supports replies, mentions, and likes. Reposts are shown as mentions.

Users can elect to only show the comments, mentions, or replies from sites they follow on their blog. In this case, uses h-entry tags (specifically the p-author and u-url tags) to determine if a given site is one that the user follows. If your site does not support h-entry classes, then it will be omitted in all cases where the user has selected this option.