List Discoveries

Returns a list of all discoveries created by or shared with the authenticated user.

Getting Started

URL REQUEST (GET)

https://api.statsocial.com/platform/v0/discoveries

We will receive a json like this:

{
    "response": {
        "discoveries": [
            {
                "id": 123,
                "name": "My Creator Discovery",
                "ss_ids_key": "/uploads/2024-01-15/078ace94fad569f01d1a3a99a440cf5c.ssid",
                "entity_type": "creators",
                "type": "shared_audience",
                "audience_id": 12345,
                "networks": {
                    "tik_tok": true,
                    "instagram": true,
                    "youtube": false,
                    "twitter": false,
                    "bluesky": false
                },
                "followers_min": 10000,
                "followers_max": 1000000,
                "gender": "female",
                "country": ["US", "UK"],
                "age": ["18-24", "25-34"],
                "status": "finished",
                "createdBy": 1,
                "updatedBy": 1,
                "createdAt": "2024-01-15T10:30:00Z",
                "updatedAt": "2024-01-15T10:35:00Z"
            },
            {
                "id": 124,
                "name": "Sports Creators Discovery",
                "ss_ids_key": "sports",
                "entity_type": "creators",
                "type": "topic",
                "audience_id": null,
                "networks": {
                    "tik_tok": false,
                    "instagram": true,
                    "youtube": true,
                    "twitter": false,
                    "bluesky": false
                },
                "followers_min": 50000,
                "followers_max": null,
                "gender": "male",
                "country": ["US"],
                "status": "running",
                "createdBy": 1,
                "updatedBy": 1,
                "createdAt": "2024-01-16T08:00:00Z",
                "updatedAt": "2024-01-16T08:00:00Z"
            }
        ]
    },
    "information": {
        "version": "0.0.1"
    }
}

Response Fields

Field	Type	Description
id	integer	Unique identifier for the discovery
name	string	Name given to the discovery
ss_ids_key	string	The SS ID key or topic used
entity_type	string	Type of entities: creators, brands, or media
type	string	Discovery type: audience, topic, or shared_audience
audience_id	integer	Associated audience ID (if applicable)
networks	object	Networks enabled for this discovery
followers_min	integer	Minimum follower count filter
followers_max	integer	Maximum follower count filter (if set)
gender	string	Gender filter applied
country	array	Country filters applied
age	array	Age range filters applied
status	string	Current status: queued, running, finished, or failed
createdBy	integer	User ID who created the discovery
createdAt	string	ISO 8601 timestamp of creation
updatedAt	string	ISO 8601 timestamp of last update