Every API here is available over the APIs.io API and to AI agents over MCP.
# Refined from the Talkwalker-published OpenAPI at
# https://developer.talkwalker.com/talkwalker-api.yaml (harvested 2026-08-13)
# Split by tag group; operations carried verbatim. Verbatim source: openapi/_original/talkwalker-openapi.yaml
openapi: 3.0.0
info:
title: Talkwalker Search API
description: Talkwalker Advanced API
version: 0.0.1
contact:
email: client-api@talkwalker.com
name: Client-API
externalDocs:
description: Find more info here or there
url: https://apidocs.talkwalker.com/
servers:
- description: Production environment server
url: https://api.talkwalker.com
security:
- apikeyAuth: []
tags:
- name: Search API
- name: Summary API
paths:
/api/v1/search/info:
get:
description: Get a list of all projects linked to the API subscription
responses:
'200':
content:
application/json:
example:
request: GET /api/v1/search/info?access_token=abcd-1234-abcd
request_id: '#r8tv9rr3rcmo#'
result_accinfo:
projects:
- account_id: abcd-1153541-abcd
account_name: Api Talkwalker
id: 12324-abcd-1234
name: Pascal's Project
status_code: '0'
status_message: OK
schema:
type: object
description: OK
summary: List of allowed projects
tags:
- Search API
/api/v1/search/p/{project_id}/results:
get:
description: Retrieve up to 10.000 sorted results. the full history of Talkwalker projects is available in the search
API, **when used in combination with a Talkwalker project**.
parameters:
- description: The query to search for.
example: cats AND dogs
in: query
name: q
schema:
type: string
- description: 'Timezone for the time_range (e.g. Europe/Luxembourg).
Allowed values are timezone names.
Default value: UTC'
example: CET
in: query
name: timezone
schema:
type: string
- description: 'Time range filter.
Format `number` + a time unit character (e.g. `30d` for 30 days.).'
example: 30d
in: query
name: time_range
schema:
type: string
- description: 'Number of results to skip (for paging).
Vaule is between 0 and must respect the rule that hpp+offset is less than 10.000.
Default value: 0.'
example: '0'
in: query
name: offset
schema:
type: integer
- description: "Number of hits per page (for paging). \nValue is between 0 and 500 (between 100 and 500 if summarize\
\ is on).\nDefault value: 10 (100 if summarize is on)."
example: '10'
in: query
name: hpp
schema:
type: integer
- description: "Criteria for sorting the results. \nAllowed values: engagement, published, reach, facebook_shares, facebook_likes,\
\ twitter_shares, twitter_retweets, twitter_followers, youtube_likes, youtube_dislikes, youtube_views, cluster_size,\
\ comment_count, published, search_indexed, trending_score. \nDefault value: engagement."
example: engagement
in: query
name: sort_by
schema:
type: string
- description: Sorting order (ascending or descending). Default value is desc.
example: desc
in: query
name: sort_order
schema:
type: string
- description: "Turns highlighting on or off. \nAllowed values: true or false.\nDefault value: true."
example: 'true'
in: query
name: hl
schema:
type: boolean
- description: 'Formatted json for testing.
Possible values are true or false.
Default value: false.'
example: 'false'
in: query
name: pretty
schema:
type: boolean
- description: One or more topics that are defined in the Talkwalker project
in: query
name: topic
schema:
type: string
- description: One or more filters that are defined in the Talkwalker project.
in: query
name: filter
schema:
type: string
- description: One or more channels that are defined in the Talkwalker project.
in: query
name: channel
schema:
type: string
- description: One or more source panels that are defined in the Talkwalker project.
in: query
name: panel
schema:
type: string
- description: One or more datasets ID that are defined in the Talkwalker Customer Intelligence project
in: query
name: dataset
schema:
type: string
- example: a1ab1abc-a123-123a-123a-abcd12ab1a12
in: path
name: project_id
required: true
schema:
type: string
- description: 'To get the AI Summaries for a Search API call.
Allowed values: true (on) or false (off).
Default value: false.'
example: 'on'
in: query
name: summarize
schema:
type: boolean
- description: Topic on which summary should focus
example: food
in: query
name: custom_focus
schema:
type: string
responses:
'200':
content:
application/json:
example:
pagination:
next: GET /api/v1/search/p/a1ab1abc-a123-123a-123a-abcd12ab1a12/results?q=cats%20AND%20dogs&offset=2&hpp=2&sort_by=engagement&sort_order=desc&hl=true&pretty=false&topic&filter&channel&panel&dataset&access_token=abcd_1234_abcd
total: 1529
request: GET /api/v1/search/p/a1ab1abc-a123-123a-123a-abcd12ab1a12/results?q=cats%20AND%20dogs&offset=0&hpp=2&sort_by=engagement&sort_order=desc&hl=true&pretty=false&topic&filter&channel&panel&dataset&access_token=abcd_1234_abcd
request_id: '#r8vn2rtxny0t#'
result_content:
data:
- data:
DEPRECATED_spam_level: 0
article_extended_attributes:
twitter_shares: 474
cluster_id: http://geographicdiversityofindi71335.onesmablog.com/what-is-adventure-tourism-in-india-Options-44178301
content: 'What if bad news isn’t the only news there is?
Image credit: David WimbleIf you were asked to list the top global news stories of 2021, off the top
of your head, what would they be? Chances are you’d come up with some combination of COVID-19, economic
woes, political conflict, Afghanistan, natural disasters, and maybe some space billionaires and Free
Britney thrown in for good measure. Oh… and don’t forget the drama in the Suez Canal!
What’s probably missing from your list is any good news, which seems pretty strange. Even in the midst
of a global pandemic, surely a few positive things happened this year? Researchers would say it’s
all down to negativity bias — we’re wired, apparently, to notice and then remember things that are
shocking or scary. What if there’s a simpler explanation though? What if the reason we can’t remember
any good news, is because nobody reported it in the first place?
For the past several years, we’ve been putting that idea to the test, seeing whether it’s possible
to carve out a tiny little corner of the internet dedicated exclusively to stories of progress. Not
fluffy, feel good stories, but big stories of real, lasting change for people and the planet. Over
time, we’ve gotten better at digging them up and this year, managed to find hundreds. Boiling them
down to just 99 was a struggle, but we got there in the end, with only a tiny bit of cheating.
All of these originally went out in our free email newsletter, which you can subscribe to below. We
hope you enjoy the list, and while you’re reading perhaps ask yourself — why is it that so many of
these stories come as a surprise? The answer, we think you’ll find, is pretty simple. They never appeared
on your screen or in your newspaper at all.
<a href="https://medium.com/media/f7242be104e8af2a703576c54384cf5a/href">https://medium.com/media/f7242be104e8af2a703576c54384cf5a/href</a>
1. Let’s kick off with by far the biggest good news story of the year: the COVID-19 vaccines. Nine
billion doses were administered across 184 countries, and and almost 60% of the planet has received
at least one dose (in four months it’ll be 75%). This is by far the most successful global health
initiative ever undertaken. In less than two years not only did we come up with a way to overcome
a brand new disease, but rolled it out to more than half of humanity.
The vaccines have been incredibly effective, even against the new variants, with the global death
rate falling by more than half from earlier this year. Naturally, the media has focused on all the
problems — hesitancy, unequal access, ‘pandemics of the unvaccinated’, resistance to mandates etc.
Lost in all the noise is the simple fact that by far the majority of the world’s population has enthusiastically
embraced the vaccines, and as a result, for the first time ever we have the chance to end a global
pandemic on our own terms.
Don’t take it from us though, take it from an old man who just got his booster:
“The vaccine is one of the greatest achievements of mankind.” Donald J Trump22nd December 20212. It
wasn’t just COVID-19. The WHO approved a long awaited malaria vaccine, revitalizing the fight against
one of humanity’s oldest foes, as well as a new polio vaccine, which was rolled out to over 80 million
children in Africa. Other achievements included the introduction of a licensed Ebola vaccine and the
launch of a landmark new global plan to tackle meningitis. Liberia became the first African country
to introduce the typhoid conjugate vaccine, which was given to over two million children in just weeks,
and a new study revealed that the HPV vaccine has reduced cases of cervical cancer in England by nearly
90% since 2008, with over 100 countries now using it as part of a global plan to eliminate the disease.
Oh, and this didn’t get a single mention in the news, but back in January, a report in The Lancet
looking at ten different diseases estimated that vaccines saved the lives of 37 million kids between
2000 and 2019. Surely that’s worth at least one headline?
3. China successfully eliminated malaria this year (it used to have 30 million cases a year in the
1940s), as did El Salvador, the first country in Central America. Globally, 40 countries have now
achieved this milestone. Côte d’Ivoire became the second African country to eliminate sleeping sickness,
and the Gambia became the third African country to eliminate trachoma, an amazing achievement given
that in the 1980s it was responsible for almost 1 in 5 of the country’s cases of blindness.
4. One of the four major flu viruses that circulate in humans looks like it might have gone extinct
this year thanks to the COVID-19 pandemic. The Yamagata virus has not been detected since April 2020
anywhere in the world. Together with the Victoria flu virus, it used to be responsible for somewhere
between 290,000 and 650,000 deaths every year.
5. The latest data on AIDS (you remember, the other global pandemic) revealed there were1.5 million
new HIV infections last year, a decline of 30% since 2010, and the lowest total number since 1990.
6. The same report said that 9.4 million people around the world are now receiving treatment for Hepatitis
C, reversing the global trend of increasing mortality from the disease for the first time ever. Egypt
has been the standout here — six years ago it had one of the highest Hepatitis C burdens in the world,
at 7.6%, or 40,000 deaths a year. Thanks to a huge public health effort, by 2021 the burden had fallen
to 2%, and public health officials are saying they are now on track to eliminate it altogether.
7. Lots of good news on cancer this year. The American Cancer Society said there was a 2.4% decline
between 2017 to 2018 — the largest one-year drop ever — and that between 1991 and 2018, cancer mortality
has fallen by 31%. Similar declines have happened in Europe. A new study showed that 4.9 million cancer
deaths have been averted on the continent in the last three decades.
6. A lot of that is down to less smoking. In November, the WHO released its Global Tobacco Trends
report, showing that at the turn of the century, around a third of the world’s adults were tobacco
users. By 2020, this had declined to under a quarter, and is projected to fall even further to one
fifth by 2025. Also, both Japan and New Zealand announced this year they would be completely smoke-free
within the next decade.
9. It’s been two years since Canada legalized recreational cannabis, and one of the many positive
benefits has been a drastic decrease in opioid prescriptions. This year, a study compared prescriptions
before and after legalization and found that average doses of opioids per person have fallen to less
than 20% of their former levels.
10. India has the largest public health insurance scheme in the world, providing 500 million people
with free healthcare. In its 2021 budget, spending on the program was doubled, from 1% to 2% of GDP,
the largest single public investment in the country’s history. Imagine the kind of headlines this
would have received if it happened in the United States or Europe?
11. Haiti announced that it had successfully controlled the largest cholera epidemic ever recorded
in a single country, while simultaneously improving maternal and child healthcare. There have been
no confirmed cases of cholera there since January 2019, and the quality of maternal and child health
has improved significantly in the last decade.
12. A new paper in The Lancet showed that de-worming initiatives in sub-Saharan Africa in the last
two decades have resulted in a significant decline in cases among children, from 44% in 2000 to 13%
in 2019. This is a huge win for one of the world’s most underrated public health problems, improving
the lives of millions of people and driving economic development.
13. Stroke is a hidden killer — the second-leading cause of death worldwide, and the third-leading
cause of death and disability combined. New research released in September this year revealed that
quietly and largely uncelebrated, we’ve made amazing progress, with the age-standardised number of
cases decreasing by 17%, and deaths by 36% in the last two decades.
14. Two conservation stories in particular should really have received more coverage this year. September
saw the creation of the North-Atlantic Current and Evlanov Sea Basin, a vast, protected area off the
south west coast of Ireland, and then in October we got news of the new Eastern Tropical Pacific Marine
Corridor, a mega-MPA linking the waters of Ecuador, Colombia, Panama and Costa Rica, and containing
some of the richest pockets of ocean biodiversity on the planet, including the Galapagos Islands.
Together, these two protected areas cover more than a million km² of ocean.
15. In 2021 the US government trebled the size of the Gulf of Mexico’s largest coral sanctuary, created
the country’s 63rd national park: New River Gorge, in West Virginia, finally banned the use of the
pesticide chlorpyrifos on food crops, suspended all drilling leases in the Arctic National Wildlife
Refuge, and restored full protections for Alaska’s Tongass National Forest.
16. The Biden Administration also reversed a Trump era ruling that allowed sand mining on protected
beaches, reinstated environmental protections for two major national monuments in Utah and one off
the coast of New England, and reintroduced protections for waterways and wetlands across the United
States, reversing another Trump era ruling, and ensuring clean drinking water for millions of Americans
and safe habitat for thousands of wildlife species.
17. 2021 was a landmark year for conservation in China, with the establishment of a network of five
national parks, covering a total of 230,000 km² and containing nearly 30% of the country’s key wildlife
species. The national park system, which has been in the works since 2015, will be the world’s most
extensive, covering 18% of the world’s second-largest country by land area.
18. After nearly 20 years of negotiations, the Peruvian government established the 2.5 million acre
Yavarí Tapiche Reserve for uncontacted peoples deep in the Amazon rainforest, the Naso people of Panama
secured their ancestral claim to 400,000 acres of some of the most pristine forests in Central America,
and a team of conservationists banded together to save a 234,000 acre biodiversity hotspot and wildlife
corridor at the intersection of Mexico, Belize and Guatemala.
19. Some of Australia’s most beautiful natural sites, including the Daintree, the oldest tropical
rainforest in the world, were returned to their traditional owners this year: four parks, covering
more than 160,000 hectares, will now be managed by the Eastern Kuku Yalanji people.
<a href="https://medium.com/media/a58042b3ab0869dc10bab54cef8b464a/href">https://medium.com/media/a58042b3ab0869dc10bab54cef8b464a/href</a>
20. In Montana, 18,000 acres of wildlife reserve, known as the National Bison Range, was formally
handed back to the Confederated Salish and Kootenai Tribes, and in Maine, the Passamaquoddy tribe
bought back their ancestral land of Pine Island.
21. Ecologists reported that the Mississippi River is the cleanest it’s been in more than a century,
with pollution down to 1% of what it was in the 1980s, while the most comprehensive survey of the
Thames in 60 years found that the river, once declared biologically dead, is now “home to myriad wildlife
as diverse as London itself.” The biggest river success story however, came from China, which passed
a landmark environmental law protecting the Yangtze, one of the country’s two ‘mother rivers,’ banning
all industrial projects, sand mining and all fishing, including in tributaries and the estuary (more
than 400 million people live in the Yangtze basin).
22. Glasgow gave the green light to create a massive urban forest consisting of 18 million trees,
a rewilding project in England that’s reclaimed 128,000 acres of industrial wasteland was reported
to have created 5,000 new jobs plus a new national forest, and half a million acres of the Scottish
Highlands were committed to being rewilded over the next 30 years, becoming Europe’s tenth official
rewilding area.
23. Indonesia reported that it has restored more than two million hectares of damaged, carbon-rich
peatlands in the six years since the toxic haze crisis of 2015, and last year, the country achieved
its fourth consecutive year of decline in deforestation. India announced a 25% increase in mangrove
cover since the 1980s thanks to restoration efforts, and China revealed that its coastal wetlands
have experienced a significant recovery in the last decade, thanks to several conservation projects
started back in the 1990s.
24. Africa’s largest tropical rainforest, Salonga National Park, was removed from UNESCO’s list of
threatened sites, following 20 years of sustained conservation work, and a new reserve dubbed the
‘ Amazon of Europe’, spanning Austria, Slovenia, Croatia, Hungary, and Serbia, received official UNESCO
heritage status, the first biosphere to cover five different countries.
25. Three years ago, Pakistan launched the Ten Billion Tree Tsunami, a plan to reforest vast swathes
of one of the most deforested countries in the world. Critics scoffed, but they’re being forced to
eat their words: the country has now planted 1.5 billion trees, and is also conducting one of the
biggest mangrove restoration projects in the world.
26. Three different sites — an Alaskan archipelago dubbed the ‘Rat Islands’, Lehua Island in Hawaii
and Redonda Isle in the Caribbean, were all declared rodent free this year after decades of conservation
efforts. In all three locations, the pace of ecosystem recovery and increase of native wildlife populations
has shocked even the most cynical of conservationists, shining examples of how quickly nature can
bounce back if given a chance.
27. A comprehensive plastic ban went into effect in China in January, including items like straws,
utensils, nondegradable bags and postal or courier packages, and in July, the EU banned single-use
plastic plates, cutlery, straws, balloon sticks and cotton buds. India announced a ban on a long list
of single plastics effective July 2022, the Maldives kicked off the first phase of a plan to completely
eliminate single plastics by 2023, and New Zealand announced that single-use plastics would be phased
out by 2025, with bans on cotton buds, packaging, cutlery, straws, and fruit labels beginning next
year. ABC
28. Barcelona announced a new scheme to give citizens free, unlimited public transport for three years
in return for giving up their private vehicles, Paris took back space from cars, opening linear parks
on old highways along the Seine, phasing out diesel cars, opening bus lanes, raising parking meter
prices and plowing bike lanes down hundreds of streets, and the UK’s second largest city, Birmingham
finalized a plan to divert car traffic out of the city and introducing zero-emissions cross-city buses,
cycle ways and pedestrian lanes.
29. Abortion rights were consistently in the news this year, for good reason: American women’s right
to a safe and legal abortion is in imminent danger of being taken away; Polish women have already
lost theirs. Amidst the legitimate alarm however, you might have missed the ‘green wave’ that swept
through Latin America in 2021. Argentina formally adopted a new law legalizing abortion during the
first 14 weeks of pregnancy, both Mexico and Ecuador decriminalized abortion, and Chile took its first
step towards legalization by expanding legislation that currently restricts the procedure to special
circumstances. Across Latin America it is now legal for women to choose what happens to their bodies
in Argentina, Ecuador, Uruguay, Cuba, Guyana, and three Mexican states.
30. Egypt’s cabinet toughened its laws on female genital mutilation, imposing jail terms of up to
20 years, and Somalia’s Puntland region outlawed the barbaric procedure. Pakistan abolished the outdated
practice of virginity tests on rape victims, Iran passed a new law protecting women against domestic
and other forms of gender-based violence, and Lebanon criminalized sexual harassment with a new landmark
law that drastically expanded its definition.
31. The Dominican Republic definitively banned child marriage this year. Previously, girls from the
age of 15 were allowed to marry, and 36% of Dominican girls married before the age of 18.
32. In the Philippines the minimum age of sexual consent was raised in September from 12 to 16 years
old, overturning a century-old law on statutory rape, a historic win for child rights advocates who
fought for this for years. France also took a major step forward in protecting children against sexual
abuse this year by setting the minimum age of sexual consent at 15, and made birth control free for
all women aged 25 and under.
33. New Zealand passed world-first legislation for paid bereavement for miscarriage, giving women
and their partners time off to grieve before returning to work, New York announced it would no longer
prosecute prostitution, and in Mexico the law was amended to give women with disabilities equal access
to protection from domestic violence.
34. In July, four women in South Africa successfully overturned a set of apartheid-era marriage laws,
giving around 400,000 elderly black women equal access to matrimonial property, and Uttarakhand became
the first state in India to grant women co-ownership of land, in a landmark amendment that affected
350,000 girls and women overnight.
35. Tanzania said it will allow pregnant girls and teen mothers to resume secondary education, overturning
a four year ban, women in Malaysia finally won the right to pass citizenship onto their children born
overseas, Saudi Arabia officially allowed single, divorced or widowed women to live independently
without permission from a male guardian, and a new law in the United Arab Emirates allowed non-Muslims
to marry, divorce and get joint child custody, making it the first Gulf country to reform marriage
laws formerly based on religious principles.
36. Same-sex relations were decriminalized in Angola, overturning a 134 year old colonial statute,
and in September, Switzerland became the 30th country to legalize gay marriage, followed by the 31st,
Chile, in December. Across Catholic Latin America, same-sex marriage is now legal in Costa Rica, Ecuador,
Colombia, Brazil, Uruguay, Argentina, and 23 of Mexico’s 32 states. Love is love.
That balloon by the way, says Gleiche Liebe, Gleiche Rechte… “Same love, same rights.” <a href="https://medium.com/media/f7242be104e8af2a703576c54384cf5a/href">https://medium.com/media/f7242be104e8af2a703576c54384cf5a/href</a>
37. Attitudes to sexuality can and do change, sometimes in the space of a single generation. Support
for same-sex marriage in the United States in 2021 reached an all time high of 70%, up from 60% in
2015 when it was legalized, and from 27% in 1996, when Gallup first started asking the question.
38. Attitudes to race can change too. In one of the largest shifts of public opinion ever recorded,
Gallup said this year that 94% of American adults now approve of interracial marriage, a huge leap
from 4% when the poll began in 1958. People over the age of 50 reported the biggest shift, increasing
their approval by 64% in the past 30 years.
39. Kazakhstan abolished the death penalty, making permanent a nearly two-decade freeze on capital
punishment in the authoritarian Central Asian country. More than two-thirds of the countries in the
world have now abolished the death penalty in law or practice, according to Amnesty International.
EJI
40. Kazakhastan also announced that it is officially nuclear free, after scientists ground down the
last 2.9 kilograms of highly enriched uranium, rendering it useless for bomb-making. The historic
moment comes after 30 years of denuclearization, and represents one of the least celebrated, yet most
successful examples of post-Cold War diplomacy.
41. The United Nations ratified the Treaty on the Prohibition of Nuclear Weapons this year, the first
ever global treaty to ban nuclear weapons and all activities related to them. It’s not the end of
nuclear weapons — none of the nuclear-capable countries signed on — but it is a historic milestone
in the decades long campaign by civil society groups for disarmament.
42. A new report on cluster munitions revealed that more than 110,000 landmines covering 135 km² were
destroyed globally last year, a new annual record, and that over a million landmines have been cleared
in
# --- truncated at 32 KB (94 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/talkwalker/refs/heads/main/openapi/talkwalker-search-openapi.yml