Social Searcher API

Appearance

Premium API ​

1. Premium API Overview ​

Premium API provides a reliable solution to search for the recent keywords mentions and search for users in the social networks that are hard to get data from:

  • Facebook
  • Twitter
  • Instagram
  • LinkedIn
  • TikTok

1.1 Requesting Data ​

Requesting data should be done in 2 steps as collecting information will require 20-60 seconds.

Steps ​

Step 1: Request data ​

Example: Search for Twitter mentions with the keyword “obama”.

GET https://api.social-searcher.com/v2/search?q=obama&network=twitter&limit=100&key={api_key}

Keep information about requestid from the response JSON

Note: Wait for 20-60 seconds

Step 2: Fetch results ​
GET https://api.social-searcher.com/v2/search?requestid={requestid}&page=0&limit=100&key={api_key}

Check that status=finished in the response. If status=pending then wait for 5 mins more and try again.

Network specifics: ​

  • Facebook, LinkedIn search can’t contain any logical operators (AND, OR) and minus keywords.
  • Twitter search allows the use of logical operators (AND, OR) and minus keywords.
  • Instagram posts search is available via hashtags only and returns results immediately, without additional Step 2.

    Note: # symbol is not needed for the search query.

Limitations: ​

  • Maximum 100 results are available for fetching: limit parameter has value [1..100].
  • Query only 1 network per API call.

If your business requires more information or would like to extend some functionality limitations, please, contact us at info@social-searcher.com to get possible solutions!

We are always glad to assist you and improve our offering with additional functionality.

1.2 Pricing model ​

Premium API usage is billed on the basis of the fetched posts/profiles number:

  • Each API query to search for the recent posts or users profiles initiates data collection for the predefined number of the posts/profiles via limit parameter in the request.
  • Collected posts/profiles number is counted.

In your account API details you may find new “Premium” limit section:

  • API details: https://api.social-searcher.com/v2/accounts/?key={api_key}
  • New section example: "premium":{"allowed":"Y","posts_count":2373,"limit":100000,"period_end":"2023-12-29","period":30,"networks":"instagram,twitter,facebook, linkedin"}

Examples: ​

API requestLimits calculation
Search for Twitter mentions with the keyword “obama”.

GET https://api.social-searcher.com/v2/search?q=obama&network=twitter&limit=100&key={api_key}		• posts_count + 5 for the request
• posts_count + 100 for the collected posts
Search for Facebook mentions with the non-existing keyword “hjgdfuewiwbhrvfugfe”.

GET https://api.social-searcher.com/v2/search?q=hjgdfuewiwbhrvfugfe&network=facebook&limit=100&key={api_key}		• posts_count + 5 for the request
Search for Instagram profiles with the name “John”.

GET https://api.social-searcher.com/v2/users?q=john&network=instagram&limit=50&key={api_key}		• posts_count + 5 for the request
• posts_count + 50 for the collected profiles

2. API Details ​

2.1 Recent Posts Search by network ​

Twitter ​

Test Data

Search query: obama
Twitter search: https://twitter.com/search?q=obama&f=live

Social Searcher API

Example:
https://api.social-searcher.com/v2/search?q=obama&network=twitter&limit=100&key={api_key}

Facebook ​

Test Data

Search query: obama
Facebook search: https://www.facebook.com/search/posts?q=obama&filters=eyJyZWNlbnRfcG9zdHM6MCI6IntcIm5hbWVcIjpcInJlY2VudF9wb3N0c1wiLFwiYXJnc1wiOlwiXCJ9In0%3D

::: success Social Searcher API Example:
https://api.social-searcher.com/v2/search?q=obama&network=facebook&limit=100&key={api_key} :::

Instagram ​

Test Data

Posts with Hashtag: #obama
Instagram search: Tags

Social Searcher API

Example:
https://api.social-searcher.com/v2/search?q=obama&network=instagram&limit=100&key={api_key}

LinkedIn ​

Test Data

Search query: obama
LinkedIn search: https://www.linkedin.com/search/results/content/?keywords=obama&sortBy=%22date_posted%22

Social Searcher API

Example:
https://api.social-searcher.com/v2/search?q=obama&network=linkedin&limit=100&key={api_key}

TikTok ​

Test Data

Search query: obama
TikTok search: https://www.tiktok.com/search/video?q=obama

Social Searcher API

Example:
https://api.social-searcher.com/v2/search?q=obama&network=tiktok&limit=100&key={api_key} 

2.2 Users Search ​

Twitter ​

Test Data

Search query: obama
Twitter search UI: https://twitter.com/search?q=obama&f=user

Social Searcher API

Example:
https://api.social-searcher.com/v2/users?q=obama&network=twitter&limit=100&key={api_key}

Facebook ​

Test Data

Search query: obama
Facebook search: https://www.facebook.com/search/people/?q=obama

Social Searcher API

Example:
https://api.social-searcher.com/v2/users?q=obama&network=facebook&limit=100&key={api_key}

Instagram ​

Test Data

Posts with Hashtag: #obama
Instagram search: Accounts

Social Searcher API

Limitation: only first 50 results are available

Example:
https://api.social-searcher.com/v2/users?q=obama&network=instagram&limit=50&key={api_key}

LinkedIn ​

Test Data

Search query: obama
LinkedIn search: https://www.linkedin.com/search/results/people/?keywords=obama&sid=Ext

Social Searcher API

Example:
https://api.social-searcher.com/v2/users?q=obama&network=linkedin&limit=100&key={api_key}

TikTok ​

Test Data

Search query: obama
TikTok search: https://www.tiktok.com/search/user?q=obama 

Social Searcher API

Example:
Example:https://api.social-searcher.com/v2/users?q=obama&network=tiktok&limit=100&key={api_key}