Get Discovery

Returns the discovery data including results if the discovery is completed.

The discovery must have been created by or shared with the user querying it.

Getting Started

URL REQUEST (GET)

https://api.statsocial.com/platform/v0/discoveries/{discovery_id}

Path Parameters

Parameter	Type	Description
discovery_id	integer	The ID of the discovery to retrieve

Query Parameters

Parameter	Type	Default	Description
page	integer	1	Page number for paginated results

Let's go to example

In this example we retrieve the discovery we created earlier.

URL REQUEST (GET)

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

We will receive a json like this:

{
    "response": {
        "id": 123,
        "name": "My Creator Discovery",
        "status": "finished",
        "entity_type": "creators",
        "type": "shared_audience",
        "results": [
            {
                "name": "Creator Name",
                "handle": "@creatorhandle",
                "followers": 150000,
                "network": "instagram"
            }
        ]
    },
    "information": {
        "version": "0.0.1"
    }
}

Using Pagination

For discoveries with many results, use the page query parameter:

URL REQUEST (GET)

https://api.statsocial.com/platform/v0/discoveries/123?page=2

This will return the second page of results.