Posts

This endpoint is used to obtain the list of posts of a social profile.

Retrieve posts

Attention! Data schema in development. Results might change.

List of all posts in Asters for socialAccountId

POST https://api.asters.ai/external/posts/:socialAccountId

Call to retrieve all posts of a social account. It will be possible to search by:

— Page : Number that indicate page for pagination

— Labels : Array with list of identifiers. Labels associated with posts saved in Asters

— PostCollectionId : Identifier of post collections, useful to aggregate the posts published with same batch

---

The post url will be exported in two different forms:

— AstersLink : Only for Instagram Stories and other media files that are not available after 24h

— ProviderLink: All other cases

The Asters links are hosted on "AWS S3 Bucket on Frankfurt".

Path Parameters

Name	Type	Description
socialAccountId*	String	Identifier of social socialaccount
language*	String	Language of the description

Headers

Name	Type	Description
x-asters-token*	String	API Key generated in Asters for user authentication

Request Body

Name	Type	Description
page	String	Page id, if null returns first page
labels	Array<String>	List of label ids
postCollectionId	String	Identifier of post collections, useful to aggregate the posts published with same batch

200 Posts successfully recovered

{
    "results": [
        {
            "postCollectionId": "collectionID",
            "deleted": false,
            "_id": "65e1dbc760f52a866d219e01",
            "variantId": "x9cxj9",
            "data": {
                "firstComment": {
                    "text": "\nhttps://aste.rs/dPRk8SKHb",
                    "urls": [
                        {
                            "id": "dPRk8SKHb",
                            "shortUrl": "https://aste.rs/dPRk8SKHb",
                            "originalUrl": "www.google.it",
                            "shortened": true,
                            "utmConfig": {
                                "_id": "65e1dbc760f52a866d219e05"
                            },
                            "_id": "65e1dbc760f52a866d219e04"
                        }
                    ],
                    "_id": "65e1dbc760f52a866d219e03"
                },
                "text": "https://aste.rs/dAh-GsoFN\n\nText of our post\n\nhttps://aste.rs/dPRk8SKHb",
                "urls": [
                    {
                        "id": "dAh-GsoFN",
                        "shortUrl": "https://aste.rs/dAh-GsoFN",
                        "originalUrl": "https://www.amazon.com/?source=source&medium=medium&campaign=campaign&term=term&content=content",
                        "shortened": true,
                        "utmConfig": {
                            "source": "source",
                            "medium": "medium",
                            "campaign": "campaign",
                            "term": "term",
                            "content": "content",
                            "_id": "65e1dbc760f52a866d219e07"
                        },
                        "_id": "65e1dbc760f52a866d219e06"
                    },
                    {
                        "id": "dPRk8SKHb",
                        "shortUrl": "https://aste.rs/dPRk8SKHb",
                        "originalUrl": "www.google.it",
                        "shortened": true,
                        "utmConfig": {
                            "_id": "65e1dbc760f52a866d219e09"
                        },
                        "_id": "65e1dbc760f52a866d219e08"
                    }
                ],
                "medias": [
                        "metadata": {
                            "height": 300,
                            "width": 300,
                            "aspectRatio": "1:1",
                            "fileType": "image",
                            "extension": "gif",
                            "colorSpace": "srgb"
                        },
                        "deleted": false,
                        "_id": "65e21ee0be1429d5a82fdc7e",
                        "name": "64cb61be80375ed9c2088190/6516a948c2938fe873d4c6e8/zapier-uploads/6516a948c2938fe873d4c6e8/gx5tmqgiphy.gif?cid=790b761156h31ba3yp0wg4plkjivqenzrpcqht97wq59ignm&ep=v1_gifs_search&rid=giphy-1709317854678.gif",
                        "path": "6516a948c2938fe873d4c6e8/zapier-uploads/6516a948c2938fe873d4c6e8/gx5tmq",
                        "type": "file",
                        "mimetype": "image/gif",
                        "size": 1904081,
                        "tags": [],
                        "user": "64cb61be80375ed9c2088190",
                        "workspace": "6516a948c2938fe873d4c6e8",
                        "visible_name": "giphy.gif?cid=790b761156h31ba3yp0wg4plkjivqenzrpcqht97wq59ignm&ep=v1_gifs_search&rid=giphy.gif",
                        "updated_at": "2024-03-01T18:30:56.155Z",
                        "created_at": "2024-03-01T18:30:56.155Z",
                        "__v": 0,
                        "url": "https://asters.s3.eu-central-1.amazonaws.com/64cb61be80375ed9c2088190/6516a948c2938fe873d4c6e8/zapier-uploads/6516a948c2938fe873d4c6e8/gx5tmqgiphy.gif%3Fcid%3D790b761156h31ba3yp0wg4plkjivqenzrpcqht97wq59ignm%26ep%3Dv1_gifs_search%26rid%3Dgiphy-1709317854678.gif?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIA5OA4V6PRMWDFMS4B%2F20240308%2Feu-central-1%2Fs3%2Faws4_request&X-Amz-Date=20240308T141118Z&X-Amz-Expires=86400&X-Amz-Signature=52645bd3db13a7001e426d6b53919c365f5ae6468f720ba63e25f5404e91e67b&X-Amz-SignedHeaders=host&response-cache-control=No-cache&response-content-disposition=attachment%3B%20filename%3D%2264cb61be80375ed9c2088190%2F6516a948c2938fe873d4c6e8%2Fzapier-uploads%2F6516a948c2938fe873d4c6e8%2Fgx5tmqgiphy.gif%3Fcid%3D790b761156h31ba3yp0wg4plkjivqenzrpcqht97wq59ignm%26ep%3Dv1_gifs_search%26rid%3Dgiphy-1709317854678.gif%22"
                    }],
                "status": "draft",
                "_id": "65e1dbc760f52a866d219e01",
                "date": "2024-03-01T13:44:39.435Z",
                "media": {}
            },
            "info": {
                "account": {},
                "type": "STANDARD",
                "_id": "65e1dbc760f52a866d219e0a"
            },
            "user": "64cb61be80375ed9c2088190",
            "workspace": "6516a948c2938fe873d4c6e8",
            "publishDate": "2024-03-01T13:44:39.435Z",
            "creationDate": "2024-03-01T13:44:39.437Z",
            "__v": 0
        }
    ],
    "limit": 500000,
    "offset": 0,
    "page": 1,
    "totalPages": 1,
    "total": 27
}

401 Permission denied

500: Internal Server Error Internal server error

{
    // Response
}

Labels

List of all labels in a workspace

GET https://api.asters.ai/external/labels/:workspaceId

Returns labels in a workspace.

Path Parameters

Name	Type	Description
metricId*	String	Identifier of the metric requested

Headers

Name	Type	Description
x-asters-token*	String	API Key generated in Asters for user authentication

Request Body

Name	Type	Description
socialAccountId*	String	Social account id of the account
startDate*	Date	Start date of the metrics
endDate*	Date	End date of the metrics

200 Labels successfully recovered

[
    {
        "_id": "654500baea3749deffa6ce78",
        "name": "Blak friday",
        "workspaceId": "12hb3h21bhb1b1h",
        "userId": "12321hh3bh12bh21",
        "color": "black",
    },
     {
        "_id": "654500baea3749deffa6ce78",
        "name": "Christmas",
        "workspaceId": "12hb3h21bhb1b1h",
        "userId": "12321hh3bh12bh21",
        "color": "red",
    }
]

401 Permission denied

500: Internal Server Error Internal server error

{
    // Response
}