Smartgroups

Retrieve all smart groups

GETpeople/smartgroups

Retrieves a list of smart groups associated with your site.

Run in PostmanPostman is a useful developer tool for experimenting with and managing APIs that you work with

Definition

GET https://api.gosquared.com/people/v1/smartgroups

Example Request

curl "https://api.gosquared.com/people/v1/smartgroups?api_key=demo&site_token=GSN-106863-S" 

Live Responseundefined undefined

Your API Key is not authorised for this endpoint

Please fill in the required fields in the Query Builder

Retrieve a smart group

GETpeople/smartgroups/{groupID}

Retrieves a smart group by ID.

Path Parameters

groupID

StringRequired

The ID of the group

Run in PostmanPostman is a useful developer tool for experimenting with and managing APIs that you work with

Definition

GET https://api.gosquared.com/people/v1/smartgroups/{groupID}

Example Request

curl "https://api.gosquared.com/people/v1/smartgroups/{groupID}?api_key=demo&site_token=GSN-106863-S" 

Live Responseundefined undefined

Your API Key is not authorised for this endpoint

Please fill in the required fields in the Query Builder

Retrieve latest member count

GETpeople/smartgroups/{groupID}/count/latest

Retrieve latest sampled count of people in smart group.

Path Parameters

groupID

StringRequired

The ID of the group

Run in PostmanPostman is a useful developer tool for experimenting with and managing APIs that you work with

Definition

GET https://api.gosquared.com/people/v1/smartgroups/{groupID}/count/latest

Example Request

curl "https://api.gosquared.com/people/v1/smartgroups/{groupID}/count/latest?api_key=demo&site_token=GSN-106863-S" 

Live Responseundefined undefined

Your API Key is not authorised for this endpoint

Please fill in the required fields in the Query Builder

Retrieve counts of members over time

GETpeople/smartgroups/{groupID}/count/series

Retrieve count of people in smart group as time series.

Path Parameters

groupID

StringRequired

The ID of the group

Query String Parameters

from

String

The start date-time for the query

to

String

The end date-time for the query

Run in PostmanPostman is a useful developer tool for experimenting with and managing APIs that you work with

Definition

GET https://api.gosquared.com/people/v1/smartgroups/{groupID}/count/series

Example Request

curl "https://api.gosquared.com/people/v1/smartgroups/{groupID}/count/series?api_key=demo&site_token=GSN-106863-S" 

Live Responseundefined undefined

Your API Key is not authorised for this endpoint

Please fill in the required fields in the Query Builder

Retrieve a list of people in Smart Group

GETpeople/smartgroups/{groupID}/people

Retrieves the list of people in a given Smart Group. This function is the equivalent of mapping the Smart Group's 'filters' property to the Search People method.

Using the query parameter you can search through this smartgroup

Path Parameters

groupID

StringRequired

The ID of the group

Query String Parameters

query

String

The query term you would you like to search for

fields

String

A comma delimited list of fields to be returned. (e.g. id,email). See Property Types for available options.

sort

StringDefault Value: last.seen:desc

Which property to sort by followed by :desc or :asc for direction. See Property Types for available options.

presenter

StringDefault Value: plain

Accepted values: plain, csv

Modifies the response data structure

limit

StringDefault Value: 0,10

The maximum number of results e.g. 10 to return with an optional offset e.g. 5,10. You can request a maximum of 250 results

dateFormat

String

The format that any date parameters will be returned in. This takes any value permitted by Moment.

Run in PostmanPostman is a useful developer tool for experimenting with and managing APIs that you work with

Definition

GET https://api.gosquared.com/people/v1/smartgroups/{groupID}/people

Example Request

curl "https://api.gosquared.com/people/v1/smartgroups/{groupID}/people?api_key=demo&site_token=GSN-106863-S" 

Live Responseundefined undefined

Your API Key is not authorised for this endpoint

Please fill in the required fields in the Query Builder