Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

OverviewGetting startedWhat is Saasco?

SDK

Quick startTrackingIdentifyConfigurationWidgetsProperties

MCP

Quick startHow it worksAuthorizationTool reference

REST API

Quick start
getGet Social Proof ConfigputUpdate Social Proof ConfiggetGet Social Proof Widget EnabledpatchUpdate Social Proof Widget EnabledpostUpsert Social Proof TemplatedelDelete Social Proof TemplategetGet Social Proof StatsgetGet Social Proof Stats Timeseries
Social Proof

Get Social Proof Config

Reads the social proof widget: enabled flag, feed window, theme, display rules, and templates. Creates the config row on first read.

GET
/projects/{projectId}/social-proof

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

projectIdrequiredstring

ID of the project whose widget config to fetch.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://www.saasco.com/api/v2/projects/string/social-proof"
{
  "enabled": false,
  "theme": {
    "desktop": {
      "accentColor": "string",
      "backgroundColor": "string",
      "cornerRadius": 16,
      "imagePadding": 0,
      "linkColor": "string",
      "outlineColor": "string",
      "shadow": true,
      "textColor": "string"
    },
    "hoverAnimation": "none",
    "mobile": {
      "accentColor": "string",
      "backgroundColor": "string",
      "cornerRadius": 16,
      "imagePadding": 0,
      "linkColor": "string",
      "outlineColor": "string",
      "shadow": true,
      "textColor": "string"
    },
    "position": "bottom-left",
    "mobilePosition": "top",
    "showTimestamp": true,
    "timestampMaxAgeHours": 4
  },
  "display": {
    "displayDurationSeconds": 4,
    "hideOnDesktop": false,
    "hideOnMobile": false,
    "initialDelaySeconds": 5,
    "intervalSeconds": 15,
    "maxPerPage": 5,
    "maxPerSession": 100,
    "pageRules": []
  },
  "maxEventAgeHours": 24,
  "templates": [
    {
      "name": "string",
      "action": "string",
      "template": "string",
      "imageUrl": "http://example.com",
      "fallbackImageUrl": "http://example.com",
      "linkUrl": "http://example.com",
      "linkToEvent": false,
      "enabled": true,
      "position": 0,
      "eventRules": [],
      "id": "string"
    }
  ]
}
{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}
{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}
{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}
{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

Get Top Shortlinks

Ranks every short link in the project by clicks in the window, including links with zero clicks.

Update Social Proof Config

Replaces the widget's enabled flag, feed window, theme, and display rules. Templates are saved separately.