Skip to main content

Influencers

Unique authors

This diagram show the number of unique authors for all documents which match the project criterias within the filtered period:

Unique Authors

In this sample, over the filtered period (between the 1st of October and the 8th of october), we got 3360 different authors for all documents which match the filter criterias.

To retrieve this result, we can use this API call:

curl -L -X GET 'https://api.talkwalker.com/api/v1/search/p/<project_id>/histogram/unique_author?access_token=<access_token>&q=published:>1633039200000 AND published:<1633644000000'

Unique Authors - API result

In our sample:

  • v: the number of unique authors for all documents which match the filter criterias
  • total_hits: The number of documents which match filter criterias.

Average mentions per authors

This diagram provides the average number of document per unique author:

Average mentions per Authors

To get this result, we can use the same API call as Unique authors and apply this formula:

AVG = total_hits / v

In our sample: 4004 / 3360 = 1.191667

Top influencers

This diagram provides the view on the most influencing authors per topic. In this sample, we display the top influencers on one specific topic between the 24th of October 2022 and the 30th of October (included):

note

It can only be used in a Talkwalker project.

Top influencers

To retrieve this result, we can use this API call:

curl -X GET 'https://api.talkwalker.com/api/v1/search/p/project_id/histogram/top_influencers?q=published:>=1666562400000 AND published:<1667170800000&influencer_type=author&topic=<topic_id>&access_token=<access_token>'

Top influencers - API result

In our samples: VNExplorer made the most posts within this time period which were indexed into the topic:

  • matched_topics is the list of topics in the query. If not specified, it will return all topics in the project.

    • topic_id is the ID of the topic.
    • posts_amount is the number of posts which match the filter criterias in the filtered period.
  • details provide the influencer details:

    • name: Name of the author
    • url: profile's URL
    • id: ID of the author in our DB. Can be used to filter on it whith the query filter: author_id:xxx
  • network: media type associated to the author ID.

  • posts is the number of posts which match the filter criterias in the filtered period.

  • sentiment: number of posts breakdown by sentiment (positive, negative and neutral).

  • reach: The combined total reach for the influencer's posts which match the filter criterias in the filtered period.

  • reach_per_mention: The average reach per mention for each of the posts published by the influencer. It's the reach value divided by the number of posts.

  • engagement: The combined total engagement for the influencer's posts which match the filter criterias in the filtered period.

  • engagement: The average engagement per mention for each of the posts published by the influencer. It's the engagement value divided by the number of posts.

Top sites

This diagram is the same as Top influencers except that it displays the source's information instead of author's information.

Top sites

To get this result, we can use the same API call as Top influencers and change the parameter influencer_type to source:

curl -X GET 'https://api.talkwalker.com/api/v1/search/p/project_id/histogram/top_influencers?q=published:>=1666562400000 AND published:<1667170800000&influencer_type=source&topic=<topic_id>&access_token=<access_token>'

Top sites - API result

The format remains the same as Top influencers.