# Get posts with a specific label

> Retrieve all posts that have been assigned a specific label

Breadcrumb: API v1 › Get posts with a specific label · Status: Legacy
Docs index: https://docs.cevoid.com/developers/llms.txt

`GET https://api.cevoid.com/v1/labels/{id}/posts`

Retrieve all posts that have been assigned a specific label

## Authorizations

API key in the x-api-key header: `x-api-key: <key>`.

## Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `string` | Yes | Unique identifier Example: `507f1f77bcf86cd799439011`. |

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | `number` | No | Max value for limit is 25 Default: `25`. Range: `1 <= x <= 25`. Example: `10`. |
| `skip` | `number \| null` | No | Number of items to skip Default: `0`. Range: `0 <= x`. Example: `0`. |
| `market` | `string` | No | Market ID or shortId for localized content Example: `us`. |

## Response

### 200: Successful response

`application/json`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `count` | `number` | Yes | Total number of items |
| `next` | `string \| null` | Yes | URL for next page |
| `nodes` | `object[]` | Yes |  |
| `nodes[].id` | `string` | Yes | Unique identifier for the post within the Cevoid system Example: `post_abc123def456`. |
| `nodes[].origin` | `object` | No |  |
| `nodes[].origin.type` | `string` | Yes | Source platform where the post originated (e.g., "instagram", "tiktok", "upload", "manual") Example: `instagram`. |
| `nodes[].alt` | `string` | No | Alternative text description for screen readers and accessibility tools, providing a text-based description of the visual content Example: `Woman wearing sunglasses standing next to a red convertible car on a sunny beach`. |
| `nodes[].videoCaptions` | `string` | No | Transcript or captions for video content, providing text representation of spoken words and audio cues Example: `Welcome to our summer collection! Check out these amazing sunglasses perfect for beach days.`. |
| `nodes[].videoDescription` | `string` | No | Detailed description of video content including visual elements, actions, and scenes for accessibility Example: `Video shows a woman modeling sunglasses while walking along a sandy beach with palm trees in the background`. |
| `nodes[].instagramUrl` | `string` | No | Original Instagram post URL if this content was imported from Instagram Example: `https://www.instagram.com/p/ABC123DEF456/`. |
| `nodes[].type` | `string` | No | Media type of the post content, typically "IMAGE" for photos or "VIDEO" for video content Example: `IMAGE`. |
| `nodes[].fromInstagram` | `boolean` | No | Indicates whether this post was imported from Instagram through social media integration Example: `true`. |
| `nodes[].addedByCompany` | `boolean` | No | Indicates whether this post was uploaded directly by the company/brand rather than user-generated content Example: `false`. |
| `nodes[].createdAt` | `string` | Yes | ISO 8601 timestamp indicating when the post was first created or imported into the Cevoid system Example: `2024-01-15T10:30:00.000Z`. |
| `nodes[].instagramDate` | `string` | No | ISO 8601 timestamp of when the post was originally published on Instagram. Only present for Instagram-sourced content. Example: `2024-01-10T14:22:00.000Z`. |
| `nodes[].media` | `object` | Yes |  |
| `nodes[].media.location` | `string` | Yes | URL or CDN path to the media file (image or video) Example: `https://cdn.cevoid.com/media/posts/abc123.jpg`. |
| `nodes[].media.hash` | `string` | No | Blurhash string for generating blur placeholder images while the media is loading. Use with the blurhash library to decode. Example: `LEHV6nWB2yk8pyo0adR*.7kCMdnj`. |
| `nodes[].media.filename` | `string` | No | Original filename when the media was uploaded, preserving the user's original file naming Example: `summer-vacation-photo.jpg`. |
| `nodes[].comment` | `string` | No | Caption or comment text associated with the post, often containing hashtags, mentions, and descriptions Example: `Perfect day at the beach! ☀️ #SummerVibes #BeachLife #Sunglasses`. |
| `nodes[].taggedProducts` | `object[]` | Yes | Array of products that have been tagged or featured in this post, including their position coordinates and product details |
| `nodes[].taggedProducts[].x` | `number` | Yes | Horizontal position coordinate (0-1) where the product is tagged on the image/video Example: `0.35`. |
| `nodes[].taggedProducts[].y` | `number` | Yes | Vertical position coordinate (0-1) where the product is tagged on the image/video Example: `0.65`. |
| `nodes[].taggedProducts[].product` | `object` | Yes | Complete product information including pricing, media, and links |
| `nodes[].taggedProducts[].product.id` | `string` | Yes | Unique identifier for the product in the Cevoid system Example: `prod_abc123`. |
| `nodes[].taggedProducts[].product.title` | `string` | Yes | Display name/title of the product as shown to customers Example: `Wireless Bluetooth Headphones`. |
| `nodes[].taggedProducts[].product.price` | `object` | No | Pricing information for the product including regular price, currency, and sale pricing |
| `nodes[].taggedProducts[].product.price.price` | `number` | No | Regular price of the product in the specified currency Example: `99.99`. |
| `nodes[].taggedProducts[].product.price.currency` | `string` | No | ISO 4217 currency code for the product pricing Example: `USD`. |
| `nodes[].taggedProducts[].product.price.salePrice` | `number` | No | Discounted sale price if the product is currently on sale Example: `79.99`. |
| `nodes[].taggedProducts[].product.category` | `string` | No | Product category or classification for organizational purposes Example: `Electronics > Audio > Headphones`. |
| `nodes[].taggedProducts[].product.media` | `object` | No |  |
| `nodes[].taggedProducts[].product.media.location` | `string` | Yes | URL or CDN path to the media file (image or video) Example: `https://cdn.cevoid.com/media/posts/abc123.jpg`. |
| `nodes[].taggedProducts[].product.media.hash` | `string` | No | Blurhash string for generating blur placeholder images while the media is loading. Use with the blurhash library to decode. Example: `LEHV6nWB2yk8pyo0adR*.7kCMdnj`. |
| `nodes[].taggedProducts[].product.media.filename` | `string` | No | Original filename when the media was uploaded, preserving the user's original file naming Example: `summer-vacation-photo.jpg`. |
| `nodes[].taggedProducts[].product.handle` | `string` | Yes | URL-friendly identifier for the product, typically used in product page URLs Example: `wireless-bluetooth-headphones`. |
| `nodes[].taggedProducts[].product.url` | `string` | No | Full URL to the product page on the e-commerce store Example: `https://mystore.com/products/wireless-bluetooth-headphones`. |
| `nodes[].taggedProducts[].product.developmentUrl` | `string` | No | Development/staging URL for the product page, used for testing purposes Example: `https://dev.mystore.com/products/wireless-bluetooth-headphones`. |
| `nodes[].taggedProducts[].product.sku` | `string` | No | Stock keeping unit for the resolved product/variant. Omitted when the source feed does not provide one (e.g. Google Shopping feeds rarely map SKU). Example: `WH-1000XM5-BLK`. |
| `nodes[].taggedProducts[].product.mpn` | `string` | No | Manufacturer part number. For grouped products this is typically the style-level number and is stable across sizes. Omitted when absent. Example: `693903`. |
| `nodes[].taggedProducts[].product.gtin` | `string` | No | Global Trade Item Number (UPC/EAN/ISBN) for the resolved variant. For a group-level (family) tag this may reflect a single representative variant rather than every size. Falls back to the barcode field for Shopify sources. Omitted when absent. Example: `7391998206837`. |
| `nodes[].hideCaption` | `boolean` | No | Setting to control whether the post caption should be hidden when displaying the post in galleries or widgets Example: `false`. |
| `nodes[].uploadedBy` | `object` | No |  |
| `nodes[].uploadedBy.username` | `string` | Yes | Username or display name of the user who uploaded/created this post Example: `john_doe_photography`. |
| `nodes[].uploadedBy.email` | `string` | No | Email address of the member who submitted this post. Only included for inbox posts. Example: `sarah@example.com`. |
| `nodes[].uploadedBy.image` | `object` | No | Profile image information for the user who uploaded this post |
| `nodes[].uploadedBy.image.hash` | `string` | Yes | Unique content hash for the user's profile image Example: `sha256:b2c3d4e5f6a7...`. |
| `nodes[].uploadedBy.image.filename` | `string` | Yes | Original filename of the user's profile image Example: `profile-pic.jpg`. |
| `nodes[].uploadedBy.image.location` | `string` | Yes | URL or CDN path to the user's profile image Example: `https://cdn.cevoid.com/profiles/user123/avatar.jpg`. |

