GET authors of an alert

GET /accounts/{account_id}/alerts/{alert_id}/authors

This method will allow you to fetch a list of alert authors, according to query string filters.

  • Parameters

    • account_id (string) - Id of the account
    • alert_id (number) - Id of the alert
  • Minimal curl example

curl -ig 'https://api.mention.net/api/accounts/{account_id}/alerts/{alert_id}/authors?kind=twitter&from=2016-01-14T00%3A00%3A00.0&to=2016-01-20T23%3A59%3A59.0&sort=score&order=desc&limit=3' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
    -H 'Accept-Version: 1.19'

Request Example

Keep in mind that the querystring must be url encoded.

  • Headers
Authorization: Bearer YOUR_ACCESS_TOKEN
Accept-Version: 1.19

Response 200 (application/json)

  • Body
{
    "authors": [
        { ... author ... },
        { ... author ... },
        ...
    ]
}

Author

{...author...}

{
    "id": "123456789_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "type": "people",
    "avatar": "https:\/\/pbs.twimg.com\/profile_images\/123456789\/aaaaaaaaaaaa_normal.jpeg",
    "name": "Name",
    "gender": "male",
    "influencer_score": 43.9,
    "email_fetched": false,
    "enriched": false,
    "main_author": {
        "id": "999999999",
        "author_unique_id": "twitter:user\/Name",
        "kind": "twitter",
        "url": "https:\/\/twitter.com\/Name",
        "name": "Name",
        "realname": "Name",
        "score": 44,
        "scored_id": "Name",
        "picture": "https:\/\/pbs.twimg.com\/profile_images\/123456789\/aaaaaaaaaaaa_normal.jpeg",
        "followers_count": 159389,
        "followings_count": 157358,
        "posts_count": 56586,
        "description": "Description on twitter",
        "topics": [
            "Algorithms",
            "Artificial Intelligence",
            "Data Analysis",
            "Data Science",
            "Internet of Things"
        ],
        "alert_id": "44444444444",
        "graphQLID": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "twitter_authors": [],
    "instagram_authors": [],
    "facebook_authors": [],
    "linkedin_authors": [],
    "permissions": {
        "can_follow": true,
        "can_send_message": true
    }
}