# Get post by ID > Retrieve a single post by its ID Breadcrumb: API v1 › Get post by ID · Status: Legacy Docs index: https://docs.cevoid.com/developers/llms.txt `GET https://api.cevoid.com/v1/posts/{id}` Retrieve a single post by its ID ## Authorizations API key in the x-api-key header: `x-api-key: `. ## Path parameters | Name | Type | Required | Description | | --- | --- | --- | --- | | `id` | `string` | Yes | Unique identifier Example: `507f1f77bcf86cd799439011`. | ## Query parameters | Name | Type | Required | Description | | --- | --- | --- | --- | | `market` | `string` | No | Market ID or shortId for localized content Example: `us`. | ## Response ### 200: Successful response `application/json` | Field | Type | Required | Description | | --- | --- | --- | --- | | `id` | `string` | Yes | Unique identifier for the post within the Cevoid system Example: `post_abc123def456`. | | `origin` | `object` | No | | | `origin.type` | `string` | Yes | Source platform where the post originated (e.g., "instagram", "tiktok", "upload", "manual") Example: `instagram`. | | `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`. | | `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.`. | | `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`. | | `instagramUrl` | `string` | No | Original Instagram post URL if this content was imported from Instagram Example: `https://www.instagram.com/p/ABC123DEF456/`. | | `type` | `string` | No | Media type of the post content, typically "IMAGE" for photos or "VIDEO" for video content Example: `IMAGE`. | | `fromInstagram` | `boolean` | No | Indicates whether this post was imported from Instagram through social media integration Example: `true`. | | `addedByCompany` | `boolean` | No | Indicates whether this post was uploaded directly by the company/brand rather than user-generated content Example: `false`. | | `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`. | | `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`. | | `media` | `object` | Yes | | | `media.location` | `string` | Yes | URL or CDN path to the media file (image or video) Example: `https://cdn.cevoid.com/media/posts/abc123.jpg`. | | `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`. | | `media.filename` | `string` | No | Original filename when the media was uploaded, preserving the user's original file naming Example: `summer-vacation-photo.jpg`. | | `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`. | | `taggedProducts` | `object[]` | Yes | Array of products that have been tagged or featured in this post, including their position coordinates and product details | | `taggedProducts[].x` | `number` | Yes | Horizontal position coordinate (0-1) where the product is tagged on the image/video Example: `0.35`. | | `taggedProducts[].y` | `number` | Yes | Vertical position coordinate (0-1) where the product is tagged on the image/video Example: `0.65`. | | `taggedProducts[].product` | `object` | Yes | Complete product information including pricing, media, and links | | `taggedProducts[].product.id` | `string` | Yes | Unique identifier for the product in the Cevoid system Example: `prod_abc123`. | | `taggedProducts[].product.title` | `string` | Yes | Display name/title of the product as shown to customers Example: `Wireless Bluetooth Headphones`. | | `taggedProducts[].product.price` | `object` | No | Pricing information for the product including regular price, currency, and sale pricing | | `taggedProducts[].product.price.price` | `number` | No | Regular price of the product in the specified currency Example: `99.99`. | | `taggedProducts[].product.price.currency` | `string` | No | ISO 4217 currency code for the product pricing Example: `USD`. | | `taggedProducts[].product.price.salePrice` | `number` | No | Discounted sale price if the product is currently on sale Example: `79.99`. | | `taggedProducts[].product.category` | `string` | No | Product category or classification for organizational purposes Example: `Electronics > Audio > Headphones`. | | `taggedProducts[].product.media` | `object` | No | | | `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`. | | `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`. | | `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`. | | `taggedProducts[].product.handle` | `string` | Yes | URL-friendly identifier for the product, typically used in product page URLs Example: `wireless-bluetooth-headphones`. | | `taggedProducts[].product.url` | `string` | No | Full URL to the product page on the e-commerce store Example: `https://mystore.com/products/wireless-bluetooth-headphones`. | | `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`. | | `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`. | | `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`. | | `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`. | | `hideCaption` | `boolean` | No | Setting to control whether the post caption should be hidden when displaying the post in galleries or widgets Example: `false`. | | `uploadedBy` | `object` | No | | | `uploadedBy.username` | `string` | Yes | Username or display name of the user who uploaded/created this post Example: `john_doe_photography`. | | `uploadedBy.email` | `string` | No | Email address of the member who submitted this post. Only included for inbox posts. Example: `sarah@example.com`. | | `uploadedBy.image` | `object` | No | Profile image information for the user who uploaded this post | | `uploadedBy.image.hash` | `string` | Yes | Unique content hash for the user's profile image Example: `sha256:b2c3d4e5f6a7...`. | | `uploadedBy.image.filename` | `string` | Yes | Original filename of the user's profile image Example: `profile-pic.jpg`. | | `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 { "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`. Allowed value: `No valid API key provided`. ```json "No valid API key provided" ``` ### 404: Not found `application/json` Same fields as 400. ```json "string" ``` ### 429: Too many requests `application/json` Same fields as 400. ```json "string" ``` ### 500: Internal server error `application/json` Type: `enum`. Allowed value: `Something went wrong`. ```json "Something went wrong" ``` ## Request example ```bash curl 'https://api.cevoid.com/v1/posts/507f1f77bcf86cd799439011' \ -H "x-api-key: ${CEVOID_API_KEY}" ``` --- Canonical: https://docs.cevoid.com/developers/api/v1/posts/get-post-by-id