```json
{
  "count": 0,
  "next": "string",
  "nodes": [
    {
      "id": "post_abc123def456",
      "origin": {
        "type": "instagram"
      },
      "alt": "Woman wearing sunglasses standing next to a red convertible car on a sunny beach",
      "videoCaptions": "Welcome to our summer collection! Check out these amazing sunglasses perfect for beach days.",
      "videoDescription": "Video shows a woman modeling sunglasses while walking along a sandy beach with palm trees in the background",
      "instagramUrl": "https://www.instagram.com/p/ABC123DEF456/",
      "type": "IMAGE",
      "fromInstagram": true,
      "addedByCompany": false,
      "createdAt": "2024-01-15T10:30:00.000Z",
      "instagramDate": "2024-01-10T14:22:00.000Z",
      "media": {
        "location": "https://cdn.cevoid.com/media/posts/abc123.jpg",
        "hash": "LEHV6nWB2yk8pyo0adR*.7kCMdnj",
        "filename": "summer-vacation-photo.jpg"
      },
      "comment": "Perfect day at the beach! ☀️ #SummerVibes #BeachLife #Sunglasses",
      "taggedProducts": [
        {
          "x": 0.35,
          "y": 0.65,
          "product": {
            "id": "prod_abc123",
            "title": "Wireless Bluetooth Headphones",
            "price": {
              "price": 99.99,
              "currency": "USD",
              "salePrice": 79.99
            },
            "category": "Electronics > Audio > Headphones",
            "media": {
              "location": "https://cdn.cevoid.com/media/products/headphones-main.jpg",
              "hash": "a1b2c3d4e5f6g7h8i9j0",
              "filename": "wireless-headphones-product-image.jpg"
            },
            "handle": "wireless-bluetooth-headphones",
            "url": "https://mystore.com/products/wireless-bluetooth-headphones",
            "developmentUrl": "https://dev.mystore.com/products/wireless-bluetooth-headphones",
            "sku": "WH-1000XM5-BLK",
            "mpn": "693903",
            "gtin": "7391998206837"
          }
        }
      ],
      "hideCaption": false,
      "uploadedBy": {
        "username": "john_doe_photography",
        "email": "sarah@example.com",
        "image": {
          "hash": "sha256:b2c3d4e5f6a7...",
          "filename": "profile-pic.jpg",
          "location": "https://cdn.cevoid.com/profiles/user123/avatar.jpg"
        }
      }
    }
  ]
}
```

### 400: Bad request

`application/json`

Type: `string`.

```json
"string"
```

### 401: Unauthorized

`application/json`

Type: `enum<string>`. Allowed value: `No valid API key provided`.

```json
"No valid API key provided"
```

### 500: Internal server error

`application/json`

Type: `enum<string>`. Allowed value: `Something went wrong`.

```json
"Something went wrong"
```

## Request example

```bash
curl 'https://api.cevoid.com/v1/labels/507f1f77bcf86cd799439011/posts' \
  -H "x-api-key: ${CEVOID_API_KEY}"
```

---

Canonical: https://docs.cevoid.com/developers/api/v1/posts/get-posts-with-a-specific-label