GET v1.1/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.1/authors/f:1563548099**	A Conversocial author "id"	None	URL	True
fields	Specify data about the author to return. e.g **_v1.1/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.1/authors/f:1563548099"
{
    "author": {
        "id": "f:1563548099",
        "url": "https://api.conversocial.com/v1.1/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.1/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.1/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.1/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.1/authors?id=f:1563548099,f:197845138"
{
    "authors": [
        {
            "id": "f:1563548099",
            "url": "https://api.conversocial.com/v1.1/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.1/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"
        }
    ]
}