# social.coves.feed.getFeedSkeleton

> Get an ordered page of post URIs from a feed generator. Served by the generator's service and called by the AppView, which hydrates the posts.

- Kind: query
- Authority: feed.coves.social
- Lexicon: 1
- Published by [coves.social](https://lexicon.garden/identity/did:web:coves.social), the NSID's authority

## Links

- [Documentation](https://lexicon.garden/lexicon/did:web:coves.social/social.coves.feed.getFeedSkeleton)
- [Schema JSON](https://lexicon.garden/lexicon/did:web:coves.social/social.coves.feed.getFeedSkeleton/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:web:coves.social/social.coves.feed.getFeedSkeleton/analytics)

## Query (`social.coves.feed.getFeedSkeleton`)

Type: query · GET

### Parameters (query string)

- `community` (string · did): DID of the community for scope=community
- `cursor` (string)
  - Constraints: maxLength: 500
- `feed` (string · at-uri, required): AT-URI of the social.coves.feed.generator record being requested
- `limit` (integer)
  - Constraints: minimum: 1, maximum: 100, default: 50
- `scope` (string, required): Which feed surface the request is for: all communities, the viewer's home feed, or one community
  - Constraints: maxLength: 64, knownValues: all | home | community
- `timeframe` (string): Timeframe for feeds ranked by top score
  - Constraints: maxLength: 64, default: "day", knownValues: hour | day | week | month | year | all

### Output (application/json)

- `schema` (ref)
  - Reference: `#output`

### Errors

- `UnknownFeed`: The generator does not serve the requested feed.
- `UnsupportedFeedScope`: The generator does not support the requested scope.
- `InvalidCursor`: The cursor is malformed or expired.

## #output (`social.coves.feed.getFeedSkeleton#output`)

Type: object

A page of post URIs in the generator's order

### Properties

- `cursor` (string)
  - Constraints: maxLength: 500
- `feed` (array, required)
  - `items` (ref)
    - Reference: `social.coves.feed.defs#skeletonFeedPost`
- `reqId` (string): Request ID assigned by the generator. The AppView returns it on the hydrated response, and clients send it back with interactions.
  - Constraints: maxLength: 100

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Get an ordered page of post URIs from a feed generator. Served by the generator's service and called by the AppView, which hydrates the posts.",
      "errors": [
        {
          "description": "The generator does not serve the requested feed.",
          "name": "UnknownFeed"
        },
        {
          "description": "The generator does not support the requested scope.",
          "name": "UnsupportedFeedScope"
        },
        {
          "description": "The cursor is malformed or expired.",
          "name": "InvalidCursor"
        }
      ],
      "output": {
        "encoding": "application/json",
        "schema": {
          "ref": "#output",
          "type": "ref"
        }
      },
      "parameters": {
        "properties": {
          "community": {
            "description": "DID of the community for scope=community",
            "format": "did",
            "type": "string"
          },
          "cursor": {
            "maxLength": 500,
            "type": "string"
          },
          "feed": {
            "description": "AT-URI of the social.coves.feed.generator record being requested",
            "format": "at-uri",
            "type": "string"
          },
          "limit": {
            "default": 50,
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          },
          "scope": {
            "description": "Which feed surface the request is for: all communities, the viewer's home feed, or one community",
            "knownValues": [
              "all",
              "home",
              "community"
            ],
            "maxLength": 64,
            "type": "string"
          },
          "timeframe": {
            "default": "day",
            "description": "Timeframe for feeds ranked by top score",
            "knownValues": [
              "hour",
              "day",
              "week",
              "month",
              "year",
              "all"
            ],
            "maxLength": 64,
            "type": "string"
          }
        },
        "required": [
          "feed",
          "scope"
        ],
        "type": "params"
      },
      "type": "query"
    },
    "output": {
      "description": "A page of post URIs in the generator's order",
      "properties": {
        "cursor": {
          "maxLength": 500,
          "type": "string"
        },
        "feed": {
          "items": {
            "ref": "social.coves.feed.defs#skeletonFeedPost",
            "type": "ref"
          },
          "type": "array"
        },
        "reqId": {
          "description": "Request ID assigned by the generator. The AppView returns it on the hydrated response, and clients send it back with interactions.",
          "maxLength": 100,
          "type": "string"
        }
      },
      "required": [
        "feed"
      ],
      "type": "object"
    }
  },
  "id": "social.coves.feed.getFeedSkeleton",
  "lexicon": 1
}
```
