YOyouscan
Statistics

Countries

Distribution of mentions by country, including per-country sentiment, top sources, authors count and engagement.

get/topics/{topicId}/statistics/countries

Request

Path parameters

topicIdinteger required

ID of the Topic.

Query parameters

fromstring date
Example:2024-01-01

ISO formatted date from (yyyy-MM-dd). Filters by publication date; the day starts in the API key owner's time zone (see Dates and time zones in the Mentions section). Default - 6 days before today.

tostring date
Example:2024-12-31

ISO formatted date to (yyyy-MM-dd), inclusive. The day ends in the API key owner's time zone (see Dates and time zones in the Mentions section). Default - today.

sizeinteger

Limits the number of countries returned.

sourcesSizeinteger

Limits the number of sources returned for each country.

countrystring[]

Filter mentions by ISO alpha-2 country codes. Multiple values are supported.

excludeCountrystring[]

Exclude mentions by ISO alpha-2 country codes. Multiple values are supported.

sourceTypesSourceTypeFilter[]

Filter mentions by source type. Multiple values are supported.

excludeSourceTypesSourceTypeFilter[]

Exclude mentions by source type. Multiple values are supported.

sourcesstring[]

Filter mentions by source. Multiple values are supported.

excludeSourcesstring[]

Exclude mentions by source. Multiple values are supported.

tagsinteger[]

Filter mentions by tag IDs. Multiple values are supported.

excludeTaginteger[]

Exclude mentions by tag IDs. Multiple values are supported.

subcategoriesinteger[]

Filter mentions by subcategory IDs. Multiple values are supported.

excludeSubcategoryinteger[]

Exclude mentions by subcategory IDs. Multiple values are supported.

Response

Countries distribution.

totalCountinteger

Changes

No recorded changes to this operation across all 1 revision of this API.