OverviewPlatformsAPI Reference
Analytics

Get share of voice

Returns each keyword with matches in the period, its counts and its share of all brand and competitor matches. Topic keywords are counted but not part of the split. Pick the period with range (7d, 30d, 90d or 365d up to today) or with from and to. Days follow timezone, UTC by default. keywordIds and platforms narrow the data, and compare=true adds the equally long period just before. Dates are publish dates.

GET
/v1/analytics/share-of-voice

Authorization

bearerAuth
AuthorizationBearer <token>

An API key from POST /v1/api-keys. Keys start with ref_.

In: header

Query Parameters

range?string

A preset period up to today, 30d by default. Ignored when you send from or to.

Value in

  • "7d"
  • "30d"
  • "90d"
  • "365d"
from?string

Start date in timezone, as YYYY-MM-DD. That day is included.

Match^\d{4}-\d{2}-\d{2}$
to?string

End date in timezone, as YYYY-MM-DD, included. Defaults to today.

Match^\d{4}-\d{2}-\d{2}$
keywordIds?array<>|

Keeps these keyword ids only. Repeat the parameter or separate values with commas. Leave it out for all keywords.

Itemsitems <= 50
platforms?array<>

Keeps these platforms only. Repeat the parameter or separate values with commas. Leave it out for all platforms.

Itemsitems <= 20
compare?boolean

true adds the equally long period just before as previous.

timezone?string

The IANA time zone used to split days, such as America/New_York. Defaults to UTC. The zone's offset at the end of the period is used for the whole period.

Lengthlength <= 64

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/analytics/share-of-voice"
{  "window": {    "from": "string",    "to": "string",    "days": 0,    "timezone": "string"  },  "data": [    {      "keyword": {        "id": "string",        "term": "string",        "kind": "brand",        "group": {          "id": "string",          "name": "string",          "externalId": "string",          "isDefault": true        }      },      "matched": 0,      "relevant": 0,      "negative": 0,      "buyIntent": 0,      "share": 0,      "previous": {        "matched": 0      }    }  ]}
Was this page helpful?

Get review stats

Returns stats on reviews your keywords collect from the App Store, Google Play, Trustpilot and Google Maps. You get the count, average stars, the star distribution, replies and open 1 and 2 star reviews, for the workspace and per review page. Each page has a series of average stars per `bucket`, and the report lists the tags of unhappy reviews. Two keywords matching one review count it once. Pick the period with `range` (7d, 30d, 90d or 365d up to today) or with `from` and `to`. Days follow `timezone`, UTC by default. `keywordIds` and `platforms` narrow the data, and `compare=true` adds the equally long period just before. Dates are publish dates.

Dismiss an attention item

Dismisses an item. It leaves the open list and stays away while its condition lasts. After the condition ends, a new episode can open a new item. Calling it twice has the same effect as once.