Explore Stream

An Explore Stream is a subset of all public posts flowing through App.net’s Global Stream. These Explore Streams are defined by App.net to provide developers and users new ways to discover posts. We will be adding and removing Explore Streams so in your app please Retrieve all Explore Streams and cache that list for up to 24 hours instead of hardcoding the current Explore Streams into your app.

{
  "description": "Photos uploaded to App.net",
  "slug": "photos",
  "title": "Photos",
  "url": "https://api.app.net/posts/stream/explore/photos"
}

Explore Stream Fields

Field Type Description
slug string Primary identifier for an explore stream. A lowercase alphanumeric string.
title string A human-friendly name for this Explore Stream.
description string A short description of this Explore Stream for displaying to the User.
url string The fully qualified url to the Explore Stream.

Retrieve all Explore Streams

Retrieve a list of all Explore Streams. The list of Explore Streams are dynamic and will sometimes change. Please cache them for 24 hours in your app. Also, please note that this endpoint is not paginated.

Endpoint

Method URL Token
GET https://api.app.net/posts/stream/explore None

Example

to see more complete examples.

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://api.app.net/posts/stream/explore"
{
  "data": [
    {
      "description": "Photos uploaded to App.net",
      "slug": "photos",
      "title": "Photos",
      "url": "https://api.app.net/posts/stream/explore/photos"
    }
  ],
  "meta": {
    "code": 200
  }
}

Retrieve an Explore Stream

Retrieve the Posts in an Explore Stream.

Responses from this endpoint are paginated.

Endpoint

Method URL Token
GET https://api.app.net/posts/stream/explore/{slug} None

URL Parameters

Name Description
slug The slug of the Explore Stream to retrieve.

Example

to see more complete examples.

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://api.app.net/posts/stream/explore/photos"
{
  "data": [
    "...post objects..."
  ],
  "meta": {
    "code": 200,
    "more": false,
    "max_id": "3382496",
    "min_id": "3382480",
    "marker": {
      "name": "explore:photos"
    },
    "explore_stream": {
      "description": "Photos uploaded to App.net",
      "slug": "photos",
      "title": "Photos",
      "url": "https://api.app.net/posts/stream/explore/photos"
    }
  }
}