Posts
Members
Get posts by filter
Retrieve posts with optional filtering by labels
curl --request GET \
--url https://api.cevoid.com/v1/posts \
--header 'x-api-key: <api-key>'{
"count": 123,
"next": "<string>",
"nodes": [
{
"id": "post_abc123def456",
"createdAt": "2024-01-15T10:30:00.000Z",
"media": {
"location": "https://cdn.cevoid.com/media/posts/abc123.jpg",
"hash": "sha256:a1b2c3d4e5f6...",
"filename": "summer-vacation-photo.jpg"
},
"taggedProducts": [],
"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,
"comment": "Perfect day at the beach! ☀️ #SummerVibes #BeachLife #Sunglasses",
"hideCaption": false,
"uploadedBy": {
"username": "john_doe_photography",
"image": {
"hash": "sha256:b2c3d4e5f6a7...",
"filename": "profile-pic.jpg",
"location": "https://cdn.cevoid.com/profiles/user123/avatar.jpg"
}
}
}
]
}Authorizations
Query Parameters
Max value for limit is 25
1 <= x <= 2510
Number of items to skip
x >= 00
Market ID or shortId for localized content
"us"
JSON string array of filter criteria. See Core Concepts → Filtering for detailed filter structure and supported operators.
"[{\"type\":\"label\",\"operator\":\"OR\",\"values\":[\"507f1f77bcf86cd799439011\",\"507f191e810c19729de860ea\"]}]"
Response
Successful response
Total number of items
URL for next page
Show child attributes
Show child attributes
Unique identifier for the post within the Cevoid system
"post_abc123def456"
ISO 8601 timestamp indicating when the post was first created or imported into the Cevoid system
"2024-01-15T10:30:00.000Z"
Show child attributes
Show child attributes
URL or CDN path to the media file (image or video)
"https://cdn.cevoid.com/media/posts/abc123.jpg"
Unique content hash identifier for the media file, used for deduplication and integrity verification
"sha256:a1b2c3d4e5f6..."
Original filename when the media was uploaded, preserving the user's original file naming
"summer-vacation-photo.jpg"
Array of products that have been tagged or featured in this post, including their position coordinates and product details
Show child attributes
Show child attributes
Horizontal position coordinate (0-1) where the product is tagged on the image/video
0.35
Vertical position coordinate (0-1) where the product is tagged on the image/video
0.65
Complete product information including pricing, media, and links
Show child attributes
Show child attributes
Unique identifier for the product in the Cevoid system
"prod_abc123"
Display name/title of the product as shown to customers
"Wireless Bluetooth Headphones"
URL-friendly identifier for the product, typically used in product page URLs
"wireless-bluetooth-headphones"
Pricing information for the product including regular price, currency, and sale pricing
Show child attributes
Show child attributes
Regular price of the product in the specified currency
99.99
ISO 4217 currency code for the product pricing
"USD"
Discounted sale price if the product is currently on sale
79.99
Product category or classification for organizational purposes
"Electronics > Audio > Headphones"
Show child attributes
Show child attributes
URL or CDN path to the media file (image or video)
"https://cdn.cevoid.com/media/posts/abc123.jpg"
Unique content hash identifier for the media file, used for deduplication and integrity verification
"sha256:a1b2c3d4e5f6..."
Original filename when the media was uploaded, preserving the user's original file naming
"summer-vacation-photo.jpg"
Full URL to the product page on the e-commerce store
"https://mystore.com/products/wireless-bluetooth-headphones"
Development/staging URL for the product page, used for testing purposes
"https://dev.mystore.com/products/wireless-bluetooth-headphones"
[]Alternative text description for screen readers and accessibility tools, providing a text-based description of the visual content
"Woman wearing sunglasses standing next to a red convertible car on a sunny beach"
Transcript or captions for video content, providing text representation of spoken words and audio cues
"Welcome to our summer collection! Check out these amazing sunglasses perfect for beach days."
Detailed description of video content including visual elements, actions, and scenes for accessibility
"Video shows a woman modeling sunglasses while walking along a sandy beach with palm trees in the background"
Original Instagram post URL if this content was imported from Instagram
"https://www.instagram.com/p/ABC123DEF456/"
Media type of the post content, typically "IMAGE" for photos or "VIDEO" for video content
"IMAGE"
Indicates whether this post was imported from Instagram through social media integration
true
Indicates whether this post was uploaded directly by the company/brand rather than user-generated content
false
Caption or comment text associated with the post, often containing hashtags, mentions, and descriptions
"Perfect day at the beach! ☀️ #SummerVibes #BeachLife #Sunglasses"
Setting to control whether the post caption should be hidden when displaying the post in galleries or widgets
false
Show child attributes
Show child attributes
Username or display name of the user who uploaded/created this post
"john_doe_photography"
Profile image information for the user who uploaded this post
Show child attributes
Show child attributes
Unique content hash for the user's profile image
"sha256:b2c3d4e5f6a7..."
Original filename of the user's profile image
"profile-pic.jpg"
URL or CDN path to the user's profile image
"https://cdn.cevoid.com/profiles/user123/avatar.jpg"
curl --request GET \
--url https://api.cevoid.com/v1/posts \
--header 'x-api-key: <api-key>'{
"count": 123,
"next": "<string>",
"nodes": [
{
"id": "post_abc123def456",
"createdAt": "2024-01-15T10:30:00.000Z",
"media": {
"location": "https://cdn.cevoid.com/media/posts/abc123.jpg",
"hash": "sha256:a1b2c3d4e5f6...",
"filename": "summer-vacation-photo.jpg"
},
"taggedProducts": [],
"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,
"comment": "Perfect day at the beach! ☀️ #SummerVibes #BeachLife #Sunglasses",
"hideCaption": false,
"uploadedBy": {
"username": "john_doe_photography",
"image": {
"hash": "sha256:b2c3d4e5f6a7...",
"filename": "profile-pic.jpg",
"location": "https://cdn.cevoid.com/profiles/user123/avatar.jpg"
}
}
}
]
}