# app.zeens.getPostsByTag

> Published by [zeens.app](https://lexicon.garden/identity/did:plc:pwpuqwge6g7xrjmfbw73uycw)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:pwpuqwge6g7xrjmfbw73uycw/app.zeens.getPostsByTag)
- [Documentation](https://lexicon.garden/lexicon/did:plc:pwpuqwge6g7xrjmfbw73uycw/app.zeens.getPostsByTag/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:pwpuqwge6g7xrjmfbw73uycw/app.zeens.getPostsByTag/examples)

## Definitions

### `app.zeens.getPostsByTag`

**Type**: `query`

Get Zeens photo posts carrying a hashtag, newest first or by popularity.

#### Parameters

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `color` | `string` | No | Optional dominant-colour filter. |
| `cursor` | `string` | No | Pagination cursor. |
| `limit` | `integer` | No |  |
| `monochrome` | `string` | No | "true" to return only black-and-white photos. |
| `sort` | `string` | No | Ordering: newest first (default) or most liked. |
| `tag` | `string` | Yes | The hashtag, without the leading #. |

#### Output

**Encoding**: `application/json`

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Get Zeens photo posts carrying a hashtag, newest first or by popularity.",
      "output": {
        "encoding": "application/json"
      },
      "parameters": {
        "properties": {
          "color": {
            "description": "Optional dominant-colour filter.",
            "type": "string"
          },
          "cursor": {
            "description": "Pagination cursor.",
            "type": "string"
          },
          "limit": {
            "default": 50,
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          },
          "monochrome": {
            "description": "\"true\" to return only black-and-white photos.",
            "knownValues": [
              "true"
            ],
            "type": "string"
          },
          "sort": {
            "description": "Ordering: newest first (default) or most liked.",
            "knownValues": [
              "latest",
              "popular"
            ],
            "type": "string"
          },
          "tag": {
            "description": "The hashtag, without the leading #.",
            "type": "string"
          }
        },
        "required": [
          "tag"
        ],
        "type": "params"
      },
      "target_collection": "app.zeens.postMeta",
      "type": "query"
    }
  },
  "id": "app.zeens.getPostsByTag",
  "lexicon": 1
}
```