List posts

GET

posts

List posts

curl --request GET \
  --url https://api.widget.cevoid.com/v1/posts \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.widget.cevoid.com/v1/posts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.widget.cevoid.com/v1/posts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.widget.cevoid.com/v1/posts"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.widget.cevoid.com/v1/posts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "pst_summerlook",
      "type": "IMAGE",
      "media": {
        "url": "https://cdn.cevoid.com/posts/pst_summerlook.jpg",
        "thumbnail_url": "https://cdn.cevoid.com/posts/pst_summerlook-thumbnail.jpg",
        "sprite_url": "https://cdn.cevoid.com/posts/pst_summerlook-sprite.jpg",
        "blurhash": "LEHV6nWB2yk8pyo0adR*.7kCMdnj",
        "aspect_ratio": 0.8,
        "duration_seconds": 12.5,
        "has_audio": false
      },
      "caption": "A summer favorite.",
      "hide_caption": false,
      "alt": "Person wearing a beige linen shirt outdoors.",
      "source_url": "https://www.instagram.com/p/example/",
      "author": {
        "name": "@jane",
        "avatar_url": "https://cdn.cevoid.com/profiles/prf_jane.jpg"
      },
      "tagged_products": [
        {
          "id": "prd_linen_shirt",
          "type": "PRODUCT",
          "title": "Linen Shirt",
          "url": "https://shop.example.com/products/linen-shirt",
          "image_url": "https://cdn.cevoid.com/products/linen-shirt.jpg",
          "price": {
            "min_amount": 59.95,
            "max_amount": 79.95,
            "currency": "SEK"
          },
          "x": 0.35,
          "y": 0.65
        }
      ],
      "published_at": "2026-08-01T10:00:00.000Z"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJwdWJsaXNoZWRBdCI6IjIwMjYtMDgtMDFUMTA6MDA6MDAuMDAwWiJ9"
}

{
  "status": 404,
  "code": "not_found",
  "message": "Resource not found",
  "additional_data": {},
  "request_id": "req_abc123"
}

{
  "status": 404,
  "code": "not_found",
  "message": "Resource not found",
  "additional_data": {},
  "request_id": "req_abc123"
}

{
  "status": 404,
  "code": "not_found",
  "message": "Resource not found",
  "additional_data": {},
  "request_id": "req_abc123"
}

{
  "status": 404,
  "code": "not_found",
  "message": "Resource not found",
  "additional_data": {},
  "request_id": "req_abc123"
}

{
  "status": 404,
  "code": "not_found",
  "message": "Resource not found",
  "additional_data": {},
  "request_id": "req_abc123"
}

{
  "status": 429,
  "code": "rate_limit_exceeded",
  "message": "Rate limit exceeded",
  "request_id": "req_abc123",
  "additional_data": {
    "retry_after_seconds": 1
  }
}

{
  "status": 404,
  "code": "not_found",
  "message": "Resource not found",
  "additional_data": {},
  "request_id": "req_abc123"
}

