World Map

Distribution of the results on the world map

This diagram shows the number total of documents which match your query distributed in the world :

NOTE: it is based on the source site localization, not the author.

In this sample, over the filtered period (between the 1st of October and the 8th of october), we got 3K documents posted from the USA, 331 documents posted from England, 159 from Australia....

To retrieve this result, we can use the following API request:

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

The result will be sorted by number of documents, decreasing.

In our sample :

• v is the number of documents which match the filter criterias in the filtered period. we got 2568 documents in the period from the USA.
• ks is the country code (ISO 2 letters country codes).

Distribution of the results on the world map (zoom on regions)

We can have more detailed results on a specific country:

note

It is based on the source site localization, not the author.

To retrieve this result, we can use the following API request and filter on a specific country code (keyword sourcecountry):

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

Important

Documents without a region will not be returned in the API response. It depends on the source location resolution:

In our sample, 91 documents have no regions. That's why they are not returned in the result below:

In our sample :

• v is the number of documents which match the filter criterias in the filtered period. We got 54 documents in the period from New South Wales.
• key is the location with:

• country_code: ISO 2 letters country code.
• region: The region label
• Short_id: the region ID

Distribution of the results on the world map (zoom on cities)

We can have more detailed results on a specific region:

note

It is based on the source site localization, not the author.

To retrieve this result, we can use the following API request and filter on a specific region ID (keyword sourcegeo):

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

The region ID can be retrieved by calling Distribution of the results on the world map, zoom on to regions.

Important

Documents without a city will not be returned in the API response. It depends on the source location resolution:

In our sample:

• v is the number of documents which match the filter criterias in the filtered period. We got 53 documents in the period from Sydney.
• key is the location with:

• country_code: ISO 2 letters country code.
• region: The region label
• city: The city label
• Short_id: the city ID