Histogram Top influencers from a talkwalker project

GET

api/v1/search/p/:project_id/histogram/top_influencers

Path Parameters

project_id string required
Example: {{project_id}}

Query Parameters

influencer_type string
Get the results for authors or sources. Allowed values: author or source. Default value is author.
Example: author
sort_criteria string
Sort the results (always descending) by a criteria. Allowed values : total, positive, negative, neutral, reach, engagement, engagement_per_mention, reach_per_mention. Default value : total
Example: total
q string
The query to search for.
Example: cat AND dogs
top_n integer
Size limiter for demographic distribution. Allowed values : between 1 and 100. Default value : 10.
Example: 10
topic string
One or more topics that are defined in the Talkwalker project
filter string
One or more filters that are defined in the Talkwalker project
channel string
One or more channels that are defined in the Talkwalker project
panel string
One or more source panels that are defined in the Talkwalker project
dataset string
One or more datasets that are defined in the Talkwalker Customer Intelligence project

Responses

application/json

Schema
Example (from schema)
Example

Schema

object

{}

{
  "status_code": "0",
  "status_message": "OK",
  "request": "GET /api/v1/search/p/a1ab1abc-a123-123a-123a-abcd12ab1a12/histogram/top_influencers?influencer_type=author&sort_criteria=total&q=cat%20AND%20dogs&top_n=10&access_token=abcd_1234_abcd",
  "request_id": "#rkm7q5m7xypt#",
  "result_top_influencers": {
    "influencers": [
      {
        "matched_topics": [
          {
            "topic_id": "kpnutesu_1234",
            "posts_amount": 0
          },
          {
            "topic_id": "kpnzh6u5_1234",
            "posts_amount": 880
          }
        ],
        "details": {
          "name": "Yantocool (domzale.info)",
          "url": "https://domzale.info/product/4000191110230/womens-office-clothes-dresses-front-office-dresses-womens-office-clothes-two-piece-dresses-long-sleeves-autumn-and-winter",
          "id": "ex:domzale.info-137038294"
        },
        "network": "ONLINENEWS_OTHER",
        "posts": 880,
        "sentiment": {
          "positive": 226,
          "negative": 0,
          "neutral": 654
        },
        "reach": 0,
        "reach_per_mention": 0,
        "engagement": 1,
        "engagement_per_mention": 0.0001704448610874382
      },
      {
        "matched_topics": [
          {
            "topic_id": "kpnutesu_1234",
            "posts_amount": 0
          },
          {
            "topic_id": "lib-kpnzh6u5_1234",
            "posts_amount": 193
          }
        ],
        "details": {
          "name": "Yantocool (ebuzznew.com)",
          "url": "https://ebuzznew.com/detail/32949642512/girls-boys-canvas-cotton-ballet-shoes-kids-adult-ballet-flat-slippers-children-soft-sole-dance-practice-shoes",
          "id": "ex:ebuzznew.com-137038294"
        },
        "network": "BLOG_OTHER",
        "posts": 193,
        "sentiment": {
          "positive": 94,
          "negative": 0,
          "neutral": 99
        },
        "reach": 0,
        "reach_per_mention": 0,
        "engagement": 0,
        "engagement_per_mention": 0
      }
    ],
    "influencer_type": "AUTHOR",
    "sort_criteria": "TOTAL"
  }
}