What can you do with it?
Search social media platforms and analyze sentiment with comprehensive monitoring capabilities including real-time social media searches, saved search management, historical data retrieval, post popularity analysis, and sentiment tracking across multiple social networks.
How to use it?
Basic Command Structure
/your-social-searcher-connection [action] [required-parameters] [optional-parameters]
Parameters
Required:
action
- The operation to perform (realtime-search, get-saved-searches, get-saved-search-posts, get-post-comments, get-post-likes, get-post-reposts)
Optional:
keywords
- Search keywords (use quotes for exact phrases, - to exclude)
limit
- Number of posts to return (default: 100)
page
- Page number for pagination (default: 0)
network
- Social media platforms (web, facebook, twitter, youtube, instagram, etc.)
language
- Language restriction
content-type
- Content type (video, photo, status, link)
search-id
- Saved search ID
post-id
- Post ID for specific operations
Realtime Search
Search social media platforms in real-time for mentions and content
Parameters:
keywords
(required) - Keywords to search for (use @ for mentions)
limit
(optional) - Number of posts per page (default: 100)
page
(optional) - Page number for pagination (default: 0)
network
(optional) - Networks to search (web, facebook, twitter, youtube, instagram)
language
(optional) - Language restriction
content-type
(optional) - Content type filter (video, photo, status, link)
Example:
/your-social-searcher-connection
action: realtime-search
keywords: @brandname OR "product launch"
limit: 50
network: web,facebook,twitter
language: en
content-type: status,photo
Response:
{
"meta": {
"requestid": "d497bd0d28394dfd9825b06b4c3ce9ff",
"http_code": 200,
"network": "web,twitter",
"query_type": "realtime",
"limit": 1,
"page": 0,
"status": "finished"
},
"posts": [
{
"network": "web",
"posted": "2024-11-20 12:53:21 +00:00",
"postid": "https://en.wikipedia.org/wiki/Gucci",
"text": "",
"type": "link",
"sentiment": "neutral",
"url": "https://en.wikipedia.org/wiki/Gucci",
"user": {
"name": "en.wikipedia.org",
"url": "https://en.wikipedia.org"
}
}
]
}
Get Saved Searches
Retrieve list of saved searches for historical data access
Parameters:
Example:
/your-social-searcher-connection
action: get-saved-searches
Response:
{
"meta": {
"http_code": 200,
"query_type": "searches_list"
},
"searches": [
{
"id": "672f61b2e107bf402632223f",
"name": "main @katespade",
"userId": "672e0f2de107bf402623e83e",
"q": "\"@katespade\" -\"get well-research report\" -\"research report\" -\"click here\"",
"network": "web,facebook,twitter,youtube,instagram,tumblr,reddit,flickr,dailymotion,vimeo,vkontakte,linkedin",
"type": "link,photo,status,video",
"created": "2024-11-09 13:20:50 +00:00",
"changed": "2024-11-20 13:44:13 +00:00",
"status": "active",
"plan": "Professional",
"monitoring": {
"started": "Y",
"posts_count": 161,
"premium_posts_count": 100,
"start_date": "2024-11-09 13:20:51 +00:00"
}
}
]
}
Get Saved Search Posts
Retrieve posts from a saved search for historical data analysis
Parameters:
search-id
(required) - Saved search ID
page
(optional) - Page number for pagination
period
(optional) - Time period (recent, yesterday, last7days, last30days)
sentiment
(optional) - Filter by sentiment (positive, negative, neutral)
sort
(optional) - Sort order (date, popularity)
Example:
/your-social-searcher-connection
action: get-saved-search-posts
search-id: 672f61b2e107bf402632223f
page: 1
period: last30days
sentiment: positive
sort: popularity
Response:
{
"meta": {
"http_code": 200,
"network": "twitter,facebook,youtube,instagram",
"query_type": "recent",
"limit": 1,
"page": 0,
"searchid": "672f61b2e107bf402632223f",
"period": "recent",
"nextpage": "1"
},
"posts": [
{
"id": "672f62b2e177ac5f75c278d5",
"network": "twitter",
"posted": "2024-11-07 08:19:22 +00:00",
"text": "@katespade is bringing back saddle shoes this is awesome!! #saddleshoes",
"lang": "en",
"type": "photo",
"sentiment": "positive",
"image": "https://pbs.twimg.com/media/GbxJ-CoWMBUdmEr.jpg",
"url": "https://twitter.com/444Cin444/status/1854438479855235373",
"user": {
"name": "444Cin444",
"url": "https://twitter.com/444Cin444",
"userid": "4323023897"
},
"popularity": [
{
"name": "retweets",
"count": 0
},
{
"name": "likes",
"count": 1
},
{
"name": "comments",
"count": 1
}
]
}
]
}
Retrieve comments for a specific social media post
Parameters:
post-id
(required) - Post ID to get comments for
Example:
/your-social-searcher-connection
action: get-post-comments
post-id: https://twitter.com/444Cin444/status/1854438479855235373
Response:
{
"comments": [
{
"id": "comment-123",
"text": "Great post! Love this content.",
"user": {
"name": "commenter_user",
"url": "https://twitter.com/commenter_user"
},
"posted": "2024-11-07 09:30:00 +00:00",
"sentiment": "positive"
}
]
}
Get Post Likes
Retrieve likes count and details for a specific post
Parameters:
post-id
(required) - Post ID to get likes for
Example:
/your-social-searcher-connection
action: get-post-likes
post-id: https://twitter.com/444Cin444/status/1854438479855235373
Response:
{
"likes": {
"count": 25,
"users": [
{
"name": "user1",
"url": "https://twitter.com/user1"
},
{
"name": "user2",
"url": "https://twitter.com/user2"
}
]
}
}
Get Post Reposts
Retrieve reposts/shares count and details for a specific post
Parameters:
post-id
(required) - Post ID to get reposts for
Example:
/your-social-searcher-connection
action: get-post-reposts
post-id: https://twitter.com/444Cin444/status/1854438479855235373
Response:
{
"reposts": {
"count": 5,
"users": [
{
"name": "sharer1",
"url": "https://twitter.com/sharer1",
"repost_date": "2024-11-07 10:15:00 +00:00"
}
]
}
}
Notes
Social Searcher uses direct API access without proxy URLs. Always include the API key in requests. Use @ prefix for mention searches. Historical data requires saved searches. Supports multiple social networks including web, Facebook, Twitter, YouTube, Instagram, TikTok (via web), Reddit, LinkedIn. Query operators include quotes for exact phrases, minus sign for exclusions, and OR for multiple keywords. Sentiment analysis provides positive, negative, and neutral classifications.