Social Searcher API allows to fetch data from our servers for the users with premium plans. The API provides an easy way to integrate data with your own software without necessity to use interface. After starting the monitoring for the saved search, you'll be able to get access to the data cached by the Social Searcher and their analytics via API requests described below.
Your account API details
Log in to your account
API parameters description
| Name | Value | Description |
| key | User key | Your unique user key, available in the account API details. |
| searchid | Saved search id | Id of the saved search with monitoring to get data, list of ids available in the account API details. |
| network | "facebook", "twitter", "all" | Social network for which you want to get data. |
| action | "recent", "period", "favourites", "analytics", "export2csv" | "recent" option allows to fetch latest results, "period" - for the defined period, "favourites" - marked by user as favourite. "analytics" option can be used to get analytics data. "export2csv" provides CSV file with all data for the period. |
| period | "yesterday", "last3days", "last7days", "last30days", "lastmonth", "last3months", "last6months" | Required parameter when action=period or action=analytics. It also can be used together with the action=favourites. |
| limit | integer | Number of posts returned per social network. Default value is 20. Maximum value is 100. |
| page | integer | Allows to skip a number of results for pagination. Default value is 0. This parameter should be increased when you want to go deeper in the data. |
Recent posts example
Following request will provide 100 the most recent posts per social network:
[server]?action=recent&key=[key]&searchid=[searchid]&network=all&limit=100
Posts for the period example
In order to get first 50 posts for the Twitter for the last 7 days, following request should be executed:
[server]?action=period&period=last7days&key=[key]&searchid=[searchid]&network=twitter&limit=50
Favourite posts example
First 20 posts marked by the user as favourite for the last 3 months can be fetched as follows:
[server]?action=favourites&period=last3months&key=[key]&searchid=[searchid]&limit=20
If "period" parameter is not used then latest favourite posts are fetched.
Analytics of the posts example
Analytics of the social mentions for the defined period can be requested as follows:
[server]?action=analytics&period=last30days&key=[key]&searchid=[searchid]
Export to CSV file example
CSV file with all data for the defined period can be exported as follows:
[server]?action=export2csv&period=last30days&key=[key]&searchid=[searchid]
Errors
In case of error situations following JSON will be provided:
{"searchererror":{"code":"error_code"}}
Terms of use
Social Searcher provides caching service of the social networks APIs for personal use only. The data obtained from the service can't be published in form of directory, search engine or other ways that violate appropriate social network API policies. It's also prohibited to use data provided by the service for commercial and other third-party services in the form in which it was fetched directly from the service.
Social Searcher API
Social Searcher API allows to fetch data from our servers for the users with premium plans. The API provides an easy way to integrate data with your own software without necessity to use interface. After starting the monitoring for the saved search, you'll be able to get access to the data cached by the Social Searcher and their analytics via API requests described below.
Your account API details
API parameters description
Recent posts example
Following request will provide 100 the most recent posts per social network:
[server]?action=recent&key=[key]&searchid=[searchid]&network=all&limit=100
Posts for the period example
In order to get first 50 posts for the Twitter for the last 7 days, following request should be executed:
[server]?action=period&period=last7days&key=[key]&searchid=[searchid]&network=twitter&limit=50
Favourite posts example
First 20 posts marked by the user as favourite for the last 3 months can be fetched as follows:
[server]?action=favourites&period=last3months&key=[key]&searchid=[searchid]&limit=20
If "period" parameter is not used then latest favourite posts are fetched.
Analytics of the posts example
Analytics of the social mentions for the defined period can be requested as follows:
[server]?action=analytics&period=last30days&key=[key]&searchid=[searchid]
Export to CSV file example
CSV file with all data for the defined period can be exported as follows:
[server]?action=export2csv&period=last30days&key=[key]&searchid=[searchid]
Errors
In case of error situations following JSON will be provided:
{"searchererror":{"code":"error_code"}}
Terms of use
Social Searcher provides caching service of the social networks APIs for personal use only. The data obtained from the service can't be published in form of directory, search engine or other ways that violate appropriate social network API policies. It's also prohibited to use data provided by the service for commercial and other third-party services in the form in which it was fetched directly from the service.