Social
Overview
Extract Social URL from only web page. AmplifyReach supports URLs extraction of following social media: YouTube, Snapchat, Twitter, Facebook, Pinterest, Instagram, LinkedIn etc.
Detecting Social Connect Using Catalyst UI
- Goto AmplifyReach Dashboard -> Bot Studio -> Left Navigation Sidebar
- Select Core Services > Text Analysis.
- Select URL or Text tab to enter the link or text for Text Analysis.
- Press Analyze button.
- Text analysis results will be shown.
- The Social option in Left Panel shows Social Links extracted by AmplifyReach Catalyst.
Extracting Social Connect Using Catalyst API
Tip: Register your account on AmplifyReach and contact us at kick-start@amplifyreach.com to get Developer ID and Access Token.
URL & Objects
The following URLs are available.
| URL | Description |
|---|---|
PUT /textanalysis/v1/social | Put URL to extract social connect URL from web page. |
GET /textanalysis/v1/social/{UID} | Extract Social connect URL from web page. |
PUT /textanalysis/v1/social
PUT https://apps.amplifyreach.com/textanalysis/v1/social
| Name | Description |
|---|---|
| Content-Type | application/json |
| authToken | YOUR_DEVELOPER_ACCESS_TOKEN |
| cid | YOUR_DEVELOPER_ID |
PUT body
{
"url": "<SAMPLE_URL>"
}cURL-PUT Request for URL Request
curl \
-H “Content-Type: application/json” \
-H “cid:” \
-H “authtoken:” \
-X PUT \
-d ‘{“url”:””}’ \
https://apps.amplifyreach.com/textanalysis/v1/social
Put Response
The social put API response JSON structure:
| Name | Type | Description |
|---|---|---|
| status | String | Request Status (Reference: Status & Error Codes) |
| uid | String | UID is unique request identifier ID which to get result in Get API. |
Example: PUT Response
{
“status”:”success”,
“uid”:”4f057e01d88ff7aa82a8610dc651e8fe”,
“license”:”By accessing AmplifyReach or using information generated by AmplifyReachAPI, you are agreeing to be bound by the AmplifyReach Terms of Use.”
}
Put Response
The social put API response JSON structure.
| Name | Type | Description |
|---|---|---|
| status | String | Request Status (Reference: Status & Error Codes) |
| uid | String | UID is unique request identifier ID which to get result in Get API. |
Example: PUT Response
{
"status":"success",
"uid":"4f057e01d88ff7aa82a8610dc651e8fe",
"license":"By accessing AmplifyReach or using information generated by AmplifyReachAPI,
you are agreeing to be bound by the AmplifyReach Terms of Use."
}GET /textanalysis/v1/social/{UID}
GET https://apps.amplifyreach.com/textanalysis/v1/social/{UID}
Headers:
| Name | Description |
|---|---|
| Content-Type | application/json |
| authToken | YOUR_DEVELOPER_ACCESS_TOKEN |
| cid | YOUR_DEVELOPER_ID |
cURL-GET Request for URL Request
curl \
-H “Content-Type: application/json” \
-H “cid:” \
-H “authtoken:” \
-X GET \
https://apps.amplifyreach.com/textanalysis/v1/social/{UID}
Social Object
The social response JSON structure.
| Name | Type | Description |
|---|---|---|
| status | String | Request Status (Reference: Status & Error Codes ). |
| socialConnect | JSONObject | |
| socialConnect.youtube | JSONArray String | YouTube channel links. |
| socialConnect.snapchat | JSONArray String | Snapchat pages links. |
| socialConnect.twitter | JSONArray String | Twitter pages links. |
| socialConnect.facebook | JSONArray String | Facebook pages links. |
| socialConnect.instagram | JSONArray String | Instagram page links. |
| socialCOnnect.linkedin | JSONArray String | LinkedIn pages links. |
Example: Social Object
{
“status”: “success”,
“socialConnect”: {
“youtube”: [
“https://www.youtube.com/channel/UCef1-8eOpJgud7szVPlZQAQ?sub_confirmation=1”,
“http://www.youtube.com/subscription_center?add_user=ibnlive”,
],
“snapchat”: [],
“twitter”: [
“https://twitter.com/CNNnews18”
],
“facebook”: [
“https://www.facebook.com/cnnnews18/”
],
“pinterest”: [],
“instagram”: [
“https://www.instagram.com/cnnnews18/”
],
“linkedin”: [],
}
}
