Product Intelligence Export

GET

product-intelligence

Export product-feature intelligence

curl --request GET \
  --url https://app.usehindsight.com/api/v1/product-intelligence \
  --header 'Authorization: Bearer <token>'

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

fetch('https://app.usehindsight.com/api/v1/product-intelligence', 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://app.usehindsight.com/api/v1/product-intelligence",
  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://app.usehindsight.com/api/v1/product-intelligence"

	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://app.usehindsight.com/api/v1/product-intelligence")

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": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "deal_id": "<string>",
      "feature_id": "<string>",
      "influence_summary": "<string>",
      "sentiment": true,
      "tags": [
        "<string>"
      ],
      "features": {},
      "deals": {}
    }
  ],
  "meta": {}
}

{
  "error": {
    "code": "bad_request",
    "message": "Invalid parameters",
    "details": {
      "missing_fields": [
        "file_name"
      ]
    }
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "Your role (member) does not have permission to perform this action."
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Please retry after the reset time in the response headers."
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "An unexpected error occurred"
  }
}

Export individual product-feature requests with their original analysis, associated feature, deal, and customer context. Each row represents one feature-to-deal association, making it suitable for downstream clustering and product-request analysis.

Copy for AI context

GET https://app.usehindsight.com/api/v1/product-intelligence
Authorization: Bearer YOUR_API_KEY

Optional query parameters:
  date_from: string (ISO 8601 association timestamp, inclusive)
  date_to: string (ISO 8601 association timestamp, inclusive)
  sentiment: "positive" | "negative" | "neutral"
  tags: string (comma-separated tags, or repeat this parameter; all specified tags must match)
  product: string (exact feature product)
  product_area: string (exact feature product area)

200 Response:
{
  "data": [
    {
      "id": "dfa_123",
      "created_at": "2026-09-01T12:00:00Z",
      "deal_id": "deal_123",
      "feature_id": "feature_123",
      "influence_summary": "The buyer needs SSO provisioning before they can move forward.",
      "sentiment": false,
      "tags": ["security", "must-have"],
      "features": {
        "id": "feature_123",
        "name": "SCIM provisioning",
        "description": "Automated user lifecycle management.",
        "product": "Platform",
        "product_area": "Identity"
      },
      "deals": {
        "id": "deal_123",
        "name": "Acme Enterprise",
        "salesforce_id": "006xxxxxxxxxxxx",
        "hubspot_id": "123456789",
        "status": "Negotiation",
        "amount": 50000,
        "close_date": "2026-10-15T00:00:00Z",
        "created_at": "2026-06-01T12:00:00Z",
        "updated_at": "2026-09-01T12:00:00Z",
        "clients": {
          "id": "client_123",
          "name": "Acme Corp",
          "salesforce_id": "001xxxxxxxxxxxx",
          "hubspot_id": "987654321",
          "industry": "Software",
          "website_url": "https://acme.example"
        }
      }
    }
  ],
  "meta": {
    "count": 1,
    "sentiment": null,
    "date_from": null,
    "date_to": null,
    "tags": [],
    "product": null,
    "product_area": null
  }
}

Rate limits: Organization-wide limits apply.

Overview

This endpoint returns the raw influence_summary for each feature association alongside CRM IDs and account context. It does not aggregate by feature, so a single feature requested in multiple deals appears as multiple rows. When no filters are supplied, the response contains all product-feature associations available to the API key’s organization, regardless of sentiment.

Filters

Parameter	Type	Description	Example
`date_from`	string	Inclusive ISO 8601 lower bound for the association’s `created_at` timestamp	`2026-01-01`
`date_to`	string	Inclusive ISO 8601 upper bound for the association’s `created_at` timestamp	`2026-03-31T23:59:59Z`
`sentiment`	string	`positive`, `negative`, or `neutral`. Omit to return all sentiments. `neutral` returns associations with no sentiment recorded.	`negative`
`tags`	string	Comma-separated tags, or repeat the parameter. A row must contain every supplied tag.	`security,must-have`
`product`	string	Exact feature product	`Platform`
`product_area`	string	Exact feature product area	`Identity`

Examples:

# All product intelligence for the organization
curl https://app.usehindsight.com/api/v1/product-intelligence \
  -H "Authorization: Bearer YOUR_API_KEY"

# Negative identity feedback created this quarter
curl --get https://app.usehindsight.com/api/v1/product-intelligence \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "date_from=2026-07-01" \
  --data-urlencode "sentiment=negative" \
  --data-urlencode "product_area=Identity"

# Requests carrying both tags
curl --get https://app.usehindsight.com/api/v1/product-intelligence \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "tags=security,must-have"

Response fields

Field	Description
`influence_summary`	Raw feature-request or feature-impact summary extracted from the deal.
`sentiment`	`true` for positive, `false` for negative, or `null` when neutral/unspecified.
`tags`	Tags assigned to this feature association in this deal.
`features`	The associated Hindsight feature, including product taxonomy.
`deals.salesforce_id`	Salesforce Opportunity ID, when synced.
`deals.hubspot_id`	HubSpot Deal ID, when synced.
`deals.amount`	Deal value/ARR, when recorded.
`deals.close_date`	The deal’s expected or actual close date.
`deals.clients.salesforce_id`	Salesforce Account ID, when synced.
`deals.clients.hubspot_id`	HubSpot Company ID, when synced.

The endpoint returns a complete result set rather than a paginated collection. For especially large workspaces, narrow the result with the available filters.

Authorizations

Authorization

string

header

required

API key from Hindsight Settings → API keys. Use Authorization: Bearer YOUR_API_KEY. Newly created keys begin with hs_; existing keys remain supported until rotated or expired.

Query Parameters

date_from

string<date-time>

Inclusive ISO 8601 lower bound for the association creation timestamp.

date_to

string<date-time>

Inclusive ISO 8601 upper bound for the association creation timestamp.

sentiment

enum<string>

Filter association sentiment. Omit to return all sentiments.

Available options:

positive,

negative,

neutral

Response

Product-feature associations and applied filters.

data

object[]

required

Show child attributes

meta

object

required

Export product-feature intelligence

curl --request GET \
  --url https://app.usehindsight.com/api/v1/product-intelligence \
  --header 'Authorization: Bearer <token>'

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

fetch('https://app.usehindsight.com/api/v1/product-intelligence', 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://app.usehindsight.com/api/v1/product-intelligence",
  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://app.usehindsight.com/api/v1/product-intelligence"

	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://app.usehindsight.com/api/v1/product-intelligence")

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": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "deal_id": "<string>",
      "feature_id": "<string>",
      "influence_summary": "<string>",
      "sentiment": true,
      "tags": [
        "<string>"
      ],
      "features": {},
      "deals": {}
    }
  ],
  "meta": {}
}

{
  "error": {
    "code": "bad_request",
    "message": "Invalid parameters",
    "details": {
      "missing_fields": [
        "file_name"
      ]
    }
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "Your role (member) does not have permission to perform this action."
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Please retry after the reset time in the response headers."
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "An unexpected error occurred"
  }
}

Overview

Get Started

MCP

Security & Compliance

REST API

Integrations

Release Notes

Product Intelligence Export

Overview

Filters

Response fields

Authorizations

Query Parameters

Response

​Overview

​Filters

​Response fields

Authorizations

Query Parameters

Response

Overview

Filters

Response fields