Social listening

Sometimes, you may want to listen for or search a keyword, a hashtag, or videos using a certain audio track on the entire platform. This is particularly useful for companies, organisations or brands who want to check for all the activity happening on the platform and then try to find the one that is relevant for them (or sometimes, maybe all of it is relevant). InsightIQ comes in here with the specialized ability to fetch all such activity from a platform.

Steps

First, you need to create a social listening request. You should use the create a social listening request endpoint for this, which takes in the work_platform_id for the relevant platform. Along with this, you can supply it one of the following params to search for:

1. hashtag - any hashtag associated with the post

2. keyword - a keyword added in the post caption/description

3. audio_track_info (only for TikTok) - the song or background music on which the TikTok video is made

Optionally, you can search for items in between a specific date range using from_date and to_date params, and set a limit on the number of items to be fetched using the items_limit param. You get a unique listening request ID in response.

As soon as the analysis is complete, InsightIQ triggers CONTENTS_SEARCH.SUCCESS webhook. Make sure to read about our webhooks and setup your webhooks correctly. Alternatively, you can check the status of the listening request using the Get status of the submitted social listening request API.

Then, using the job_id from the webhook, call the get social listening insights API to get the list of all contents that match the searching params related to the given request.

Conclusion

This powerful API allows you to get a list of all content on the platform related to particular search terms. Use it judiciously and let us know what we can do better to help with your requirements.