List Watched Brand Emails

GET

api

gallery

watchlist

emails

List Watched Brand Emails

curl --request GET \
  --url https://api.sequenzy.com/api/v1/gallery/watchlist/emails \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.sequenzy.com/api/v1/gallery/watchlist/emails', 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.sequenzy.com/api/v1/gallery/watchlist/emails",
  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.sequenzy.com/api/v1/gallery/watchlist/emails"

	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.sequenzy.com/api/v1/gallery/watchlist/emails")

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

{
  "success": true,
  "emails": [
    {
      "id": "em_51kd",
      "subject": "Introducing Linear Asks",
      "preheader": "Turn requests from Slack into issues",
      "type": "product_update",
      "subtype": "feature_announcement",
      "sentAt": "2026-10-03T16:05:00.000Z",
      "collectedAt": "2026-10-03T21:40:00.000Z",
      "analysis": null,
      "brand": { "name": "Linear", "domain": "linear.app", "slug": "linear" },
      "url": "https://sequenzy.com/email-examples/brands/linear/emails/introducing-linear-asks"
    }
  ],
  "nextCursor": "2026-10-03T16:05:00.000Z_em_51kd"
}

{
  "error": "since must be an ISO 8601 date, like 2026-10-01T00:00:00Z"
}

{
  "error": "Invalid API key"
}

{
  "error": "API key is missing required scope: templates:read"
}

List emails from the brands your company watches, newest sent first, a page at a time. This is the feed on the dashboard’s Competitors page. Emails usually arrive a few hours after they are sent, and since matches the send time. When you poll, set since about a day before your last check and skip emails whose id you have already seen. Each email’s url also works as the url of Create Template from Example, to remix it for your brand. Requires the templates:read scope.

Query parameters

string

Only this watched brand, by website or domain, such as linear.app. A brand you don’t watch returns an empty list.

string

Only emails sent at or after this ISO 8601 date or time, such as 2026-10-01 or 2026-10-01T00:00:00Z.

integer

default:"24"

Emails per page, 1 to 60.

string

nextCursor from the previous page, for older emails. Pages don’t shift when new emails arrive while you page.

curl "https://api.sequenzy.com/api/v1/gallery/watchlist/emails?since=2026-10-01&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

object[]

Emails from your watched brands, newest sent first.

Show properties

string

Email ID.

string | null

Subject line.

string | null

Preview text.

string | null

Email type, such as promotional, lifecycle or product_update.

string | null

Email subtype, such as feature_announcement or win_back.

string

When the brand sent it (ISO 8601).

string

When the gallery received it (ISO 8601).

object | null

The email’s breakdown, the same as in List Email References. null until it has been analyzed.

object

The brand’s name, domain and slug.

string

The email’s gallery page.

string | null

Pass as cursor for the next page. null on the last page.

{
  "success": true,
  "emails": [
    {
      "id": "em_51kd",
      "subject": "Introducing Linear Asks",
      "preheader": "Turn requests from Slack into issues",
      "type": "product_update",
      "subtype": "feature_announcement",
      "sentAt": "2026-10-03T16:05:00.000Z",
      "collectedAt": "2026-10-03T21:40:00.000Z",
      "analysis": null,
      "brand": { "name": "Linear", "domain": "linear.app", "slug": "linear" },
      "url": "https://sequenzy.com/email-examples/brands/linear/emails/introducing-linear-asks"
    }
  ],
  "nextCursor": "2026-10-03T16:05:00.000Z_em_51kd"
}

{
  "error": "since must be an ISO 8601 date, like 2026-10-01T00:00:00Z"
}

{
  "error": "Invalid API key"
}

{
  "error": "API key is missing required scope: templates:read"
}

A 400 also means domain is not a website or cursor is not one this endpoint returned. A 422 means limit is outside 1 to 60.

List Watched Brand Emails

curl --request GET \
  --url https://api.sequenzy.com/api/v1/gallery/watchlist/emails \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.sequenzy.com/api/v1/gallery/watchlist/emails', 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.sequenzy.com/api/v1/gallery/watchlist/emails",
  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.sequenzy.com/api/v1/gallery/watchlist/emails"

	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.sequenzy.com/api/v1/gallery/watchlist/emails")

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

{
  "success": true,
  "emails": [
    {
      "id": "em_51kd",
      "subject": "Introducing Linear Asks",
      "preheader": "Turn requests from Slack into issues",
      "type": "product_update",
      "subtype": "feature_announcement",
      "sentAt": "2026-10-03T16:05:00.000Z",
      "collectedAt": "2026-10-03T21:40:00.000Z",
      "analysis": null,
      "brand": { "name": "Linear", "domain": "linear.app", "slug": "linear" },
      "url": "https://sequenzy.com/email-examples/brands/linear/emails/introducing-linear-asks"
    }
  ],
  "nextCursor": "2026-10-03T16:05:00.000Z_em_51kd"
}

{
  "error": "since must be an ISO 8601 date, like 2026-10-01T00:00:00Z"
}

{
  "error": "Invalid API key"
}

{
  "error": "API key is missing required scope: templates:read"
}

​Query parameters

​Response

Query parameters

Response