{
  "status": 404,
  "code": "not_found",
  "message": "Resource not found",
  "additional_data": {},
  "request_id": "req_abc123"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

market

string

required

Market identifier used for localized product data.

Required string length: 1 - 256

Example:

"mar_sweden"

profile_id

string

Return posts attributed to this profile.

Required string length: 1 - 256

Example:

"prf_jane"

label_id

string[]

Return posts with these labels. Repeat the parameter to provide more than one label.

Required array length: 1 - 50 elements

Stable public label identifier.

Required string length: 1 - 256

Example:

["lbl_summer", "lbl_featured"]

label_match

enum<string>

Match any requested label (default) or require all requested labels. Requires label_id. Unknown labels are ignored for any; all returns no posts if any label is unknown. If no labels resolve, no posts are returned.

Available options:

any,

all

Example:

"any"

gallery_id

string

Return posts selected by this published gallery, newest first. Applies gallery filters but not pinned layout order.

Required string length: 1 - 256

Example:

"gal_summer"

product_ref

string

A Cevoid product or variant ID, provider-native ID, SKU, or barcode. Resolves within this workspace and market and selects the product family, including variants and existing tags. Unknown, ambiguous, or more than 100 candidate matches return an empty page; use a Cevoid product ID to disambiguate. Families with more than 1,000 product records return 400 with product_too_broad.

Required string length: 1 - 256

Example:

"gid://shopify/Product/123"

external_collection_id

string

Return posts containing products in this market-specific external collection.

Required string length: 1 - 256

Example:

"summer-sale"

cursor

string

Opaque cursor returned by the previous page. Keep all other query parameters unchanged.

Required string length: 1 - 2048

Example:

"eyJjcmVhdGVkQXQiOiIyMDI2LTA4LTAxVDEwOjAwOjAwLjAwMFoifQ"

limit

integer

default:20

Number of posts to return, from 1 to 50.

Required range: 1 <= x <= 50

Example:

20

Response

Successful response

data

object[]

required

Show child attributes

has_more

boolean

required

Whether another page is available.

Example:

true

next_cursor

string | null

required

Opaque cursor for the next page, or null when this is the final page.

Example:

"eyJwdWJsaXNoZWRBdCI6IjIwMjYtMDgtMDFUMTA6MDA6MDAuMDAwWiJ9"

List posts

curl --request GET \
  --url https://api.widget.cevoid.com/v1/posts \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.widget.cevoid.com/v1/posts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.widget.cevoid.com/v1/posts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.widget.cevoid.com/v1/posts"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.widget.cevoid.com/v1/posts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "pst_summerlook",
      "type": "IMAGE",
      "media": {
        "url": "https://cdn.cevoid.com/posts/pst_summerlook.jpg",
        "thumbnail_url": "https://cdn.cevoid.com/posts/pst_summerlook-thumbnail.jpg",
        "sprite_url": "https://cdn.cevoid.com/posts/pst_summerlook-sprite.jpg",
        "blurhash": "LEHV6nWB2yk8pyo0adR*.7kCMdnj",
        "aspect_ratio": 0.8,
        "duration_seconds": 12.5,
        "has_audio": false
      },
      "caption": "A summer favorite.",
      "hide_caption": false,
      "alt": "Person wearing a beige linen shirt outdoors.",
      "source_url": "https://www.instagram.com/p/example/",
      "author": {
        "name": "@jane",
        "avatar_url": "https://cdn.cevoid.com/profiles/prf_jane.jpg"
      },
      "tagged_products": [
        {
          "id": "prd_linen_shirt",
          "type": "PRODUCT",
          "title": "Linen Shirt",
          "url": "https://shop.example.com/products/linen-shirt",
          "image_url": "https://cdn.cevoid.com/products/linen-shirt.jpg",
          "price": {
            "min_amount": 59.95,
            "max_amount": 79.95,
            "currency": "SEK"
          },
          "x": 0.35,
          "y": 0.65
        }
      ],
      "published_at": "2026-08-01T10:00:00.000Z"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJwdWJsaXNoZWRBdCI6IjIwMjYtMDgtMDFUMTA6MDA6MDAuMDAwWiJ9"
}

{
  "status": 404,
  "code": "not_found",
  "message": "Resource not found",
  "additional_data": {},
  "request_id": "req_abc123"
}

{
  "status": 404,
  "code": "not_found",
  "message": "Resource not found",
  "additional_data": {},
  "request_id": "req_abc123"
}

{
  "status": 404,
  "code": "not_found",
  "message": "Resource not found",
  "additional_data": {},
  "request_id": "req_abc123"
}

{
  "status": 404,
  "code": "not_found",
  "message": "Resource not found",
  "additional_data": {},
  "request_id": "req_abc123"
}

{
  "status": 404,
  "code": "not_found",
  "message": "Resource not found",
  "additional_data": {},
  "request_id": "req_abc123"
}

{
  "status": 429,
  "code": "rate_limit_exceeded",
  "message": "Rate limit exceeded",
  "request_id": "req_abc123",
  "additional_data": {
    "retry_after_seconds": 1
  }
}

{
  "status": 404,
  "code": "not_found",
  "message": "Resource not found",
  "additional_data": {},
  "request_id": "req_abc123"
}

{
  "status": 404,
  "code": "not_found",
  "message": "Resource not found",
  "additional_data": {},
  "request_id": "req_abc123"
}

Introduction

Guides

UGC

Reviews

Authorizations

Query Parameters

Response