List insights

GET

insights

List insights

curl --request GET \
  --url https://api.opennous.cloud/v2/insights \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.opennous.cloud/v2/insights', 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.opennous.cloud/v2/insights",
  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.opennous.cloud/v2/insights"

	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.opennous.cloud/v2/insights")

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

{
  "insights": [
    {
      "id": "5d0c2b7e-1f3a-4c8d-9e6b-2a7f4c1d8e30",
      "lane": "product",
      "subtype": "feature",
      "content": "Wants CRM sync to write call notes back to HubSpot.",
      "quote": "If it doesn't land in HubSpot, my reps won't see it.",
      "speaker": "Sarah Chen",
      "account": {
        "entity_id": "3e7a1d52-8c4b-4b9e-a0f3-6d2c9e8b7a15",
        "name": "Acme"
      },
      "source_ref": "source://fireflies/01J8ZK2",
      "occurred_at": "2026-09-24T15:00:00Z",
      "tags": [
        "CRM integration"
      ]
    }
  ],
  "limit": 50,
  "offset": 0,
  "has_more": false,
  "taxonomy": {
    "lanes": [
      {
        "key": "product",
        "label": "Product"
      },
      {
        "key": "sales",
        "label": "Sales"
      },
      {
        "key": "success",
        "label": "Customer success"
      },
      {
        "key": "market",
        "label": "Market"
      }
    ],
    "subtypes": [
      {
        "key": "bug",
        "lane": "product",
        "label": "Bug",
        "definition": "something in our product is broken or fails"
      },
      {
        "key": "friction",
        "lane": "product",
        "label": "Friction",
        "definition": "it works, but it is manual, slow, clunky or confusing to use"
      },
      {
        "key": "feature",
        "lane": "product",
        "label": "Feature request",
        "definition": "they want a capability we do not have"
      },
      {
        "key": "objection",
        "lane": "sales",
        "label": "Objection",
        "definition": "a reason the buyer gives against buying, switching or renewing with us, other than price"
      },
      {
        "key": "pricing",
        "lane": "sales",
        "label": "Pricing",
        "definition": "cost, fees, per-use charges, discounts, value for money"
      },
      {
        "key": "pitch",
        "lane": "sales",
        "label": "Pitch & messaging",
        "definition": "the buyer misunderstood or questioned what we are or do, or reacted to how we framed it"
      },
      {
        "key": "setup",
        "lane": "success",
        "label": "Setup",
        "definition": "getting it running: install, integrations to switch on, logins, access, provisioning"
      },
      {
        "key": "training",
        "lane": "success",
        "label": "Training & adoption",
        "definition": "staff not using it, needing training, materials, champions or follow-up"
      },
      {
        "key": "partners",
        "lane": "market",
        "label": "Competitors & partners",
        "definition": "other vendors and incumbent tools, partners, and the rules they set"
      },
      {
        "key": "buyers",
        "lane": "market",
        "label": "Who buys",
        "definition": "roles, decision makers, customer segments and how customers operate"
      }
    ]
  }
}

What customers said about your product, sales, success, and market, tied to the account that said it. This is the same set the Insights board in the app shows. Only sorted insights linked to an account appear, newest first. Lines your own team said are left out. Each insight has one lane (who has to act) and one subtype (what kind of work). The response carries the workspace’s taxonomy, so you can label results without hardcoding it.

Lane	Subtype	Label	Covers
`product`	`bug`	Bug	Something in the product is broken or fails.
`product`	`friction`	Friction	It works, but it is manual, slow, clunky, or confusing.
`product`	`feature`	Feature request	A capability you do not have.
`sales`	`objection`	Objection	A reason against buying, switching, or renewing, other than price.
`sales`	`pricing`	Pricing	Cost, fees, discounts, value for money.
`sales`	`pitch`	Pitch & messaging	The buyer misunderstood or questioned what you do or how you framed it.
`success`	`setup`	Setup	Getting it running. Install, integrations, logins, access.
`success`	`training`	Training & adoption	Staff not using it, or needing training or follow-up.
`market`	`partners`	Competitors & partners	Other vendors, incumbent tools, partners. Know, don’t fix.
`market`	`buyers`	Who buys	Roles, decision makers, segments. Know, don’t fix.

