Skip to main content
GET
/
v1
/
products
/
{id}
/
posts
Get posts tagged with a specific product
curl --request GET \
  --url https://api.cevoid.com/v1/products/{id}/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": "LEHV6nWB2yk8pyo0adR*.7kCMdnj",
        "filename": "summer-vacation-photo.jpg"
      },
      "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"
          }
        }
      ],
      "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

​
x-api-key
string
header
required

Path Parameters

​
id
string
required

Product external ID

Example:

"product123"

Query Parameters

​
limit
number
default:25

Max value for limit is 25

Required range: 1 <= x <= 25
Example:

10

​
skip
number | null
default:0

Number of items to skip

Required range: x >= 0
Example:

0

​
market
string

Market ID or shortId for localized content

Example:

"us"

​
filter
string

JSON string array of filter criteria. See Core Concepts → Filtering for detailed filter structure and supported operators.

Example:

"[{\"type\":\"label\",\"operator\":\"OR\",\"values\":[\"507f1f77bcf86cd799439011\",\"507f191e810c19729de860ea\"]}]"

Response

Successful response

​
count
number
required

Total number of items

​
next
string | null
required

URL for next page

​
nodes
object[]
required