---
updatedAt: 2026-05-13T09:04:03.000Z
---
# Get author(s) by network handle
Get one or more authors by the `networkhandle` passed in for the specified source channel
## Details
Returns one or more authors by the `networkhandle` passed in for the specified source channel.
Because handles and user names are not globally unique across a source channel, this call can return more than one unrelated author.
If more than one author is returned they will be contained in a `personList`, each with a unique top-level ID and `handles` array.
Use this for a `networktype` of "facebook", or "instagram" where there is a single, default instance of the network. If the `networktype` is "lithium" or "crm", where there can be multiple instances of the network, use: `/api/v2/authors/networks/networktype/instances/networkinstance/handles/networkhandle`
# Related endpoints
| Action | Endpoint |
| ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| GET | [/authors/networks/{networktype}/ids/{networkid}](https://developer.khoros.com/khoroscaredevdocs/reference/authorsnetworksnetworktypeidsnetworkid)
Get a single author by source network ID where the source network has only a single, default instance, such as Facebook or Instagram |
| PUT | [/authors/networks/{networktype}/ids/{networkid}](https://developer.khoros.com/khoroscaredevdocs/reference/authorsnetworksnetworktypeidsnetworkid-1)
Update a single author by source network ID on the default instance of the source network |
| GET | [/authors/networks/{networktype}/instances/{networkinstance}/ids/{networkid}](https://developer.khoros.com/khoroscaredevdocs/reference/authorsnetworksnetworktypeinstancesnetworkinstancehandlesnetworkhandle)
Return one or more authors by the `networkhandle` passed in for the specified instance of a network. |
| PUT | [/authors/networks/{networktype}/instances/{networkinstance}/ids/{networkid}](https://developer.khoros.com/khoroscaredevdocs/reference/authorsnetworksnetworktypeinstancesnetworkinstanceidsnetworkid-2)
Update a single author by network ID on a specific instance of that network |
| GET | [/authors/networks/{networktype}/instances/{networkinstance}/handles/{networkhandle}](https://developer.khoros.com/khoroscaredevdocs/reference/authorsnetworksnetworktypeinstancesnetworkinstancehandlesnetworkhandle)
Returns one or more authors by the networkhandle passed in for the specified instance of a network. |
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "author-api-v2",
"version": "1.1"
},
"servers": [
{
"url": "https://{instance}.response.lithium.com/api/v2/authors",
"variables": {
"instance": {
"default": "instance"
}
}
}
],
"security": [
{}
],
"paths": {
"/networks/{networktype}/handles/{networkhandle}": {
"get": {
"summary": "Get author(s) by network handle",
"description": "Get one or more authors by the `networkhandle` passed in for the specified source channel",
"operationId": "authorsnetworks_networktype_handles_networkhandle",
"parameters": [
{
"name": "networktype",
"in": "path",
"description": "The type of network that manages content created by or about an author. Supported values are: \"instagram\", \"facebook\", \"googleplus\", \"lithium\", \"crm\"
For a `networktype` of value \"lithium\" or \"crm\" you must also pass the `networkinstance`, because these types of networks can have multiple instances as opposed to Instagram, Facebook, or Google+ that have only a single, default network.
The Author API supports \"instagram\", \"facebook\", \"googleplus\", \"lithium\", and \"crm\" only as values for `networktype`.",
"schema": {
"type": "string"
},
"required": true
},
{
"name": "networkhandle",
"in": "path",
"description": "The external identification for the author, such as a Community or a Instagram handle. This is different than the `networkid` generated by a network for internal use. Note that `networkhandle` is not used with Facebook in POST calls.",
"schema": {
"type": "string"
},
"required": true
},
{
"name": "include_deleted_crm",
"in": "query",
"description": "When `true`, the response includes authors whose CRM entry has been deleted. Otherwise, the response will not include authors whose CRM entry has been deleted.",
"schema": {
"type": "boolean",
"default": false
}
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"status\": \"success\",\n \"data\": [\n {\n \"id\": \"2134086e-9024-4c3b-ab3b-afc6a36ea61c\",\n \"displayNumber\": 13366,\n \"handles\": {\n \"external\": [\n {\n \"@class\": \"ExternalSpecificAuthorData\",\n \"lswUuid\": \"edce6d32-ee19-4740-87b8-a9b69afd677d\",\n \"displayNumber\": 77285,\n \"profileUrl\": \"\",\n \"id\": \"73292839-fb73-4b2c-b7b6-32db4b2f855a\",\n \"name\": \"Anusuya_user\",\n \"screenName\": \"Anusuya_user\",\n \"providerInstanceId\": \"smooch\",\n \"profileImageURL\": \"http://pbs.twimg.com/profile_images/768361121761722368/5yZ2HHxu_normal.jpg\",\n \"networkinstance\": \"smooch\",\n \"avatarUrl\": \"http://pbs.twimg.com/profile_images/768361121761722368/5yZ2HHxu_normal.jpg\"\n }\n ],\n \"twitter\": [\n {\n \"@class\": \"TwitterSpecificAuthorData\",\n \"lswUuid\": \"73292839-fb73-4b2c-b7b6-32db4b2f855a\",\n \"displayNumber\": 12833,\n \"profileUrl\": \"http://twitter.com/anusuya_user\",\n \"id\": \"768360234377064449\",\n \"location\": \"India\",\n \"name\": \"Anusuya_user\",\n \"screenName\": \"anusuya_user\",\n \"following\": 5,\n \"followers\": 5,\n \"verified\": false,\n \"joinDate\": 1472026330163,\n \"updatesCount\": 194,\n \"languages\": \"en\",\n \"timezone\": \"null\",\n \"klout_score\": 19.737528730467623,\n \"providerInstanceId\": \"twitter\",\n \"profileImageURL\": \"https://pbs.twimg.com/profile_images/768361121761722368/5yZ2HHxu_normal.jpg\",\n \"networkinstance\": \"twitter\",\n \"avatarUrl\": \"https://pbs.twimg.com/profile_images/768361121761722368/5yZ2HHxu_normal.jpg\"\n }\n ]\n },\n \"tags\": [\n {\n \"creator\": {\n \"type\": \"AGENT\"\n },\n \"tagId\": 14865,\n \"lswUuid\": \"b8fee328-3676-4dd8-bab5-162c2417650e\"\n }\n ],\n \"notes\": [],\n \"timezone\": [\n \"-21600\"\n ]\n }\n ]\n}"
}
},
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "success"
},
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "2134086e-9024-4c3b-ab3b-afc6a36ea61c"
},
"displayNumber": {
"type": "integer",
"example": 13366,
"default": 0
},
"handles": {
"type": "object",
"properties": {
"external": {
"type": "array",
"items": {
"type": "object",
"properties": {
"@class": {
"type": "string",
"example": "ExternalSpecificAuthorData"
},
"lswUuid": {
"type": "string",
"example": "edce6d32-ee19-4740-87b8-a9b69afd677d"
},
"displayNumber": {
"type": "integer",
"example": 77285,
"default": 0
},
"profileUrl": {
"type": "string",
"example": ""
},
"id": {
"type": "string",
"example": "73292839-fb73-4b2c-b7b6-32db4b2f855a"
},
"name": {
"type": "string",
"example": "Anusuya_user"
},
"screenName": {
"type": "string",
"example": "Anusuya_user"
},
"providerInstanceId": {
"type": "string",
"example": "smooch"
},
"profileImageURL": {
"type": "string",
"example": "http://pbs.twimg.com/profile_images/768361121761722368/5yZ2HHxu_normal.jpg"
},
"networkinstance": {
"type": "string",
"example": "smooch"
},
"avatarUrl": {
"type": "string",
"example": "http://pbs.twimg.com/profile_images/768361121761722368/5yZ2HHxu_normal.jpg"
}
}
}
},
"twitter": {
"type": "array",
"items": {
"type": "object",
"properties": {
"@class": {
"type": "string",
"example": "TwitterSpecificAuthorData"
},
"lswUuid": {
"type": "string",
"example": "73292839-fb73-4b2c-b7b6-32db4b2f855a"
},
"displayNumber": {
"type": "integer",
"example": 12833,
"default": 0
},
"profileUrl": {
"type": "string",
"example": "http://twitter.com/anusuya_user"
},
"id": {
"type": "string",
"example": "768360234377064449"
},
"location": {
"type": "string",
"example": "India"
},
"name": {
"type": "string",
"example": "Anusuya_user"
},
"screenName": {
"type": "string",
"example": "anusuya_user"
},
"following": {
"type": "integer",
"example": 5,
"default": 0
},
"followers": {
"type": "integer",
"example": 5,
"default": 0
},
"verified": {
"type": "boolean",
"example": false,
"default": true
},
"joinDate": {
"type": "integer",
"example": 1472026330163,
"default": 0
},
"updatesCount": {
"type": "integer",
"example": 194,
"default": 0
},
"languages": {
"type": "string",
"example": "en"
},
"timezone": {
"type": "string",
"example": "null"
},
"klout_score": {
"type": "number",
"example": 19.737528730467623,
"default": 0
},
"providerInstanceId": {
"type": "string",
"example": "twitter"
},
"profileImageURL": {
"type": "string",
"example": "https://pbs.twimg.com/profile_images/768361121761722368/5yZ2HHxu_normal.jpg"
},
"networkinstance": {
"type": "string",
"example": "twitter"
},
"avatarUrl": {
"type": "string",
"example": "https://pbs.twimg.com/profile_images/768361121761722368/5yZ2HHxu_normal.jpg"
}
}
}
}
}
},
"tags": {
"type": "array",
"items": {
"type": "object",
"properties": {
"creator": {
"type": "object",
"properties": {
"type": {
"type": "string",
"example": "AGENT"
}
}
},
"tagId": {
"type": "integer",
"example": 14865,
"default": 0
},
"lswUuid": {
"type": "string",
"example": "b8fee328-3676-4dd8-bab5-162c2417650e"
}
}
}
},
"notes": {
"type": "array",
"items": {
"type": "object",
"properties": {}
}
},
"timezone": {
"type": "array",
"items": {
"type": "string",
"example": "-21600"
}
}
}
}
}
}
}
}
}
},
"400": {
"description": "400",
"content": {
"application/json": {
"examples": {
"Unsupported network type": {
"value": "{\n \"status\": \"fail\",\n \"message\": \"Error parsing HTTP body. Error details: Unsupported author data container format! (through reference chain: Person[\\\"handles\\\"])\"\n}"
}
},
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"example": "fail"
},
"message": {
"type": "string",
"example": "Error parsing HTTP body. Error details: Unsupported author data container format! (through reference chain: Person[\"handles\"])"
}
}
}
}
}
}
},
"deprecated": false,
"security": [],
"x-readme": {
"code-samples": [
{
"language": "curl",
"code": "curl -L -u [USERNAME]:[PASSWORD] 'https://your_social_response_instance/api/v2/authors/networks/instagram/handles/Anusuya_user '"
}
],
"samples-languages": [
"curl"
]
}
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": false,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```