Service businesses get service labels on the same keys. For example bug reads “Missed results” and feature reads “Service request”. Read taxonomy for the labels your workspace uses. New insights reach the board once they are sorted. Until then they do not appear here.

Authorizations

Authorization

string

header

required

Workspace API key. Create one in Settings → API keys.

Query Parameters

lane

enum<string>

Who has to act.

Available options:

product,

sales,

success,

market

subtype

enum<string>

What kind of work. Must belong to lane when both are set.

Available options:

bug,

friction,

feature,

objection,

pricing,

pitch,

setup,

training,

partners,

buyers

focus

string

Only insights from one account. Email, LinkedIn URL, domain, or entity UUID. A bare name returns 400.

since

string<date>

Only insights on or after this ISO date, for example 2026-09-01.

limit

integer

default:50

Page size.

Required range: 1 <= x <= 200

offset

integer

default:0

Rows to skip.

Required range: x >= 0

Response

A page of insights and the workspace taxonomy.

insights

object[]

Show child attributes

limit

integer

offset

integer

has_more

boolean

taxonomy

object

Show child attributes

List insights

curl --request GET \
  --url https://api.opennous.cloud/v2/insights \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.opennous.cloud/v2/insights', 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.opennous.cloud/v2/insights",
  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.opennous.cloud/v2/insights"

	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.opennous.cloud/v2/insights")

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

{
  "insights": [
    {
      "id": "5d0c2b7e-1f3a-4c8d-9e6b-2a7f4c1d8e30",
      "lane": "product",
      "subtype": "feature",
      "content": "Wants CRM sync to write call notes back to HubSpot.",
      "quote": "If it doesn't land in HubSpot, my reps won't see it.",
      "speaker": "Sarah Chen",
      "account": {
        "entity_id": "3e7a1d52-8c4b-4b9e-a0f3-6d2c9e8b7a15",
        "name": "Acme"
      },
      "source_ref": "source://fireflies/01J8ZK2",
      "occurred_at": "2026-09-24T15:00:00Z",
      "tags": [
        "CRM integration"
      ]
    }
  ],
  "limit": 50,
  "offset": 0,
  "has_more": false,
  "taxonomy": {
    "lanes": [
      {
        "key": "product",
        "label": "Product"
      },
      {
        "key": "sales",
        "label": "Sales"
      },
      {
        "key": "success",
        "label": "Customer success"
      },
      {
        "key": "market",
        "label": "Market"
      }
    ],
    "subtypes": [
      {
        "key": "bug",
        "lane": "product",
        "label": "Bug",
        "definition": "something in our product is broken or fails"
      },
      {
        "key": "friction",
        "lane": "product",
        "label": "Friction",
        "definition": "it works, but it is manual, slow, clunky or confusing to use"
      },
      {
        "key": "feature",
        "lane": "product",
        "label": "Feature request",
        "definition": "they want a capability we do not have"
      },
      {
        "key": "objection",
        "lane": "sales",
        "label": "Objection",
        "definition": "a reason the buyer gives against buying, switching or renewing with us, other than price"
      },
      {
        "key": "pricing",
        "lane": "sales",
        "label": "Pricing",
        "definition": "cost, fees, per-use charges, discounts, value for money"
      },
      {
        "key": "pitch",
        "lane": "sales",
        "label": "Pitch & messaging",
        "definition": "the buyer misunderstood or questioned what we are or do, or reacted to how we framed it"
      },
      {
        "key": "setup",
        "lane": "success",
        "label": "Setup",
        "definition": "getting it running: install, integrations to switch on, logins, access, provisioning"
      },
      {
        "key": "training",
        "lane": "success",
        "label": "Training & adoption",
        "definition": "staff not using it, needing training, materials, champions or follow-up"
      },
      {
        "key": "partners",
        "lane": "market",
        "label": "Competitors & partners",
        "definition": "other vendors and incumbent tools, partners, and the rules they set"
      },
      {
        "key": "buyers",
        "lane": "market",
        "label": "Who buys",
        "definition": "roles, decision makers, customer segments and how customers operate"
      }
    ]
  }
}

Overview

People

Accounts

Deals

Notes

Attention

Insights

Enrich & score

Organization

Workflows

Webhooks

Usage

Authorizations

Query Parameters

Response