​
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

​
Tools

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:

  • No parameters required

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
        }
      ]
    }
  ]
}

​
Get Post Comments

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.