GET v1.3/authors/:id

Information about a single Social Media author e.g. a Twitter, Youtube or Instagram user This resource supports specifying returned metadata through the fields parameter

Parameters

Label	Description	Values	Modifiers	Type	Required
id	The unique id of an account or accounts to access. e.g _v1.3/authors/f:1563548099	A Conversocial author "id"	None	URL	True
fields	Specify data about the author to return. e.g v1.3/authors?fields=id,url,platform,platform_id,screen_names	id, url, platform, platform_id, screen_name, real_name, location, website, description, profile_picture, profile_link	None	Query string	False

Examples

Basic Example

> curl -u username:password "https://api.conversocial.com/v1.3/authors/f:1563548099"
{
    "author": {
        "id": "f:1563548099",
        "url": "https://api.conversocial.com/v1.3/authors/f:1563548099",
        "platform": "facebook",
        "platform_id": "1563548099",
        "screen_name": "james.a.doppelganger",
        "real_name": "James Andres Doppelganger",
        "location": "en_US",
        "website": null,
        "description": null,
        "profile_picture": "https://graph.facebook.com/1563548099/picture?type=square",
        "profile_link": "http://www.facebook.com/james.a.doppelganger"
    }
}

GET v1.3/authors

Information about multiple Social Media authors (e.g. a Twitter, Youtube or Instagram users) specified by ID. This resource supports specifying returned metadata through the fields parameter

Parameters

Label	Description	Values	Modifiers	Type	Required
id	List of unique __id__s of accounts to retrieve. e.g v1.3/authors?id=f:1563548099,f:197845138	A comma separates list of Conversocial author "id"s	None	Query string	True
fields	Specify data about the author to return. e.g v1.3/authors?fields=id,url,platform,platform_id,screen_names	id, url, platform, platform_id, screen_name, real_name, location, website, description, profile_picture, profile_link	None	Query string	False

Examples

Basic Example

> curl -u username:password "https://api.conversocial.com/v1.3/authors?id=f:1563548099,f:197845138"
{
    "authors": [
        {
            "id": "f:1563548099",
            "url": "https://api.conversocial.com/v1.3/authors/f:1563548099",
            "platform": "facebook",
            "platform_id": "1563548099",
            "screen_name": "james.a.doppelganger",
            "real_name": "James Andres Doppelganger",
            "location": "en_US",
            "website": null,
            "description": null,
            "profile_picture": "https://graph.facebook.com/1563548099/picture?type=square",
            "profile_link": "http://www.facebook.com/james.a.doppelganger"
        },
        {
            "id": "f:197845138",
            "url": "https://api.conversocial.com/v1.3/authors/f:197845138",
            "platform": "facebook",
            "platform_id": "197845138",
            "screen_name": "madeup.user",
            "real_name": "Madeup User",
            "location": "en_US",
            "website": null,
            "description": null,
            "profile_picture": "https://graph.facebook.com/197845138/picture?type=square",
            "profile_link": "http://www.facebook.com/197845138"
        }
    ]
}