NAV
cURL

Intro to YonderAPI v1

YonderAPI provides access to functionalities developed by Yonder. The following suite of text and image analysis API services can be composed together into a pipelines to solve a variety of problems and create smarter applications and services in different verticals.

Authentication

To use YonderAPI you need to first register at our website and get your credentials, i.e. YOUR_ACCESS_TOKEN. YonderAPI expects for the credentials assigned in the registration process to be included in all API requests to the server.

API on Text Documents

The following set of API allows for extracting semantic information from Text Documents. If you need to create a Text Collection, i.e. a repository of metadata coming from multiple texts useful for analyzing inter-documents relations (e.g. for measuring document similarities), please refer below to YonderAPI Text Collections.

Text Summarization

Request example (summary from single text) - POST fromURL...

curl --ssl-reqd --request POST --data urls="https://www.theguardian.com/world/2016/jul/22/missing-flight-mh370-hunt-for-debris-will-not-be-extended" "https://api.yonderlabs.com/1.0/text/textsummarization/fromURL?nwords=100&access_token=YOUR_ACCESS_TOKEN"

... and response body (summary from single text) (200/JSON):

{
  "texts": [
    "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that it would “not end, but be suspended” if the completion of the two-year search of a 120,000 sq km arc of the southern Indian ocean west of Australia fails to yield any new evidence. Less than 10,000 sq km of that area remain, though progress is slow due to poor weather conditions. In a joint statement, the ministers acknowledged that “despite the best efforts of all involved, the likelihood of finding the aircraft is fading. “In the absence of credible new evidence leading to an identification of a specific location of the aircraft, the search would not end, but be suspended upon completion of the 120,000 sq km area.” Liow Tiong Lai, the Malaysian transport minister, told reporters that cost was not a factor in the decision. It was stressed that this did not mean the termination of the search, and that the aspiration to locate MH370 remained. But any next steps would be dependant on new information that could be used to identify the specific location of the aircraft. “We remain hopeful that the aircraft will be located,” said Darren Chester, the Australian minister for transport and infrastructure. The families of the 239 victims were informed before the press conference on Friday afternoon. Sumisha Naidu (@SumishaCNA)  This does not mean we have given up on the search for #MH370   - @liowtionglai pic.twitter.com/QrAi4ewYvF July 22, 2016 That the search would not be extended in the absence of any significant discovery has been consistently signalled by the Australian body in charge for more than a year. The Australian Transport Safety Bureau has led the underwater operation for the wreckage of the missing aircraft, which disappeared en route from Kuala Lumpur to Beijing in March 2014. Chester said in a statement on Thursday that the search had been “unprecedented in both size and scale, conducted in some of the world’s most isolated waters and at times in extremely challenging weather”. Progress on the final 10,000 or so sq km of the total search area – about the size of Greece – has been delayed by poor weather, meaning the search could extend into spring. In March, on the two-year anniversary of the plane’s disappearance, Martin Dolan, the head of the ATSB, said it was “very likely” the wreckage would be found within that area. But with that possibility dwindling with every square kilometre completed, experts have been forced to consider alternatives. The three countries agreed in April last year not to extend the search area beyond that 120,000 sq km. Paul Kennedy, the project director of Fugro – the Dutch company leading the search – acknowledged on Thursday that, if the plane was not found there, “it means it’s somewhere else”. The company later clarified that it believed the search area was the most probable place and as such the right place to search. But Richard Godfrey, a member of the so-called Independent Group of professionals conducting their own work to locate MH370, argued in a paper published earlier in July that the ATSB were looking in the wrong place. He identified a range of latitudes consistent with known data, ocean drift analyses and floating debris that was not captured in the priority search area. “The failure to find sunken wreckage ... is not surprising,” he wrote. “The underwater search has produced no results so far and the assumptions made in determining the ATSB priority search area should be re-examined.” To date, four pieces have been identified as almost certainly being from MH370, in addition to a wing flaperon found on La Réunion in July last year. A large piece of aircraft debris found on an island off the coast of Tanzania in June arrived in Canberra for examination earlier this week. It is thought to be a wing flap, but technical specialists from the ATSB are working with Malaysian investigators to determine whether it is from MH370. Map of search area"
  ],
  "nwords": 100,
  "ratio": null,
  "urls": [
    "https://www.theguardian.com/world/2016/jul/22/missing-flight-mh370-hunt-for-debris-will-not-be-extended"
  ],
  "summary": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. “In the absence of credible new evidence leading to an identification of a specific location of the aircraft, the search would not end, but be suspended upon completion of the 120,000 sq km area.” Liow Tiong Lai, the Malaysian transport minister, told reporters that cost was not a factor in the decision."
}

Request example (summary from multi texts) - POST fromURL...

curl --ssl-reqd --request POST --data urls="http://www.independent.co.uk/news/world/americas/donald-trump-climate-change-barack-obama-record-epa-global-warming-paris-agreement-carbon-emissions-a7653261.html" --data urls="https://www.theguardian.com/environment/2017/mar/28/trump-climate-change-executive-order-us-dominance-china" "https://api.yonderlabs.com/1.0/text/textsummarization/fromURL?ratio=0.1&access_token=YOUR_ACCESS_TOKEN"

... and response body (summary from multi texts) (200/JSON):

{
  "texts": [
"President Trump will take the most significant step yet in obliterating his predecessor’s environmental record on Tuesday, instructing federal regulators to rewrite key rules curbing US carbon emissions . The sweeping executive order also seeks to lift a moratorium on federal coal leasing and remove the requirement that federal officials consider the impact of climate change when making decisions. The order sends an unmistakable signal that just as President Barack Obama sought to weave climate considerations into every aspect of the federal government, Trump is hoping to rip that approach out by its roots. “This policy is in keeping with President Trump’s desire to make the United States energy independent,” said a senior administration official who briefed reporters on the directive Monday evening and asked for anonymity to speak in advance of the announcement. “When it comes to climate change, we want to take our course and do it in our own form and fashion.” Some of the measures could take years to implement and are unlikely to alter broader economic trends that are shifting the nation’s electricity mix from coal-fired generation to natural gas and renewables . The order is silent on whether the United States should withdraw from the 2015 Paris climate agreement, under which it has pledged to cut its greenhouse gas emissions between 26 and 28 percent by 2025 compared to 2005 levels, because the administration remains divided on that question. The order comes after several moves by Trump to roll back Obama-era restrictions on mining, drilling and coal- and gas-burning operations. In his first two months as president, Trump has nullified a regulation barring surface-mining companies from polluting waterways and set aside a new accounting system that would have compelled coal companies and other energy firms to pay more in federal royalties. The administration also has announced it will reconsider stricter fuel-efficiency standards for cars and light trucks and has approved two major oil pipelines, Dakota Access and Keystone XL , that Obama had halted. Accelerating fossil-fuel production on federal lands and sidelining climate considerations could lead to higher emissions of the greenhouse gases driving climate change and complicate a global effort to curb the world’s carbon output. But Trump has repeatedly questioned whether climate change is underway and emphasised that he is determined to deliver for the voters in coal country who helped him win the Oval Office. “He’s made a pledge to the coal industry and he’s going to do whatever he can to help those workers,” the senior administration official said. US coal jobs, which number about 75,000, have been declining for decades. The official did not predict how many jobs might be spurred by this shift in policy. The centerpiece of the new presidential directive, telling the Environmental Protection Agency  (EPA) to begin rewriting the 2015 regulation that limits greenhouse-gas emissions from existing power plants, will trigger a laborious rulemaking process and a possible legal fight. The agency must first get permission from the US Court of Appeals for the DC Circuit, where the rule is tied up in litigation, to revisit the matter. Then, agency officials will have to justify reaching the opposite conclusion of the Obama EPA, which argued it was technically feasible and legally warranted to reduce carbon pollution by about one-third by 2030, compared with 2005 levels. “So, for the president, even if he would like to revoke the Clean Power Plan, he doesn’t have legal authority to do that,” said Jeffrey Holmstead, a partner at the Bracewell law firm who opposes the Obama-era rule. Holmstead, who headed the EPA’s air and radiation office under President George W. Bush, said he thinks the agency can justify reversing the regulation. But “they have to justify why they have changed,” he added. While environmental groups decried Trump’s move, mining officials welcomed it as an important course correction in federal energy policy. “This rule was an unlawful attempt to radically transform the nation’s power grid, destroying valuable energy assets and leaving our economy more vulnerable to rising power prices - all for an insignificant environmental benefit,” said Hal Quinn, president and chief executive of the National Mining Association. Environmentalists vowed to fight the executive order in court and press ahead with their goals on the state level. David Doniger, director of the Natural Resources Defense Council’s climate and clean-air programme, said unwinding the Clean Power Plan will not happen quickly, no matter what the president wants. “Tearing the rules down require going through the same process it took to build them up,” Doniger said. “We will make them face the music at every step.” Christopher Field, a professor at Stanford University’s Wood Institute for the Environment, said in an email that the directive carries long-term risks, rather than immediate ones. “Some are risks from eroding the position of US companies in the clean energy sector,” Field said. “Others are from the loss of irreplaceable natural heritage that is put in jeopardy by ill-conceived policies.” The President will also instruct the Interior Department to rewrite a 2015 rule, currently stayed in court, that imposes restrictions on hydraulic fracturing on federal and tribal lands. The directive will also make it easier to flare methane in oil and gas operations on federal land, by triggering the review of a rule the Interior Department finalised in November. Other aspects of the executive order can take effect immediately, though it is unclear how quickly they will translate into greater coal extraction. One section overturns a 2016 White House directive to consider climate change when agencies conduct reviews under the National Environmental Policy Act, a sweeping law that informed any federal decisions that have a significant environmental impact. Another provision instructs Interior’s Bureau of Land Management to lift a freeze on federal coal leasing. That moratorium has been in effect since December 2015. Tom Sanzillo, director of finance for the Institute for Energy Economics and Financial Analysis, said in an interview that the move “becomes a largely politically symbolic measure for right now” because other, lower-carbon sources of energy are out-competing coal. He noted that US coal consumption has declined 27 percent since 2005, from 1.02 billion tonnes to 739 million tonnes in 2016, its lowest level in nearly four decades. “They’re not going to reverse the fundamental economic law here,” Sanzillo said. “There’s no market signal that’s telling them they should be mining more coal.” Still, regulatory relief could make some coal firms, nearly 50 of which have filed for bankruptcy since 2012, somewhat more economically viable. Some of the sector’s biggest companies - including Arch Coal, Peabody Energy and Alpha Natural Resources - are just now emerging from bankruptcy protection. Ethan Zindler, head of US research at Bloomberg New Energy Finance, said in an email that solar and wind are competitive with coal in some parts of the country and that natural gas ranks as the lowest-cost source of electricity generation overall. The sector that could suffer the greatest hit from the elimination of the Clean Power Plan is nuclear energy, which provides about a fifth of US businesses’ and households’ power. “Many of the 100 or so US plants are ageing, and approximately a third are economically uncompetitive today,” Zindler said. Without stricter federal emissions limits, he added, “there may be little to stop the retirement of these plants in coming years and their replacement with a combination of gas, wind and solar.” Separately, Trump has instructed federal officials to abandon the practice of factoring in the impact of climate change - what is dubbed “the social cost of carbon” - in their policymaking decisions. That calculus, which is currently set at 36 dollars per ton of carbon dioxide, aims to capture the negative consequences of allowing greenhouse-gas emissions to continue to rise. But some conservatives have criticised it as too sweeping. Federal officials will return to the traditional cost-benefit analysis the George W. Bush administration adopted nearly 15 years ago, which has a much lower cost associated with carbon emissions. As Trump seeks to scale back federal limits on greenhouse gas emissions, states and cities are likely to take on a larger role in charting the course forward. An analysis by the Rhodium Group, an economic consulting firm, found that Trump’s forthcoming executive order would slow the country’s shift away from carbon-emitting sources of energy. It found after Trump’s action, the United States would be 14 percent below its 2005 emissions levels by 2025, compared to 21 percent below that mark had current Obama-era policies remained in place. 10 photographs to show to anyone who doesn't believe in climate change 10 photographs to show to anyone who doesn't believe in climate change 1/10 2/10 Amid a flood in Islampur, Jamalpur, Bangladesh, a woman on a raft searches for somewhere dry to take shelter. Bangladesh is one of the most vulnerable places in the world to sea level rise, which is expected to make tens of millions of people homeless by 2050. 3/10 Hanna Petursdottir examines a cave inside the Svinafellsjokull glacier in Iceland, which she said had been growing rapidly. Since 2000, the size of glaciers on Iceland has reduced by 12 per cent. 4/10 Floods destroyed eight bridges and ruined crops such as wheat, maize and peas in the Karimabad valley in northern Pakistan, a mountainous region with many glaciers. In many parts of the world, glaciers have been in retreat, creating dangerously large lakes that can cause devastating flooding when the banks break. Climate change can also increase rainfall in some areas, while bringing drought to others. 5/10 Smoke – filled with the carbon that is driving climate change – drifts across a field in Colombia. A river once flowed along the depression in the dry earth of this part of Bangladesh, but it has disappeared amid rising temperatures. 7/10 Sindh province in Pakistan has experienced a grim mix of two consequences of climate change. “Because of climate change either we have floods or not enough water to irrigate our crop and feed our animals,” says the photographer. “Picture clearly indicates that the extreme drought makes wide cracks in clay. Crops are very difficult to grow.” 8/10 A shepherd moves his herd as he looks for green pasture near the village of Sirohi in Rajasthan, northern India. The region has been badly affected by heatwaves and drought, making local people nervous about further predicted increases in temperature. Riddhima Singh Bhati 9/10 A factory in China is shrouded by a haze of air pollution. The World Health Organisation has warned such pollution, much of which is from the fossil fuels that cause climate change, is a “public health emergency”. Leung Ka Wa 10/10 Water levels in reservoirs, like this one in Gers, France, have been getting perilously low in areas across the world affected by drought, forcing authorities to introduce water restrictions. Mahtuf Ikhsan Tim Profeta, who directs Duke University’s Nicholas Institute for Environmental Policy Solutions, said regulators from more than half-dozen states in the Southeast are now talking about how to chart their own path forward. Having met for nearly three years, the group stopped discussing how to comply with the Clean Power Plan after November’s election, but it is still talking. “We are now talking about the evolution of the power sector in an environment of uncertainty,” Profeta said in an interview. “We’re seeing the beginning of states taking control of their destiny.”",
    "Is Donald Trump’s determination to send US climate change policy back into the dark ages an “existential threat to the entire planet”, as the architect of many of Barack Obama’s green measures warns? Or is global momentum towards a cleaner, safer future “ unstoppable ”, as the UN’s climate chief said recently? Trump begins tearing up Obama's years of progress on tackling climate change Read more The answer lies somewhere in between and you can choose your point on that scale according to your optimism about whether society, governments and businesses will together rise to the challenge of beating global warming. One thing is clear, however: the slash-and-burn of federal climate action in the US is making one of humanity’s greatest ever challenges more difficult, just at the time when it needs to start getting easier. There are lots of possible pathways to the zero-emission global economy needed in the second half of this century to avoid the “ severe, widespread and irreversible impacts ” warned of by the world’s scientists. But the best is to start early, with global carbon emissions starting to fall by 2020. Encouragingly, emissions from fossil fuels seem to have levelled off in the past three years. However, Trump’s executive order undoing Obama’s clean power plan (CPP), alongside reversals making driving and fracking more polluting , might halt that progress. The US is the world’s second biggest emitter, pumping out 14% of global carbon dioxide, and canning the CPP could leave emissions 25% higher than otherwise. But there are good reasons to think that scrapping the CPP may fall a long way short of delivering the huge coal revival Trump has promised. Even the coal barons themselves don’t see that happening . Across the decades that energy investments stretch, the global move is clearly towards low-carbon and around the world coal is in freefall . A Trump blip is highly unlikely to see companies make billion-dollar bets on coal. Furthermore, with the costs of solar and wind power plummeting by 85% and 66% respectively since 2009 , many US states and cities see clean energy as the future, whatever the current federal administration thinks. As Trump’s healthcare and travel ban fiascos show, doing is a lot harder than tweeting. So while his climate assault is unlikely by itself to condemn the world to runaway global warming, it will make it tougher to tame. However, the rest of the world’s nations are not going to give up just because the US is choosing to free-ride on their efforts to halt climate change. At the annual UN climate summit in late November, Trump’s election win strengthened their determination to act, not weakened it. “It really concentrated the minds of 180 of the world’s countries to get on,” one senior delegate told me. Science is concentrating minds, too. Recent work shows the fast-heating Earth is now in “uncharted territory” , and just on Monday “human fingerprints” were revealed on extreme weather disasters around the world. The US has brought a great deal to the international climate effort: billions of dollars of funding that helped persuade poorer nations to accept the landmark deal in Paris in 2015, as well as world-leading scientific observation and research. Trump may pull all that from the table, but there are plenty of other players ready to step up, not least the European Union and China. China, the world’s biggest polluter, is now taking dramatic action to cut emissions, pushed by the foul air many of its citizens suffer and pulled by the likelihood of the low-carbon economy being the greatest growth story of the 21st century. John Podesta, the former Obama chief of staff who warns of Trump’s “existential threat” , is nonetheless far from despondent: “This threat alone is no reason to give up hope that we can still avert the most severe impacts of climate change. If the US cedes its leadership in the global movement to curb greenhouse gas pollution, other major powers, most notably China, are primed to dominate the coming clean energy economy.” It is also far from fanciful to imagine other nations penalising future US goods if they are produced with dirty energy. Politicians are already talking about such border carbon taxes and might point to the astronomical tariffs the US imposes on imports of which it disapproves, such as Chinese steel. It is doubtful that Trump’s blitzkrieg on “bullshit” climate change will herald the end of civilisation. But, given the issue’s critical importance for all nations and their unprecedented cooperation to date, it might just signal the end of the US’s dominance as the world’s pre-eminent political and economic power, with others taking up the mantle. Trump’s campaign pledge was “Make America great again” – his legacy could be “ Made China great again ”."
  ],
  "nwords": 150,
  "ratio": 0.1,
  "urls": [
    "http://www.independent.co.uk/news/world/americas/donald-trump-climate-change-barack-obama-record-epa-global-warming-paris-agreement-carbon-emissions-a7653261.html",
    "https://www.theguardian.com/environment/2017/mar/28/trump-climate-change-executive-order-us-dominance-china"
  ],
  "summary": "The sweeping executive order also seeks to lift a moratorium on federal coal leasing and remove the requirement that federal officials consider the impact of climate change when making decisions. “When it comes to climate change, we want to take our course and do it in our own form and fashion.” Some of the measures could take years to implement and are unlikely to alter broader economic trends that are shifting the nation’s electricity mix from coal-fired generation to natural gas and renewables . The order is silent on whether the United States should withdraw from the 2015 Paris climate agreement, under which it has pledged to cut its greenhouse gas emissions between 26 and 28 percent by 2025 compared to 2005 levels, because the administration remains divided on that question. Accelerating fossil-fuel production on federal lands and sidelining climate considerations could lead to higher emissions of the greenhouse gases driving climate change and complicate a global effort to curb the world’s carbon output. Without stricter federal emissions limits, he added, “there may be little to stop the retirement of these plants in coming years and their replacement with a combination of gas, wind and solar.” Separately, Trump has instructed federal officials to abandon the practice of factoring in the impact of climate change - what is dubbed “the social cost of carbon” - in their policymaking decisions. Is Donald Trump’s determination to send US climate change policy back into the dark ages an “existential threat to the entire planet”, as the architect of many of Barack Obama’s green measures warns? Trump begins tearing up Obama's years of progress on tackling climate change Read more The answer lies somewhere in between and you can choose your point on that scale according to your optimism about whether society, governments and businesses will together rise to the challenge of beating global warming. If the US cedes its leadership in the global movement to curb greenhouse gas pollution, other major powers, most notably China, are primed to dominate the coming clean energy economy.” It is also far from fanciful to imagine other nations penalising future US goods if they are produced with dirty energy."
}

Request example (summary from single text) - POST fromText...

curl --ssl-reqd --request POST --data texts="The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that it would “not end, but be suspended” if the completion of the two-year search of a 120,000 sq km arc of the southern Indian ocean west of Australia fails to yield any new evidence. Less than 10,000 sq km of that area remain, though progress is slow due to poor weather conditions. In a joint statement, the ministers acknowledged that “despite the best efforts of all involved, the likelihood of finding the aircraft is fading. “In the absence of credible new evidence leading to an identification of a specific location of the aircraft, the search would not end, but be suspended upon completion of the 120,000 sq km area.” Liow Tiong Lai, the Malaysian transport minister, told reporters that cost was not a factor in the decision. It was stressed that this did not mean the termination of the search, and that the aspiration to locate MH370 remained. But any next steps would be dependant on new information that could be used to identify the specific location of the aircraft. “We remain hopeful that the aircraft will be located,” said Darren Chester, the Australian minister for transport and infrastructure. The families of the 239 victims were informed before the press conference on Friday afternoon. Sumisha Naidu (@SumishaCNA)  This does not mean we have given up on the search for #MH370   - @liowtionglai pic.twitter.com/QrAi4ewYvF July 22, 2016 That the search would not be extended in the absence of any significant discovery has been consistently signalled by the Australian body in charge for more than a year. The Australian Transport Safety Bureau has led the underwater operation for the wreckage of the missing aircraft, which disappeared en route from Kuala Lumpur to Beijing in March 2014. Chester said in a statement on Thursday that the search had been “unprecedented in both size and scale, conducted in some of the world’s most isolated waters and at times in extremely challenging weather”. Progress on the final 10,000 or so sq km of the total search area – about the size of Greece – has been delayed by poor weather, meaning the search could extend into spring. In March, on the two-year anniversary of the plane’s disappearance, Martin Dolan, the head of the ATSB, said it was “very likely” the wreckage would be found within that area. But with that possibility dwindling with every square kilometre completed, experts have been forced to consider alternatives. The three countries agreed in April last year not to extend the search area beyond that 120,000 sq km. Paul Kennedy, the project director of Fugro – the Dutch company leading the search – acknowledged on Thursday that, if the plane was not found there, “it means it’s somewhere else”. The company later clarified that it believed the search area was the most probable place and as such the right place to search. But Richard Godfrey, a member of the so-called Independent Group of professionals conducting their own work to locate MH370, argued in a paper published earlier in July that the ATSB were looking in the wrong place. He identified a range of latitudes consistent with known data, ocean drift analyses and floating debris that was not captured in the priority search area. “The failure to find sunken wreckage ... is not surprising,” he wrote. “The underwater search has produced no results so far and the assumptions made in determining the ATSB priority search area should be re-examined.” To date, four pieces have been identified as almost certainly being from MH370, in addition to a wing flaperon found on La Réunion in July last year. A large piece of aircraft debris found on an island off the coast of Tanzania in June arrived in Canberra for examination earlier this week. It is thought to be a wing flap, but technical specialists from the ATSB are working with Malaysian investigators to determine whether it is from MH370. Map of search area" "https://api.yonderlabs.com/1.0/text/textsummarization/fromText?nwords=100&access_token=YOUR_ACCESS_TOKEN"

... and response body (summary from single text) (200/JSON):

{
  "texts": [
    "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that it would “not end, but be suspended” if the completion of the two-year search of a 120,000 sq km arc of the southern Indian ocean west of Australia fails to yield any new evidence. Less than 10,000 sq km of that area remain, though progress is slow due to poor weather conditions. In a joint statement, the ministers acknowledged that “despite the best efforts of all involved, the likelihood of finding the aircraft is fading. “In the absence of credible new evidence leading to an identification of a specific location of the aircraft, the search would not end, but be suspended upon completion of the 120,000 sq km area.” Liow Tiong Lai, the Malaysian transport minister, told reporters that cost was not a factor in the decision. It was stressed that this did not mean the termination of the search, and that the aspiration to locate MH370 remained. But any next steps would be dependant on new information that could be used to identify the specific location of the aircraft. “We remain hopeful that the aircraft will be located,” said Darren Chester, the Australian minister for transport and infrastructure. The families of the 239 victims were informed before the press conference on Friday afternoon. Sumisha Naidu (@SumishaCNA)  This does not mean we have given up on the search for #MH370   - @liowtionglai pic.twitter.com/QrAi4ewYvF July 22, 2016 That the search would not be extended in the absence of any significant discovery has been consistently signalled by the Australian body in charge for more than a year. The Australian Transport Safety Bureau has led the underwater operation for the wreckage of the missing aircraft, which disappeared en route from Kuala Lumpur to Beijing in March 2014. Chester said in a statement on Thursday that the search had been “unprecedented in both size and scale, conducted in some of the world’s most isolated waters and at times in extremely challenging weather”. Progress on the final 10,000 or so sq km of the total search area – about the size of Greece – has been delayed by poor weather, meaning the search could extend into spring. In March, on the two-year anniversary of the plane’s disappearance, Martin Dolan, the head of the ATSB, said it was “very likely” the wreckage would be found within that area. But with that possibility dwindling with every square kilometre completed, experts have been forced to consider alternatives. The three countries agreed in April last year not to extend the search area beyond that 120,000 sq km. Paul Kennedy, the project director of Fugro – the Dutch company leading the search – acknowledged on Thursday that, if the plane was not found there, “it means it’s somewhere else”. The company later clarified that it believed the search area was the most probable place and as such the right place to search. But Richard Godfrey, a member of the so-called Independent Group of professionals conducting their own work to locate MH370, argued in a paper published earlier in July that the ATSB were looking in the wrong place. He identified a range of latitudes consistent with known data, ocean drift analyses and floating debris that was not captured in the priority search area. “The failure to find sunken wreckage ... is not surprising,” he wrote. “The underwater search has produced no results so far and the assumptions made in determining the ATSB priority search area should be re-examined.” To date, four pieces have been identified as almost certainly being from MH370, in addition to a wing flaperon found on La Réunion in July last year. A large piece of aircraft debris found on an island off the coast of Tanzania in June arrived in Canberra for examination earlier this week. It is thought to be a wing flap, but technical specialists from the ATSB are working with Malaysian investigators to determine whether it is from MH370. Map of search area"
  ],
  "nwords": 100,
  "ratio": null,
  "urls": null,
  "summary": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. “In the absence of credible new evidence leading to an identification of a specific location of the aircraft, the search would not end, but be suspended upon completion of the 120,000 sq km area.” Liow Tiong Lai, the Malaysian transport minister, told reporters that cost was not a factor in the decision."
}

Request example (summary from multi texts) - POST fromText...

curl --ssl-reqd --request POST --data texts="President Trump will take the most significant step yet in obliterating his predecessor’s environmental record on Tuesday, instructing federal regulators to rewrite key rules curbing US carbon emissions . The sweeping executive order also seeks to lift a moratorium on federal coal leasing and remove the requirement that federal officials consider the impact of climate change when making decisions. The order sends an unmistakable signal that just as President Barack Obama sought to weave climate considerations into every aspect of the federal government, Trump is hoping to rip that approach out by its roots. “This policy is in keeping with President Trump’s desire to make the United States energy independent,” said a senior administration official who briefed reporters on the directive Monday evening and asked for anonymity to speak in advance of the announcement. “When it comes to climate change, we want to take our course and do it in our own form and fashion.” Some of the measures could take years to implement and are unlikely to alter broader economic trends that are shifting the nation’s electricity mix from coal-fired generation to natural gas and renewables . The order is silent on whether the United States should withdraw from the 2015 Paris climate agreement, under which it has pledged to cut its greenhouse gas emissions between 26 and 28 percent by 2025 compared to 2005 levels, because the administration remains divided on that question. The order comes after several moves by Trump to roll back Obama-era restrictions on mining, drilling and coal- and gas-burning operations. In his first two months as president, Trump has nullified a regulation barring surface-mining companies from polluting waterways and set aside a new accounting system that would have compelled coal companies and other energy firms to pay more in federal royalties. The administration also has announced it will reconsider stricter fuel-efficiency standards for cars and light trucks and has approved two major oil pipelines, Dakota Access and Keystone XL , that Obama had halted. Accelerating fossil-fuel production on federal lands and sidelining climate considerations could lead to higher emissions of the greenhouse gases driving climate change and complicate a global effort to curb the world’s carbon output. But Trump has repeatedly questioned whether climate change is underway and emphasised that he is determined to deliver for the voters in coal country who helped him win the Oval Office. “He’s made a pledge to the coal industry and he’s going to do whatever he can to help those workers,” the senior administration official said. US coal jobs, which number about 75,000, have been declining for decades. The official did not predict how many jobs might be spurred by this shift in policy. The centerpiece of the new presidential directive, telling the Environmental Protection Agency  (EPA) to begin rewriting the 2015 regulation that limits greenhouse-gas emissions from existing power plants, will trigger a laborious rulemaking process and a possible legal fight. The agency must first get permission from the US Court of Appeals for the DC Circuit, where the rule is tied up in litigation, to revisit the matter. Then, agency officials will have to justify reaching the opposite conclusion of the Obama EPA, which argued it was technically feasible and legally warranted to reduce carbon pollution by about one-third by 2030, compared with 2005 levels. “So, for the president, even if he would like to revoke the Clean Power Plan, he doesn’t have legal authority to do that,” said Jeffrey Holmstead, a partner at the Bracewell law firm who opposes the Obama-era rule. Holmstead, who headed the EPA’s air and radiation office under President George W. Bush, said he thinks the agency can justify reversing the regulation. But “they have to justify why they have changed,” he added. While environmental groups decried Trump’s move, mining officials welcomed it as an important course correction in federal energy policy. “This rule was an unlawful attempt to radically transform the nation’s power grid, destroying valuable energy assets and leaving our economy more vulnerable to rising power prices - all for an insignificant environmental benefit,” said Hal Quinn, president and chief executive of the National Mining Association. Environmentalists vowed to fight the executive order in court and press ahead with their goals on the state level. David Doniger, director of the Natural Resources Defense Council’s climate and clean-air programme, said unwinding the Clean Power Plan will not happen quickly, no matter what the president wants. “Tearing the rules down require going through the same process it took to build them up,” Doniger said. “We will make them face the music at every step.” Christopher Field, a professor at Stanford University’s Wood Institute for the Environment, said in an email that the directive carries long-term risks, rather than immediate ones. “Some are risks from eroding the position of US companies in the clean energy sector,” Field said. “Others are from the loss of irreplaceable natural heritage that is put in jeopardy by ill-conceived policies.” The President will also instruct the Interior Department to rewrite a 2015 rule, currently stayed in court, that imposes restrictions on hydraulic fracturing on federal and tribal lands. The directive will also make it easier to flare methane in oil and gas operations on federal land, by triggering the review of a rule the Interior Department finalised in November. Other aspects of the executive order can take effect immediately, though it is unclear how quickly they will translate into greater coal extraction. One section overturns a 2016 White House directive to consider climate change when agencies conduct reviews under the National Environmental Policy Act, a sweeping law that informed any federal decisions that have a significant environmental impact. Another provision instructs Interior’s Bureau of Land Management to lift a freeze on federal coal leasing. That moratorium has been in effect since December 2015. Tom Sanzillo, director of finance for the Institute for Energy Economics and Financial Analysis, said in an interview that the move “becomes a largely politically symbolic measure for right now” because other, lower-carbon sources of energy are out-competing coal. He noted that US coal consumption has declined 27 percent since 2005, from 1.02 billion tonnes to 739 million tonnes in 2016, its lowest level in nearly four decades. “They’re not going to reverse the fundamental economic law here,” Sanzillo said. “There’s no market signal that’s telling them they should be mining more coal.” Still, regulatory relief could make some coal firms, nearly 50 of which have filed for bankruptcy since 2012, somewhat more economically viable. Some of the sector’s biggest companies - including Arch Coal, Peabody Energy and Alpha Natural Resources - are just now emerging from bankruptcy protection. Ethan Zindler, head of US research at Bloomberg New Energy Finance, said in an email that solar and wind are competitive with coal in some parts of the country and that natural gas ranks as the lowest-cost source of electricity generation overall. The sector that could suffer the greatest hit from the elimination of the Clean Power Plan is nuclear energy, which provides about a fifth of US businesses’ and households’ power. “Many of the 100 or so US plants are ageing, and approximately a third are economically uncompetitive today,” Zindler said. Without stricter federal emissions limits, he added, “there may be little to stop the retirement of these plants in coming years and their replacement with a combination of gas, wind and solar.” Separately, Trump has instructed federal officials to abandon the practice of factoring in the impact of climate change - what is dubbed “the social cost of carbon” - in their policymaking decisions. That calculus, which is currently set at 36 dollars per ton of carbon dioxide, aims to capture the negative consequences of allowing greenhouse-gas emissions to continue to rise. But some conservatives have criticised it as too sweeping. Federal officials will return to the traditional cost-benefit analysis the George W. Bush administration adopted nearly 15 years ago, which has a much lower cost associated with carbon emissions. As Trump seeks to scale back federal limits on greenhouse gas emissions, states and cities are likely to take on a larger role in charting the course forward. An analysis by the Rhodium Group, an economic consulting firm, found that Trump’s forthcoming executive order would slow the country’s shift away from carbon-emitting sources of energy. It found after Trump’s action, the United States would be 14 percent below its 2005 emissions levels by 2025, compared to 21 percent below that mark had current Obama-era policies remained in place. 10 photographs to show to anyone who doesn't believe in climate change 10 photographs to show to anyone who doesn't believe in climate change 1/10 2/10 Amid a flood in Islampur, Jamalpur, Bangladesh, a woman on a raft searches for somewhere dry to take shelter. Bangladesh is one of the most vulnerable places in the world to sea level rise, which is expected to make tens of millions of people homeless by 2050. 3/10 Hanna Petursdottir examines a cave inside the Svinafellsjokull glacier in Iceland, which she said had been growing rapidly. Since 2000, the size of glaciers on Iceland has reduced by 12 per cent. 4/10 Floods destroyed eight bridges and ruined crops such as wheat, maize and peas in the Karimabad valley in northern Pakistan, a mountainous region with many glaciers. In many parts of the world, glaciers have been in retreat, creating dangerously large lakes that can cause devastating flooding when the banks break. Climate change can also increase rainfall in some areas, while bringing drought to others. 5/10 Smoke – filled with the carbon that is driving climate change – drifts across a field in Colombia. A river once flowed along the depression in the dry earth of this part of Bangladesh, but it has disappeared amid rising temperatures. 7/10 Sindh province in Pakistan has experienced a grim mix of two consequences of climate change. “Because of climate change either we have floods or not enough water to irrigate our crop and feed our animals,” says the photographer. “Picture clearly indicates that the extreme drought makes wide cracks in clay. Crops are very difficult to grow.” 8/10 A shepherd moves his herd as he looks for green pasture near the village of Sirohi in Rajasthan, northern India. The region has been badly affected by heatwaves and drought, making local people nervous about further predicted increases in temperature. Riddhima Singh Bhati 9/10 A factory in China is shrouded by a haze of air pollution. The World Health Organisation has warned such pollution, much of which is from the fossil fuels that cause climate change, is a “public health emergency”. Leung Ka Wa 10/10 Water levels in reservoirs, like this one in Gers, France, have been getting perilously low in areas across the world affected by drought, forcing authorities to introduce water restrictions. Mahtuf Ikhsan Tim Profeta, who directs Duke University’s Nicholas Institute for Environmental Policy Solutions, said regulators from more than half-dozen states in the Southeast are now talking about how to chart their own path forward. Having met for nearly three years, the group stopped discussing how to comply with the Clean Power Plan after November’s election, but it is still talking. “We are now talking about the evolution of the power sector in an environment of uncertainty,” Profeta said in an interview. “We’re seeing the beginning of states taking control of their destiny.”" --data texts="Is Donald Trump’s determination to send US climate change policy back into the dark ages an “existential threat to the entire planet”, as the architect of many of Barack Obama’s green measures warns? Or is global momentum towards a cleaner, safer future “ unstoppable ”, as the UN’s climate chief said recently? Trump begins tearing up Obama's years of progress on tackling climate change Read more The answer lies somewhere in between and you can choose your point on that scale according to your optimism about whether society, governments and businesses will together rise to the challenge of beating global warming. One thing is clear, however: the slash-and-burn of federal climate action in the US is making one of humanity’s greatest ever challenges more difficult, just at the time when it needs to start getting easier. There are lots of possible pathways to the zero-emission global economy needed in the second half of this century to avoid the “ severe, widespread and irreversible impacts ” warned of by the world’s scientists. But the best is to start early, with global carbon emissions starting to fall by 2020. Encouragingly, emissions from fossil fuels seem to have levelled off in the past three years. However, Trump’s executive order undoing Obama’s clean power plan (CPP), alongside reversals making driving and fracking more polluting , might halt that progress. The US is the world’s second biggest emitter, pumping out 14% of global carbon dioxide, and canning the CPP could leave emissions 25% higher than otherwise. But there are good reasons to think that scrapping the CPP may fall a long way short of delivering the huge coal revival Trump has promised. Even the coal barons themselves don’t see that happening . Across the decades that energy investments stretch, the global move is clearly towards low-carbon and around the world coal is in freefall . A Trump blip is highly unlikely to see companies make billion-dollar bets on coal. Furthermore, with the costs of solar and wind power plummeting by 85% and 66% respectively since 2009 , many US states and cities see clean energy as the future, whatever the current federal administration thinks. As Trump’s healthcare and travel ban fiascos show, doing is a lot harder than tweeting. So while his climate assault is unlikely by itself to condemn the world to runaway global warming, it will make it tougher to tame. However, the rest of the world’s nations are not going to give up just because the US is choosing to free-ride on their efforts to halt climate change. At the annual UN climate summit in late November, Trump’s election win strengthened their determination to act, not weakened it. “It really concentrated the minds of 180 of the world’s countries to get on,” one senior delegate told me. Science is concentrating minds, too. Recent work shows the fast-heating Earth is now in “uncharted territory” , and just on Monday “human fingerprints” were revealed on extreme weather disasters around the world. The US has brought a great deal to the international climate effort: billions of dollars of funding that helped persuade poorer nations to accept the landmark deal in Paris in 2015, as well as world-leading scientific observation and research. Trump may pull all that from the table, but there are plenty of other players ready to step up, not least the European Union and China. China, the world’s biggest polluter, is now taking dramatic action to cut emissions, pushed by the foul air many of its citizens suffer and pulled by the likelihood of the low-carbon economy being the greatest growth story of the 21st century. John Podesta, the former Obama chief of staff who warns of Trump’s “existential threat” , is nonetheless far from despondent: “This threat alone is no reason to give up hope that we can still avert the most severe impacts of climate change. If the US cedes its leadership in the global movement to curb greenhouse gas pollution, other major powers, most notably China, are primed to dominate the coming clean energy economy.” It is also far from fanciful to imagine other nations penalising future US goods if they are produced with dirty energy. Politicians are already talking about such border carbon taxes and might point to the astronomical tariffs the US imposes on imports of which it disapproves, such as Chinese steel. It is doubtful that Trump’s blitzkrieg on “bullshit” climate change will herald the end of civilisation. But, given the issue’s critical importance for all nations and their unprecedented cooperation to date, it might just signal the end of the US’s dominance as the world’s pre-eminent political and economic power, with others taking up the mantle. Trump’s campaign pledge was “Make America great again” – his legacy could be “ Made China great again ”." "https://api.yonderlabs.com/1.0/text/textsummarization/fromText?ratio=0.1&access_token=YOUR_ACCESS_TOKEN"

... and response body (summary from multi texts) (200/JSON):

{
  "texts": [
    "President Trump will take the most significant step yet in obliterating his predecessor’s environmental record on Tuesday, instructing federal regulators to rewrite key rules curbing US carbon emissions . The sweeping executive order also seeks to lift a moratorium on federal coal leasing and remove the requirement that federal officials consider the impact of climate change when making decisions. The order sends an unmistakable signal that just as President Barack Obama sought to weave climate considerations into every aspect of the federal government, Trump is hoping to rip that approach out by its roots. “This policy is in keeping with President Trump’s desire to make the United States energy independent,” said a senior administration official who briefed reporters on the directive Monday evening and asked for anonymity to speak in advance of the announcement. “When it comes to climate change, we want to take our course and do it in our own form and fashion.” Some of the measures could take years to implement and are unlikely to alter broader economic trends that are shifting the nation’s electricity mix from coal-fired generation to natural gas and renewables . The order is silent on whether the United States should withdraw from the 2015 Paris climate agreement, under which it has pledged to cut its greenhouse gas emissions between 26 and 28 percent by 2025 compared to 2005 levels, because the administration remains divided on that question. The order comes after several moves by Trump to roll back Obama-era restrictions on mining, drilling and coal- and gas-burning operations. In his first two months as president, Trump has nullified a regulation barring surface-mining companies from polluting waterways and set aside a new accounting system that would have compelled coal companies and other energy firms to pay more in federal royalties. The administration also has announced it will reconsider stricter fuel-efficiency standards for cars and light trucks and has approved two major oil pipelines, Dakota Access and Keystone XL , that Obama had halted. Accelerating fossil-fuel production on federal lands and sidelining climate considerations could lead to higher emissions of the greenhouse gases driving climate change and complicate a global effort to curb the world’s carbon output. But Trump has repeatedly questioned whether climate change is underway and emphasised that he is determined to deliver for the voters in coal country who helped him win the Oval Office. “He’s made a pledge to the coal industry and he’s going to do whatever he can to help those workers,” the senior administration official said. US coal jobs, which number about 75,000, have been declining for decades. The official did not predict how many jobs might be spurred by this shift in policy. The centerpiece of the new presidential directive, telling the Environmental Protection Agency  (EPA) to begin rewriting the 2015 regulation that limits greenhouse-gas emissions from existing power plants, will trigger a laborious rulemaking process and a possible legal fight. The agency must first get permission from the US Court of Appeals for the DC Circuit, where the rule is tied up in litigation, to revisit the matter. Then, agency officials will have to justify reaching the opposite conclusion of the Obama EPA, which argued it was technically feasible and legally warranted to reduce carbon pollution by about one-third by 2030, compared with 2005 levels. “So, for the president, even if he would like to revoke the Clean Power Plan, he doesn’t have legal authority to do that,” said Jeffrey Holmstead, a partner at the Bracewell law firm who opposes the Obama-era rule. Holmstead, who headed the EPA’s air and radiation office under President George W. Bush, said he thinks the agency can justify reversing the regulation. But “they have to justify why they have changed,” he added. While environmental groups decried Trump’s move, mining officials welcomed it as an important course correction in federal energy policy. “This rule was an unlawful attempt to radically transform the nation’s power grid, destroying valuable energy assets and leaving our economy more vulnerable to rising power prices - all for an insignificant environmental benefit,” said Hal Quinn, president and chief executive of the National Mining Association. Environmentalists vowed to fight the executive order in court and press ahead with their goals on the state level. David Doniger, director of the Natural Resources Defense Council’s climate and clean-air programme, said unwinding the Clean Power Plan will not happen quickly, no matter what the president wants. “Tearing the rules down require going through the same process it took to build them up,” Doniger said. “We will make them face the music at every step.” Christopher Field, a professor at Stanford University’s Wood Institute for the Environment, said in an email that the directive carries long-term risks, rather than immediate ones. “Some are risks from eroding the position of US companies in the clean energy sector,” Field said. “Others are from the loss of irreplaceable natural heritage that is put in jeopardy by ill-conceived policies.” The President will also instruct the Interior Department to rewrite a 2015 rule, currently stayed in court, that imposes restrictions on hydraulic fracturing on federal and tribal lands. The directive will also make it easier to flare methane in oil and gas operations on federal land, by triggering the review of a rule the Interior Department finalised in November. Other aspects of the executive order can take effect immediately, though it is unclear how quickly they will translate into greater coal extraction. One section overturns a 2016 White House directive to consider climate change when agencies conduct reviews under the National Environmental Policy Act, a sweeping law that informed any federal decisions that have a significant environmental impact. Another provision instructs Interior’s Bureau of Land Management to lift a freeze on federal coal leasing. That moratorium has been in effect since December 2015. Tom Sanzillo, director of finance for the Institute for Energy Economics and Financial Analysis, said in an interview that the move “becomes a largely politically symbolic measure for right now” because other, lower-carbon sources of energy are out-competing coal. He noted that US coal consumption has declined 27 percent since 2005, from 1.02 billion tonnes to 739 million tonnes in 2016, its lowest level in nearly four decades. “They’re not going to reverse the fundamental economic law here,” Sanzillo said. “There’s no market signal that’s telling them they should be mining more coal.” Still, regulatory relief could make some coal firms, nearly 50 of which have filed for bankruptcy since 2012, somewhat more economically viable. Some of the sector’s biggest companies - including Arch Coal, Peabody Energy and Alpha Natural Resources - are just now emerging from bankruptcy protection. Ethan Zindler, head of US research at Bloomberg New Energy Finance, said in an email that solar and wind are competitive with coal in some parts of the country and that natural gas ranks as the lowest-cost source of electricity generation overall. The sector that could suffer the greatest hit from the elimination of the Clean Power Plan is nuclear energy, which provides about a fifth of US businesses’ and households’ power. “Many of the 100 or so US plants are ageing, and approximately a third are economically uncompetitive today,” Zindler said. Without stricter federal emissions limits, he added, “there may be little to stop the retirement of these plants in coming years and their replacement with a combination of gas, wind and solar.” Separately, Trump has instructed federal officials to abandon the practice of factoring in the impact of climate change - what is dubbed “the social cost of carbon” - in their policymaking decisions. That calculus, which is currently set at 36 dollars per ton of carbon dioxide, aims to capture the negative consequences of allowing greenhouse-gas emissions to continue to rise. But some conservatives have criticised it as too sweeping. Federal officials will return to the traditional cost-benefit analysis the George W. Bush administration adopted nearly 15 years ago, which has a much lower cost associated with carbon emissions. As Trump seeks to scale back federal limits on greenhouse gas emissions, states and cities are likely to take on a larger role in charting the course forward. An analysis by the Rhodium Group, an economic consulting firm, found that Trump’s forthcoming executive order would slow the country’s shift away from carbon-emitting sources of energy. It found after Trump’s action, the United States would be 14 percent below its 2005 emissions levels by 2025, compared to 21 percent below that mark had current Obama-era policies remained in place. 10 photographs to show to anyone who doesn't believe in climate change 10 photographs to show to anyone who doesn't believe in climate change 1/10 2/10 Amid a flood in Islampur, Jamalpur, Bangladesh, a woman on a raft searches for somewhere dry to take shelter. Bangladesh is one of the most vulnerable places in the world to sea level rise, which is expected to make tens of millions of people homeless by 2050. 3/10 Hanna Petursdottir examines a cave inside the Svinafellsjokull glacier in Iceland, which she said had been growing rapidly. Since 2000, the size of glaciers on Iceland has reduced by 12 per cent. 4/10 Floods destroyed eight bridges and ruined crops such as wheat, maize and peas in the Karimabad valley in northern Pakistan, a mountainous region with many glaciers. In many parts of the world, glaciers have been in retreat, creating dangerously large lakes that can cause devastating flooding when the banks break. Climate change can also increase rainfall in some areas, while bringing drought to others. 5/10 Smoke – filled with the carbon that is driving climate change – drifts across a field in Colombia. A river once flowed along the depression in the dry earth of this part of Bangladesh, but it has disappeared amid rising temperatures. 7/10 Sindh province in Pakistan has experienced a grim mix of two consequences of climate change. “Because of climate change either we have floods or not enough water to irrigate our crop and feed our animals,” says the photographer. “Picture clearly indicates that the extreme drought makes wide cracks in clay. Crops are very difficult to grow.” 8/10 A shepherd moves his herd as he looks for green pasture near the village of Sirohi in Rajasthan, northern India. The region has been badly affected by heatwaves and drought, making local people nervous about further predicted increases in temperature. Riddhima Singh Bhati 9/10 A factory in China is shrouded by a haze of air pollution. The World Health Organisation has warned such pollution, much of which is from the fossil fuels that cause climate change, is a “public health emergency”. Leung Ka Wa 10/10 Water levels in reservoirs, like this one in Gers, France, have been getting perilously low in areas across the world affected by drought, forcing authorities to introduce water restrictions. Mahtuf Ikhsan Tim Profeta, who directs Duke University’s Nicholas Institute for Environmental Policy Solutions, said regulators from more than half-dozen states in the Southeast are now talking about how to chart their own path forward. Having met for nearly three years, the group stopped discussing how to comply with the Clean Power Plan after November’s election, but it is still talking. “We are now talking about the evolution of the power sector in an environment of uncertainty,” Profeta said in an interview. “We’re seeing the beginning of states taking control of their destiny.”",
    "Is Donald Trump’s determination to send US climate change policy back into the dark ages an “existential threat to the entire planet”, as the architect of many of Barack Obama’s green measures warns? Or is global momentum towards a cleaner, safer future “ unstoppable ”, as the UN’s climate chief said recently? Trump begins tearing up Obama's years of progress on tackling climate change Read more The answer lies somewhere in between and you can choose your point on that scale according to your optimism about whether society, governments and businesses will together rise to the challenge of beating global warming. One thing is clear, however: the slash-and-burn of federal climate action in the US is making one of humanity’s greatest ever challenges more difficult, just at the time when it needs to start getting easier. There are lots of possible pathways to the zero-emission global economy needed in the second half of this century to avoid the “ severe, widespread and irreversible impacts ” warned of by the world’s scientists. But the best is to start early, with global carbon emissions starting to fall by 2020. Encouragingly, emissions from fossil fuels seem to have levelled off in the past three years. However, Trump’s executive order undoing Obama’s clean power plan (CPP), alongside reversals making driving and fracking more polluting , might halt that progress. The US is the world’s second biggest emitter, pumping out 14% of global carbon dioxide, and canning the CPP could leave emissions 25% higher than otherwise. But there are good reasons to think that scrapping the CPP may fall a long way short of delivering the huge coal revival Trump has promised. Even the coal barons themselves don’t see that happening . Across the decades that energy investments stretch, the global move is clearly towards low-carbon and around the world coal is in freefall . A Trump blip is highly unlikely to see companies make billion-dollar bets on coal. Furthermore, with the costs of solar and wind power plummeting by 85% and 66% respectively since 2009 , many US states and cities see clean energy as the future, whatever the current federal administration thinks. As Trump’s healthcare and travel ban fiascos show, doing is a lot harder than tweeting. So while his climate assault is unlikely by itself to condemn the world to runaway global warming, it will make it tougher to tame. However, the rest of the world’s nations are not going to give up just because the US is choosing to free-ride on their efforts to halt climate change. At the annual UN climate summit in late November, Trump’s election win strengthened their determination to act, not weakened it. “It really concentrated the minds of 180 of the world’s countries to get on,” one senior delegate told me. Science is concentrating minds, too. Recent work shows the fast-heating Earth is now in “uncharted territory” , and just on Monday “human fingerprints” were revealed on extreme weather disasters around the world. The US has brought a great deal to the international climate effort: billions of dollars of funding that helped persuade poorer nations to accept the landmark deal in Paris in 2015, as well as world-leading scientific observation and research. Trump may pull all that from the table, but there are plenty of other players ready to step up, not least the European Union and China. China, the world’s biggest polluter, is now taking dramatic action to cut emissions, pushed by the foul air many of its citizens suffer and pulled by the likelihood of the low-carbon economy being the greatest growth story of the 21st century. John Podesta, the former Obama chief of staff who warns of Trump’s “existential threat” , is nonetheless far from despondent: “This threat alone is no reason to give up hope that we can still avert the most severe impacts of climate change. If the US cedes its leadership in the global movement to curb greenhouse gas pollution, other major powers, most notably China, are primed to dominate the coming clean energy economy.” It is also far from fanciful to imagine other nations penalising future US goods if they are produced with dirty energy. Politicians are already talking about such border carbon taxes and might point to the astronomical tariffs the US imposes on imports of which it disapproves, such as Chinese steel. It is doubtful that Trump’s blitzkrieg on “bullshit” climate change will herald the end of civilisation. But, given the issue’s critical importance for all nations and their unprecedented cooperation to date, it might just signal the end of the US’s dominance as the world’s pre-eminent political and economic power, with others taking up the mantle. Trump’s campaign pledge was “Make America great again” – his legacy could be “ Made China great again ”."
  ],
  "nwords": 150,
  "ratio": 0.1,
  "urls": null,
  "summary": "The sweeping executive order also seeks to lift a moratorium on federal coal leasing and remove the requirement that federal officials consider the impact of climate change when making decisions. “When it comes to climate change, we want to take our course and do it in our own form and fashion.” Some of the measures could take years to implement and are unlikely to alter broader economic trends that are shifting the nation’s electricity mix from coal-fired generation to natural gas and renewables . The order is silent on whether the United States should withdraw from the 2015 Paris climate agreement, under which it has pledged to cut its greenhouse gas emissions between 26 and 28 percent by 2025 compared to 2005 levels, because the administration remains divided on that question. Accelerating fossil-fuel production on federal lands and sidelining climate considerations could lead to higher emissions of the greenhouse gases driving climate change and complicate a global effort to curb the world’s carbon output. Without stricter federal emissions limits, he added, “there may be little to stop the retirement of these plants in coming years and their replacement with a combination of gas, wind and solar.” Separately, Trump has instructed federal officials to abandon the practice of factoring in the impact of climate change - what is dubbed “the social cost of carbon” - in their policymaking decisions. Is Donald Trump’s determination to send US climate change policy back into the dark ages an “existential threat to the entire planet”, as the architect of many of Barack Obama’s green measures warns? Trump begins tearing up Obama's years of progress on tackling climate change Read more The answer lies somewhere in between and you can choose your point on that scale according to your optimism about whether society, governments and businesses will together rise to the challenge of beating global warming. If the US cedes its leadership in the global movement to curb greenhouse gas pollution, other major powers, most notably China, are primed to dominate the coming clean energy economy.” It is also far from fanciful to imagine other nations penalising future US goods if they are produced with dirty energy."
}

Produce a meaningful summary from your documents

This API analyzes your text content and produces a short summary containing meaningful facts, events and relations. If provided with more text inputs, the service distills content from multiple documents into a single summary. Allowed input sources are: text content contained in an URL ("from URL") or just simple text ("from text").

Text Summarization - POST fromURL

Attribute Type Description Values
urls string, required the URLs of the text documents use url-encoding

Please notice that if provided with more URL inputs, the service distills content from multiple documents into a single summary.

Parameter Type Description Values
nwords number, optional approximate number of words in the summary 1,2, ..., 150 (default), ...
ratio number, optional compression ratio of the summary [0.1, 0.2, ..., 0.9]. If 'ratio' is specified, 'nwords' is ignored
access_token string, required your access token (40 digits) -

Examples of how-to-call the API and the related outputs are provided in the right panel.

Text Summarization - POST fromText

Attribute Type Description Values
texts string, required the texts to be summarized pass the texts between "" (e.g. "This is an example") or use url-encoded text

Please notice that if provided with more text inputs, the service distills content from multiple documents into a single summary.

Parameter Type Description Values
nwords number, optional approximate number of words in the summary 1,2, ..., 150 (default), ...
ratio number, optional compression ratio of the summary [0.1, 0.2, ..., 0.9]. If 'ratio' is specified, 'nwords' is ignored
access_token string, required your access token (40 digits) -

Examples of how-to-call the API and the related outputs are provided in the right panel.

Taxonomy Classification

Request example - POST fromURL...

curl --ssl-reqd --request POST --data url=https%3A%2F%2Fwww.theguardian.com%2Fworld%2F2016%2Fjul%2F22%2Fmissing-flight-mh370-hunt-for-debris-will-not-be-extended "https://api.yonderlabs.com/1.0/text/taxonomyclassification/fromURL?limit=3&taxonomy=news-en&access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "url": "https://www.theguardian.com/world/2016/jul/22/missing-flight-mh370-hunt-for-debris-will-not-be-extended", 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]", 
 "topics": [
    {
      "category": "disasters and accidents",
      "score": 0.43174993460965,
      "level": 0
    },
    {
      "category": "corporate/industrial",
      "sublevels": [
        {
          "category": "regulation/policy",
          "score": 0.4917200176977,
          "level": 1
        },
        {
          "category": "capacity/facilities",
          "score": 0.34327137126374,
          "level": 1
        },
        {
          "category": "production/services",
          "score": 0.16500861103856,
          "level": 1
        }
      ],
      "score": 0.31752167325834,
      "level": 0
    },
    {
      "category": "crime, law enforcement",
      "score": 0.25072839213201,
      "level": 0
    }
  ],
  "levels": 2,
  "limit": 3,
  "taxonomy": "news-en"
}

Request example - POST fromText...

curl --ssl-reqd --request POST --data text="The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]" "https://api.yonderlabs.com/1.0/text/taxonomyclassification/fromText?limit=3&taxonomy=news-en&access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "url": null, 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]", 
  "topics": [
    {
      "category": "disasters and accidents",
      "score": 0.43174993460965,
      "level": 0
    },
    {
      "category": "corporate/industrial",
      "sublevels": [
        {
          "category": "regulation/policy",
          "score": 0.4917200176977,
          "level": 1
        },
        {
          "category": "capacity/facilities",
          "score": 0.34327137126374,
          "level": 1
        },
        {
          "category": "production/services",
          "score": 0.16500861103856,
          "level": 1
        }
      ],
      "score": 0.31752167325834,
      "level": 0
    },
    {
      "category": "crime, law enforcement",
      "score": 0.25072839213201,
      "level": 0
    }
  ],
  "levels": 2,
  "limit": 3,
  "taxonomy": "news-en"
}

Categorize your text into a hierarchical taxonomy

This service analyzes chunks of text (from single sentences to full documents) and classifies them into customizable hierarchical taxonomies (e.g. Reuters taxonomy for news, etc.). Allowed input sources are: text content contained in an URL ("from URL") or just simple text ("from text").

Taxonomy Classification - POST fromURL

Attribute Type Description Values
url string, required the URL of the text document use url-encoding
Parameter Type Description Values
taxonomy string, required which taxonomy to use "news-en", "news-it", "iab-it"
levels number, optional # of hierarchical levels considered for classification 1, 2, ..., all levels (default)
limit number, optional max # of relevant categories returned per each level of the taxonomy 1, 2, 3 (default)
access_token string, required your access token (40 digits) -

where:

Examples of how-to-call the API and the related output are provided in the right panel.

Taxonomy Classification - POST fromText

Attribute Type Description Values
text string, required the text to be classified pass the text between "" (e.g. "This is an example") or use url-encoded text
Parameter Type Description Values
taxonomy string, required which taxonomy to use "news-en", "news-it", "iab-it"
levels number, optional # of hierarchical levels considered for classification 1, 2, ..., all levels (default)
limit number, optional max # of relevant categories returned per each level of the taxonomy 1, 2, 3 (default)
access_token string, required your access token (40 digits) -

where:

Examples of how-to-call the API and the related output are provided in the right panel.

Entity Extraction

Request example - POST fromURL...

curl --ssl-reqd --request POST --data url=https%3A%2F%2Fwww.theguardian.com%2Fworld%2F2016%2Fjul%2F22%2Fmissing-flight-mh370-hunt-for-debris-will-not-be-extended "https://api.yonderlabs.com/1.0/text/entityextraction/fromURL?limit=10&access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "url": "https://www.theguardian.com/world/2016/jul/22/missing-flight-mh370-hunt-for-debris-will-not-be-extended", 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]", 
  "limit": 10, 
  "entities": [
    {
      "info": null,
      "score": 1,
      "type": "Organization",
      "name": "MH370"
    },
    {
      "info": null,
      "score": 1,
      "type": "Organization",
      "name": "ATSB"
    },
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Chester",
        "description": "Chester (/ˈtʃɛstər/ CHESS-tər), is a city in Cheshire, England [...]"
      },
      "score": 0.6,
      "type": "Place",
      "name": "Chester"
    },
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Australia",
        "description": "Australia /ɒˈstreɪliə/, /ə-/, or colloquially /-jə/, officially the Commonwealth of Australia, is an Oceanian country [...]"
      },
      "score": 0.6,
      "type": "Place",
      "name": "Australia"
    },
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Malaysia",
        "description": "Malaysia (/məˈleɪʒə/ mə-LAY-zhə or /məˈleɪsiə/ mə-LAY-see-ə) (Malaysian pronunciation: [məlejsiə]) is a federal constitutional monarchy located in [...]"
      },
      "score": 0.6,
      "type": "Place",
      "name": "Malaysia"
    },
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Kuala_Lumpur",
        "description": "Kuala Lumpur (/ˈkwɑːləˈlʊmpʊər/ or /-pər/; Malaysian pronunciation: [ˈkwalə ˈlumpʊr]), is the federal capital and most populous city in Malaysia [...]"
      },
      "score": 0.2,
      "type": "Place",
      "name": "Kuala Lumpur"
    },
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/China",
        "description": "China (/ˈtʃaɪnə/; simplified Chinese: 中国; traditional Chinese: 中國; pinyin: Zhōngguó), officially the People's Republic of China (PRC), is a sovereign state [...]"
      },
      "score": 0.2,
      "type": "Place",
      "name": "China"
    },
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Tanzania",
        "description": "Tanzania /ˌtænzəˈniːə/, officially the United Republic of Tanzania (Swahili: Jamhuri ya Muungano wa Tanzania), is a country in East Africa [...]"
      },
      "score": 0.2,
      "type": "Place",
      "name": "Tanzania"
    },
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Beijing",
        "description": "Beijing, sometimes romanized as Peking, is the capital of the People's Republic of China and [...]"
      },
      "score": 0.2,
      "type": "Place",
      "name": "Beijing"
    },
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Greece",
        "description": "Greece  (Greek: Ελλάδα, Elláda, pronounced [eˈlaða]), officially the Hellenic Republic (Ελληνική Δημοκρατία [eliniˈci ðimokraˈti.a] Ellīnikī́ Dīmokratía) and known since ancient times as Hellas [...]"
      },
      "score": 0.2,
      "type": "Place",
      "name": "Greece"
    }
  ]
}

Request example - POST fromText...

curl --ssl-reqd --request POST --data text="The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]." "https://api.yonderlabs.com/1.0/text/entityextraction/fromText?limit=10&access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "url": null, 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...].", 
  "limit": 10, 
    "entities": [
    {
      "info": null,
      "score": 1,
      "type": "Organization",
      "name": "MH370"
    },
    {
      "info": null,
      "score": 1,
      "type": "Organization",
      "name": "ATSB"
    },
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Chester",
        "description": "Chester (/ˈtʃɛstər/ CHESS-tər), is a city in Cheshire, England [...]"
      },
      "score": 0.6,
      "type": "Place",
      "name": "Chester"
    },
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Australia",
        "description": "Australia /ɒˈstreɪliə/, /ə-/, or colloquially /-jə/, officially the Commonwealth of Australia, is an Oceanian country [...]"
      },
      "score": 0.6,
      "type": "Place",
      "name": "Australia"
    },
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Malaysia",
        "description": "Malaysia (/məˈleɪʒə/ mə-LAY-zhə or /məˈleɪsiə/ mə-LAY-see-ə) (Malaysian pronunciation: [məlejsiə]) is a federal constitutional monarchy located in [...]"
      },
      "score": 0.6,
      "type": "Place",
      "name": "Malaysia"
    },
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Kuala_Lumpur",
        "description": "Kuala Lumpur (/ˈkwɑːləˈlʊmpʊər/ or /-pər/; Malaysian pronunciation: [ˈkwalə ˈlumpʊr]), is the federal capital and most populous city in Malaysia [...]"
      },
      "score": 0.2,
      "type": "Place",
      "name": "Kuala Lumpur"
    },
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/China",
        "description": "China (/ˈtʃaɪnə/; simplified Chinese: 中国; traditional Chinese: 中國; pinyin: Zhōngguó), officially the People's Republic of China (PRC), is a sovereign state [...]"
      },
      "score": 0.2,
      "type": "Place",
      "name": "China"
    },
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Tanzania",
        "description": "Tanzania /ˌtænzəˈniːə/, officially the United Republic of Tanzania (Swahili: Jamhuri ya Muungano wa Tanzania), is a country in East Africa [...]"
      },
      "score": 0.2,
      "type": "Place",
      "name": "Tanzania"
    },
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Beijing",
        "description": "Beijing, sometimes romanized as Peking, is the capital of the People's Republic of China and [...]"
      },
      "score": 0.2,
      "type": "Place",
      "name": "Beijing"
    },
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Greece",
        "description": "Greece  (Greek: Ελλάδα, Elláda, pronounced [eˈlaða]), officially the Hellenic Republic (Ελληνική Δημοκρατία [eliniˈci ðimokraˈti.a] Ellīnikī́ Dīmokratía) and known since ancient times as Hellas [...]"
      },
      "score": 0.2,
      "type": "Place",
      "name": "Greece"
    }
  ]
}

Identify people, places, and organizations in your text

This API detects named entities and classify them as Person, Place, Organization or Misc. The service also links them to knowledge base repositories (Wikipedia, DBpedia, etc.). It is also possible to include custom whitelists and blacklists of entities upon request. Allowed input sources are: text content contained in an URL ("from URL") or just simple text ("from text").

Entity Extraction - POST fromURL

Attribute Type Description Values
url string, required the URL of the text document use url-encoding
Parameter Type Description
limit number, optional max # of relevant entities to be returned, in decreasing order of confidence (if not specified, all results are returned)
access_token string, required your access token (40 digits)

Examples of how-to-call the API and the related output are provided in the right panel.

Entity Extraction - POST fromText

Attribute Type Description Values
text string, required the text to be classified pass the text between "" (e.g. "This is an example") or use url-encoded text
Parameter Type Description
limit number, optional max # of relevant entities to be returned, in decreasing order of confidence (if not specified, all results are returned)
access_token string, required your access token (40 digits)

Examples of how-to-call the API and the related output are provided in the right panel.

Keyword Extraction

Request example - POST fromURL...

curl --ssl-reqd --request POST --data url=https%3A%2F%2Fwww.theguardian.com%2Fworld%2F2016%2Fjul%2F22%2Fmissing-flight-mh370-hunt-for-debris-will-not-be-extended "https://api.yonderlabs.com/1.0/text/keywordextraction/fromURL?limit=12&access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "url": "https://www.theguardian.com/world/2016/jul/22/missing-flight-mh370-hunt-for-debris-will-not-be-extended", 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]", 
  "limit": 12, 
  "keywords": [
    {
      "score": 1,
      "name": "search"
    },
    {
      "score": 1,
      "name": "area"
    },
    {
      "score": 1,
      "name": "sq km"
    },
    {
      "score": 1,
      "name": "aircraft"
    },
    {
      "score": 0.9,
      "name": "ministers"
    },
    {
      "score": 0.9,
      "name": "completion"
    },
    {
      "score": 0.9,
      "name": "remain"
    },
    {
      "score": 0.5,
      "name": "transport"
    },
    {
      "score": 0.5,
      "name": "country"
    },
    {
      "score": 0.5,
      "name": "end"
    },
    {
      "score": 0.5,
      "name": "poor weather"
    },
    {
      "score": 0.5,
      "name": "absence"
    }
  ]
}

Request example - POST fromText...

curl --ssl-reqd --request POST --data text="The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]" "https://api.yonderlabs.com/1.0/text/keywordextraction/fromText?limit=12&access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "url": null, 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]", 
"limit": 12, 
   "keywords": [
    {
      "score": 1,
      "name": "search"
    },
    {
      "score": 1,
      "name": "area"
    },
    {
      "score": 1,
      "name": "sq km"
    },
    {
      "score": 1,
      "name": "aircraft"
    },
    {
      "score": 0.9,
      "name": "ministers"
    },
    {
      "score": 0.9,
      "name": "completion"
    },
    {
      "score": 0.9,
      "name": "remain"
    },
    {
      "score": 0.5,
      "name": "transport"
    },
    {
      "score": 0.5,
      "name": "country"
    },
    {
      "score": 0.5,
      "name": "end"
    },
    {
      "score": 0.5,
      "name": "poor weather"
    },
    {
      "score": 0.5,
      "name": "absence"
    }
  ]
}

Find meaningful keywords in your text document

This API analyzes your text content (news articles, blog posts, e-mail, etc.) identifying all meaningful keywords related to important facts, events and relations. Allowed input sources are: text content contained in an URL ("from URL") or just simple text ("from text").

Keyword Extraction - POST fromURL

Attribute Type Description Values
url string, required the URL of the text document use url-encoding
Parameter Type Description
limit number, optional max # of relevant keywords to be returned, in decreasing order of relevance (if not specified, all results are returned)
access_token string, required your access token (40 digits)

Examples of how-to-call the API and the related output are provided in the right panel.

Keyword Extraction - POST fromText

Attribute Type Description Values
text string, required the text to be classified pass the text between "" (e.g. "This is an example") or use url-encoded text
Parameter Type Description
limit number, optional max # of relevant keywords to be returned, in decreasing order of relevance (if not specified, all results are returned)
access_token string, required your access token (40 digits)

Examples of how-to-call the API and the related output are provided in the right panel.

Concept Tagging

Request example - POST fromURL...

curl --ssl-reqd --request POST --data url=https%3A%2F%2Fwww.theguardian.com%2Fworld%2F2016%2Fjul%2F22%2Fmissing-flight-mh370-hunt-for-debris-will-not-be-extended "https://api.yonderlabs.com/1.0/text/concepttagging/fromURL?limit=8&access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "url": "https://www.theguardian.com/world/2016/jul/22/missing-flight-mh370-hunt-for-debris-will-not-be-extended", 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]", 
  "limit": 8, 
  "tags": [
    "disasters and accidents", 
    "mh370", 
    "atsb", 
    "sumisha naidu", 
    "martin dolan", 
    "malaysia",
    "search",
    "area"
  ]
}

Request example - POST fromText...

curl --ssl-reqd --request POST --data text="The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]." "https://api.yonderlabs.com/1.0/text/concepttagging/fromText?limit=8&access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "url": null, 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]", 
 "limit": 8, 
  "tags": [
    "disasters and accidents", 
    "mh370", 
    "atsb", 
    "sumisha naidu", 
    "martin dolan", 
    "malaysia",
    "search",
    "area"
  ]
}

Generate high-level semantic tags for your text document

Concept tags are a limited and meaningful set of highly relevant named entities and important keywords related to facts, events, and relations found in your text. It is also possible to include custom whitelists and blacklists of concept tags upon request. Allowed input sources are: text content contained in an URL ("from URL") or just simple text ("from text").

Concept Tagging - POST fromURL

Attribute Type Description Values
url string, required the URL of the text document use url-encoding
Parameter Type Description Value
limit number, optional max # of relevant tags to be returned, in decreasing order of relevance 1, 2, ..., 10 (default), etc.
access_token string, required your access token (40 digits)

Examples of how-to-call the API and the related output are provided in the right panel.

Concept Tagging - POST fromText

Attribute Type Description Values
text string, required the text to be classified pass the text between "" (e.g. "This is an example") or use url-encoded text
Parameter Type Description Value
limit number, optional max # of relevant tags to be returned, in decreasing order of relevance 1, 2, ..., 10 (default), etc.
access_token string, required your access token (40 digits)

Examples of how-to-call the API and the related output are provided in the right panel.

Sentiment Analysis

Request example - POST fromURL...

curl --ssl-reqd --request POST --data url=https%3A%2F%2Fwww.theguardian.com%2Fworld%2F2016%2Fjul%2F22%2Fmissing-flight-mh370-hunt-for-debris-will-not-be-extended "https://api.yonderlabs.com/1.0/text/sentimentanalysis/fromURL?access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "url": "https://www.theguardian.com/world/2016/jul/22/missing-flight-mh370-hunt-for-debris-will-not-be-extended", 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]", 
  "sentiment": "neutral"
}

Request example - POST fromText...

curl --ssl-reqd --request POST --data text="The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]" "https://api.yonderlabs.com/1.0/text/sentimentanalysis/fromText?access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "url": null, 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]", 
  "sentiment": "neutral"
}

Identify positive or negative sentiments within text

This API classifies the polarity of a given text at sentence and document level, identifying whether the expressed opinion is positive, negative, or neutral. Allowed input sources are: text content contained in an URL ("from URL") or just simple text ("from text").

Sentiment Analysis - POST fromURL

Attribute Type Description Values
url string, required the URL of the text document use url-encoding
Parameter Type Description
access_token string, required your access token (40 digits)

Examples of how-to-call the API and the related output are provided in the right panel.

Sentiment Analysis - POST fromText

Attribute Type Description Values
text string, required the text to be classified pass the text between "" (e.g. "This is an example") or use url-encoded text
Parameter Type Description
access_token string, required your access token (40 digits)

Examples of how-to-call the API and the related output are provided in the right panel.

Emotional Reaction

Request example - POST fromURL...

curl --ssl-reqd --request POST --data url=https%3A%2F%2Fwww.theguardian.com%2Fworld%2F2016%2Fjul%2F22%2Fmissing-flight-mh370-hunt-for-debris-will-not-be-extended "https://api.yonderlabs.com/1.0/text/reactionclassification/fromURL?access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "url": "https://www.theguardian.com/world/2016/jul/22/missing-flight-mh370-hunt-for-debris-will-not-be-extended", 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]", 
  "reactions": [
    {
      "reaction": "wow", 
      "score": 0.51
    }, 
    {
      "reaction": "sad", 
      "score": 0.49
    }
  ]
}


Request example - POST fromText...

curl --ssl-reqd --request POST --data text="The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]" "https://api.yonderlabs.com/1.0/text/reactionclassification/fromText?access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "url": null, 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]", 
  "reactions": [
    {
      "reaction": "wow", 
      "score": 0.51
    }, 
    {
      "reaction": "sad", 
      "score": 0.49
    }
  ]
}

Predict emotions aroused from text such as angry, sad, etc.

This API goes beyond polarity sentiment analysys and focus on emotional states likely to be aroused in the reader. In particular the API identifies a maximum of two dominant emotions choosing among the popular Facebook reactions love, angry, ahah, wow,sad. If no emotion is found, an empty list is returned. Allowed input sources are: text content contained in an URL ("from URL") or just simple text ("from text").

Emotional Reaction - POST fromURL

Attribute Type Description Values
url string, required the URL of the text document use url-encoding
Parameter Type Description
access_token string, required your access token (40 digits)

Examples of how-to-call the API and the related output are provided in the right panel.

Emotional Reaction - POST fromText

Attribute Type Description Values
text string, required the text to be classified pass the text between "" (e.g. "This is an example") or use url-encoded text
Parameter Type Description
access_token string, required your access token (40 digits)

Examples of how-to-call the API and the related output are provided in the right panel.

Text Extraction

Request example - POST...

curl --ssl-reqd --request POST --data url=https%3A%2F%2Fwww.theguardian.com%2Fworld%2F2016%2Fjul%2F22%2Fmissing-flight-mh370-hunt-for-debris-will-not-be-extended "https://api.yonderlabs.com/1.0/text/textextraction?access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "url": "https://www.theguardian.com/world/2016/jul/22/missing-flight-mh370-hunt-for-debris-will-not-be-extended", 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that it would \u201cnot end, but be suspended\u201d if the completion of the two-year search of a 120,000 sq km arc of the southern Indian ocean west of Australia fails to yield any new evidence. Less than 10,000 sq km of that area remain, though progress is slow due to poor weather conditions. In a joint statement, the ministers acknowledged that \u201cdespite the best efforts of all involved, the likelihood of finding the aircraft is fading. \u201cIn the absence of credible new evidence leading to an identification of a specific location of the aircraft, the search would not end, but be suspended upon completion of the 120,000 sq km area.\u201d Liow Tiong Lai, the Malaysian transport minister, told reporters that cost was not a factor in the decision. It was stressed that this did not mean the termination of the search, and that the aspiration to locate MH370 remained. But any next steps would be dependant on new information that could be used to identify the specific location of the aircraft. \u201cWe remain hopeful that the aircraft will be located,\u201d said Darren Chester, the Australian minister for transport and infrastructure. The families of the 239 victims were informed before the press conference on Friday afternoon. \u2014 Sumisha Naidu (@SumishaCNA) July 22, 2016  This does not mean we have given up on the search for #MH370   - @liowtionglai pic.twitter.com/QrAi4ewYvF That the search would not be extended in the absence of any significant discovery has been consistently signalled by the Australian body in charge for more than a year. The Australian Transport Safety Bureau has led the underwater operation for the wreckage of the missing aircraft, which disappeared en route from Kuala Lumpur to Beijing in March 2014. Chester said in a statement on Thursday that the search had been \u201cunprecedented in both size and scale, conducted in some of the world\u2019s most isolated waters and at times in extremely challenging weather\u201d. Progress on the final 10,000 or so sq km of the total search area \u2013 about the size of Greece \u2013 has been delayed by poor weather, meaning the search could extend into spring. In March, on the two-year anniversary of the plane\u2019s disappearance, Martin Dolan, the head of the ATSB, said it was \u201cvery likely\u201d the wreckage would be found within that area. But with that possibility dwindling with every square kilometre completed, experts have been forced to consider alternatives. The three countries agreed in April last year not to extend the search area beyond that 120,000 sq km. Paul Kennedy, the project director of Fugro \u2013 the Dutch company leading the search \u2013 acknowledged on Thursday that, if the plane was not found there, \u201cit means it\u2019s somewhere else\u201d. The company later clarified that it believed the search area was the most probable place and as such the right place to search. But Richard Godfrey, a member of the so-called Independent Group of professionals conducting their own work to locate MH370, argued in a paper published earlier in July that the ATSB were looking in the wrong place. He identified a range of latitudes consistent with known data, ocean drift analyses and floating debris that was not captured in the priority search area. \u201cThe failure to find sunken wreckage ... is not surprising,\u201d he wrote. \u201cThe underwater search has produced no results so far and the assumptions made in determining the ATSB priority search area should be re-examined.\u201d To date, four pieces have been identified as almost certainly being from MH370, in addition to a wing flaperon found on La R\u00e9union in July last year. A large piece of aircraft debris found on an island off the coast of Tanzania in June arrived in Canberra for examination earlier this week. It is thought to be a wing flap, but technical specialists from the ATSB are working with Malaysian investigators to determine whether it is from MH370."
}

Extract text from a webpage removing all other undesired content

This service extracts the main text from a webpage, discarding navigation links, advertisements and other undesired content.

Text Extraction - POST

Attribute Type Description Values
url string, required the URL of the text document use url-encoding
Parameter Type Description
access_token string, required your access token (40 digits)

Examples of how-to-call the API and the related output are provided in the right panel.

Language Detection

Request example - POST fromURL...

curl --ssl-reqd --request POST --data url=https%3A%2F%2Fwww.theguardian.com%2Fworld%2F2016%2Fjul%2F22%2Fmissing-flight-mh370-hunt-for-debris-will-not-be-extended "https://api.yonderlabs.com/1.0/text/languagedetection/fromURL?access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "url": "https://www.theguardian.com/world/2016/jul/22/missing-flight-mh370-hunt-for-debris-will-not-be-extended", 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]", 
  "lang-ext": "English", 
  "lang": "en"
}

Request example - POST fromText...

curl --ssl-reqd --request POST --data text="The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]" "https://api.yonderlabs.com/1.0/text/languagedetection/fromText?access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "url": null, 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]", 
  "lang-ext": "English", 
  "lang": "en"
}

Recognize the language of your text (over 50 languages)

This service recognizes the language a document were written in, including English, Italian, Spanish, French, German, and other main languages. Allowed input sources are: text content contained in an URL ("from URL") or just simple text ("from text").

Language Extraction - POST fromURL

Attribute Type Description Values
url string, required the URL of the text document use url-encoding
Parameter Type Description
access_token string, required your access token (40 digits)

Examples of how-to-call the API and the related output are provided in the right panel.

Language Extraction - POST fromText

Attribute Type Description Values
text string, required the text to be classified pass the text between "" (e.g. "This is an example") or use url-encoded text
Parameter Type Description
access_token string, required your access token (40 digits)

Examples of how-to-call the API and the related output are provided in the right panel.

All Single Text

Request example - POST fromURL...

curl --ssl-reqd --request POST --data url=https%3A%2F%2Fwww.theguardian.com%2Fworld%2F2016%2Fjul%2F22%2Fmissing-flight-mh370-hunt-for-debris-will-not-be-extended "https://api.yonderlabs.com/1.0/text/allsingletext/fromURL?access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "lang": "en", 
  "lang-ext": "English", 
  "sentiment": "neutral", 
  "tags": [
    "disasters and accidents", 
    "mh370", 
    "atsb", 
    "sumisha naidu", 
    "martin dolan", 
    "malaysia",
    "search",
    "area"
  ], 
  "reactions": [
    {
      "reaction": "wow", 
      "score": 0.51
    }, 
    {
      "reaction": "sad", 
      "score": 0.49
    }
  ], 
  "url": "https://www.theguardian.com/world/2016/jul/22/missing-flight-mh370-hunt-for-debris-will-not-be-extended", 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]", 
  "topics": [
    {
      "category": "disasters and accidents", 
      "score": 0.43648842879859323, 
      "level": 0
    }, 
    {
      "category": "corporate/industrial", 
      "sublevels": [
        {
          "category": "regulation/policy", 
          "score": 0.48749040688621503, 
          "level": 1
        }, 
        {
          "category": "capacity/facilities", 
          "score": 0.3472713949921758, 
          "level": 1
        }, 
        {
          "category": "production/services", 
          "score": 0.1652381981216092, 
          "level": 1
        }
      ], 
      "score": 0.29542684300638344, 
      "level": 0
    }, 
    {
      "category": "crime, law enforcement", 
      "score": 0.2680847281950233, 
      "level": 0
    }
  ], 
    "summary": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. “In the absence of credible new evidence leading to an identification of a specific location of the aircraft, the search would not end, but be suspended upon completion of the 120,000 sq km area.” Liow Tiong Lai, the Malaysian transport minister, told reporters that cost was not a factor in the decision. “The underwater search has produced no results so far and the assumptions made in determining the ATSB priority search area should be re-examined.” To date, four pieces have been identified as almost certainly being from MH370, in addition to a wing flaperon found on La Réunion in July last year. It is thought to be a wing flap, but technical specialists from the ATSB are working with Malaysian investigators to determine whether it is from MH370.",
  "entities": [
    {
      "info": null, 
      "score": 1.0, 
      "type": "Organization", 
      "name": "MH370"
    }, 
    {
      "info": null, 
      "score": 1.0, 
      "type": "Organization", 
      "name": "ATSB"
    }, 
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Malaysia", 
        "description": "Malaysia (/m\u0259\u02c8le\u026a\u0292\u0259/ m\u0259-LAY-zh\u0259 or /m\u0259\u02c8le\u026asi\u0259/ m\u0259-LAY-see-\u0259) (Malaysian pronunciation: [m\u0259lejsi\u0259]) is a federal constitutional monarchy [...]"
      }, 
      "score": 0.6, 
      "type": "Place", 
      "name": "Malaysia"
    }, 
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Australia", 
        "description": "Australia /\u0252\u02c8stre\u026ali\u0259/, /\u0259-/, or colloquially /-j\u0259/, officially the Commonwealth of Australia, is an Oceanian country [...]"
      }, 
      "score": 0.6, 
      "type": "Place", 
      "name": "Australia"
    }, 
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Chester", 
        "description": "Chester (/\u02c8t\u0283\u025bst\u0259r/ CHESS-t\u0259r), is a city in Cheshire, England. Lying on [...]"
      }, 
      "score": 0.6, 
      "type": "Place", 
      "name": "Chester"
    }, 
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/China", 
        "description": "China (/\u02c8t\u0283a\u026an\u0259/; simplified Chinese: \u4e2d\u56fd; traditional Chinese: \u4e2d\u570b; pinyin: Zh\u014dnggu\u00f3), officially the People's Republic of China (PRC), is a sovereign state [...]"
      }, 
      "score": 0.2, 
      "type": "Place", 
      "name": "China"
    }, 
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Sumisha_Naidu", 
        "description": "Sumisha Naidu is a former Australian Broadcasting Corporation and KiniTV journalist and presenter [...]"
      }, 
      "score": 0.2, 
      "type": "Person", 
      "name": "Sumisha Naidu"
    }, 
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Kuala_Lumpur", 
        "description": "Kuala Lumpur (/\u02c8kw\u0251\u02d0l\u0259\u02c8l\u028amp\u028a\u0259r/ or /-p\u0259r/; Malaysian pronunciation: [\u02c8kwal\u0259 \u02c8lump\u028ar]), is the federal capital and [...]"
      }, 
      "score": 0.2, 
      "type": "Place", 
      "name": "Kuala Lumpur"
    }, 
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Beijing", 
        "description": "Beijing, sometimes romanized as Peking, is the capital of the People's Republic of China and [...]"
      }, 
      "score": 0.2, 
      "type": "Place", 
      "name": "Beijing"
    }, 
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Tanzania", 
        "description": "Tanzania /\u02cct\u00e6nz\u0259\u02c8ni\u02d0\u0259/, officially the United Republic of Tanzania (Swahili: Jamhuri ya Muungano wa Tanzania), is a country in East Africa [...]"
      }, 
      "score": 0.2, 
      "type": "Place", 
      "name": "Tanzania"
    }, 
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Putrajaya", 
        "description": "Putrajaya is a planned city, 25 km south of Kuala Lumpur [...]"
      }, 
      "score": 0.2, 
      "type": "Place", 
      "name": "Putrajaya"
    }, 
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Greece", 
        "description": "Greece  (Greek: \u0395\u03bb\u03bb\u03ac\u03b4\u03b1, Ell\u00e1da, pronounced [e\u02c8la\u00f0a] (13px )), officially the Hellenic Republic (\u0395\u03bb\u03bb\u03b7\u03bd\u03b9\u03ba\u03ae \u0394\u03b7\u03bc\u03bf\u03ba\u03c1\u03b1\u03c4\u03af\u03b1 [elini\u02c8ci \u00f0imokra\u02c8ti.a] Ell\u012bnik\u012b\u0301 D\u012bmokrat\u00eda) and known since ancient times as Hellas [...]"
      }, 
      "score": 0.2, 
      "type": "Place", 
      "name": "Greece"
    }
  ], 
  "keywords": [
    {
      "score": 1.0, 
      "name": "search"
    }, 
    {
      "score": 1.0, 
      "name": "area"
    }, 
    {
      "score": 1.0, 
      "name": "sq km"
    }, 
    {
      "score": 1.0, 
      "name": "aircraft"
    }, 
    {
      "score": 0.9, 
      "name": "ministers"
    }, 
    {
      "score": 0.9, 
      "name": "completion"
    }, 
    {
      "score": 0.9, 
      "name": "remain"
    }, 
    {
      "score": 0.4, 
      "name": "transport"
    }, 
    {
      "score": 0.4, 
      "name": "country"
    }, 
    {
      "score": 0.4, 
      "name": "end"
    }, 
    {
      "score": 0.4, 
      "name": "poor weather"
    }, 
    {
      "score": 0.4, 
      "name": "absence"
    }, 
    {
      "score": 0.4, 
      "name": "specific location"
    }, 
    {
      "score": 0.4, 
      "name": "wreckage"
    }, 
    {
      "score": 0.4, 
      "name": "plane"
    }
  ]
}

Request example - POST fromText...

curl --ssl-reqd --request POST --data text="The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]" "https://api.yonderlabs.com/1.0/text/allsingletext/fromText?access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "lang": "en", 
  "lang-ext": "English", 
  "sentiment": "neutral", 
  "tags": [
     "disasters and accidents", 
    "mh370", 
    "atsb", 
    "sumisha naidu", 
    "martin dolan", 
    "malaysia",
    "search",
    "area"
  ], 
  "reactions": [
    {
      "reaction": "wow", 
      "score": 0.51
    }, 
    {
      "reaction": "sad", 
      "score": 0.49
    }
  ], 
  "url": null, 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]", 
  "topics": [
    {
      "category": "disasters and accidents", 
      "score": 0.43648842879859323, 
      "level": 0
    }, 
    {
      "category": "corporate/industrial", 
      "sublevels": [
        {
          "category": "regulation/policy", 
          "score": 0.48749040688621503, 
          "level": 1
        }, 
        {
          "category": "capacity/facilities", 
          "score": 0.3472713949921758, 
          "level": 1
        }, 
        {
          "category": "production/services", 
          "score": 0.1652381981216092, 
          "level": 1
        }
      ], 
      "score": 0.29542684300638344, 
      "level": 0
    }, 
    {
      "category": "crime, law enforcement", 
      "score": 0.2680847281950233, 
      "level": 0
    }
  ], 
    "summary": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. “In the absence of credible new evidence leading to an identification of a specific location of the aircraft, the search would not end, but be suspended upon completion of the 120,000 sq km area.” Liow Tiong Lai, the Malaysian transport minister, told reporters that cost was not a factor in the decision. “The underwater search has produced no results so far and the assumptions made in determining the ATSB priority search area should be re-examined.” To date, four pieces have been identified as almost certainly being from MH370, in addition to a wing flaperon found on La Réunion in July last year. It is thought to be a wing flap, but technical specialists from the ATSB are working with Malaysian investigators to determine whether it is from MH370.",
  "entities": [
    {
      "info": null, 
      "score": 1.0, 
      "type": "Organization", 
      "name": "MH370"
    }, 
    {
      "info": null, 
      "score": 1.0, 
      "type": "Organization", 
      "name": "ATSB"
    }, 
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Malaysia", 
        "description": "Malaysia (/m\u0259\u02c8le\u026a\u0292\u0259/ m\u0259-LAY-zh\u0259 or /m\u0259\u02c8le\u026asi\u0259/ m\u0259-LAY-see-\u0259) (Malaysian pronunciation: [m\u0259lejsi\u0259]) is a federal constitutional monarchy [...]"
      }, 
      "score": 0.6, 
      "type": "Place", 
      "name": "Malaysia"
    }, 
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Australia", 
        "description": "Australia /\u0252\u02c8stre\u026ali\u0259/, /\u0259-/, or colloquially /-j\u0259/, officially the Commonwealth of Australia, is an Oceanian country [...]"
      }, 
      "score": 0.6, 
      "type": "Place", 
      "name": "Australia"
    }, 
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Chester", 
        "description": "Chester (/\u02c8t\u0283\u025bst\u0259r/ CHESS-t\u0259r), is a city in Cheshire, England. Lying on [...]"
      }, 
      "score": 0.6, 
      "type": "Place", 
      "name": "Chester"
    }, 
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/China", 
        "description": "China (/\u02c8t\u0283a\u026an\u0259/; simplified Chinese: \u4e2d\u56fd; traditional Chinese: \u4e2d\u570b; pinyin: Zh\u014dnggu\u00f3), officially the People's Republic of China (PRC), is a sovereign state [...]"
      }, 
      "score": 0.2, 
      "type": "Place", 
      "name": "China"
    }, 
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Sumisha_Naidu", 
        "description": "Sumisha Naidu is a former Australian Broadcasting Corporation and KiniTV journalist and presenter [...]"
      }, 
      "score": 0.2, 
      "type": "Person", 
      "name": "Sumisha Naidu"
    }, 
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Kuala_Lumpur", 
        "description": "Kuala Lumpur (/\u02c8kw\u0251\u02d0l\u0259\u02c8l\u028amp\u028a\u0259r/ or /-p\u0259r/; Malaysian pronunciation: [\u02c8kwal\u0259 \u02c8lump\u028ar]), is the federal capital and [...]"
      }, 
      "score": 0.2, 
      "type": "Place", 
      "name": "Kuala Lumpur"
    }, 
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Beijing", 
        "description": "Beijing, sometimes romanized as Peking, is the capital of the People's Republic of China and [...]"
      }, 
      "score": 0.2, 
      "type": "Place", 
      "name": "Beijing"
    }, 
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Tanzania", 
        "description": "Tanzania /\u02cct\u00e6nz\u0259\u02c8ni\u02d0\u0259/, officially the United Republic of Tanzania (Swahili: Jamhuri ya Muungano wa Tanzania), is a country in East Africa [...]"
      }, 
      "score": 0.2, 
      "type": "Place", 
      "name": "Tanzania"
    }, 
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Putrajaya", 
        "description": "Putrajaya is a planned city, 25 km south of Kuala Lumpur [...]"
      }, 
      "score": 0.2, 
      "type": "Place", 
      "name": "Putrajaya"
    }, 
    {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Greece", 
        "description": "Greece  (Greek: \u0395\u03bb\u03bb\u03ac\u03b4\u03b1, Ell\u00e1da, pronounced [e\u02c8la\u00f0a] (13px )), officially the Hellenic Republic (\u0395\u03bb\u03bb\u03b7\u03bd\u03b9\u03ba\u03ae \u0394\u03b7\u03bc\u03bf\u03ba\u03c1\u03b1\u03c4\u03af\u03b1 [elini\u02c8ci \u00f0imokra\u02c8ti.a] Ell\u012bnik\u012b\u0301 D\u012bmokrat\u00eda) and known since ancient times as Hellas [...]"
      }, 
      "score": 0.2, 
      "type": "Place", 
      "name": "Greece"
    }
  ], 
  "keywords": [
    {
      "score": 1.0, 
      "name": "search"
    }, 
    {
      "score": 1.0, 
      "name": "area"
    }, 
    {
      "score": 1.0, 
      "name": "sq km"
    }, 
    {
      "score": 1.0, 
      "name": "aircraft"
    }, 
    {
      "score": 0.9, 
      "name": "ministers"
    }, 
    {
      "score": 0.9, 
      "name": "completion"
    }, 
    {
      "score": 0.9, 
      "name": "remain"
    }, 
    {
      "score": 0.4, 
      "name": "transport"
    }, 
    {
      "score": 0.4, 
      "name": "country"
    }, 
    {
      "score": 0.4, 
      "name": "end"
    }, 
    {
      "score": 0.4, 
      "name": "poor weather"
    }, 
    {
      "score": 0.4, 
      "name": "absence"
    }, 
    {
      "score": 0.4, 
      "name": "specific location"
    }, 
    {
      "score": 0.4, 
      "name": "wreckage"
    }, 
    {
      "score": 0.4, 
      "name": "plane"
    }
  ]
}

Analyze your document with all single API on text

This service analyzes your text content by applying at once all single API on text documents, that are:

Employed taxonomies, depending on the text language, are:

The parameter values are the default ones of the single API (i.e. 'all' results for Entity Extraction API and Keyword Extraction API, '10' results for Concept Tagging API). As for Entity Extraction and Concept Tagging APIs, it is possible to include custom whitelists and blacklists of entities and concepts upon request. Allowed input sources are: text content contained in an URL ("from URL") or just simple text ("from text").

All Single Text - POST fromURL

Attribute Type Description Values
url string, required the URL of the text document use url-encoding
Parameter Type Description Values
taxonomy string, required which taxonomy to use "news-en", "news-it", "iab-it"
levels_taxonomy number, optional # of hierarchical levels considered for classification 1, 2, ..., all levels (default)
limit_taxonomy number, optional max # of relevant categories returned per each level of the taxonomy 1, 2, 3 (default)
limit_entity number, optional max # of relevant entities to be returned, in decreasing order of confidence (if not specified, all results are returned)
limit_keyword number, optional max # of relevant keywords to be returned, in decreasing order of relevance (if not specified, all results are returned)
limit_concept number, optional max # of relevant tags to be returned, in decreasing order of relevance 1, 2, ..., 10 (default), etc.
nwords number, optional approximate number of words in the summary 1,2, ..., 150 (default), ...
ratio number, optional compression ratio of the summary [0.1, 0.2, ..., 0.9]. If 'ratio' is specified, 'nwords' is ignored

access_token | string, required | your access token (40 digits) | - | Examples of how-to-call the API and the related output are provided in the right panel.

All Single Text - POST fromText

Attribute Type Description Values
text string, required the text to be classified pass the text between "" (e.g. "This is an example") or use url-encoded text
Parameter Type Description Values
taxonomy string, required which taxonomy to use "news-en", "news-it", "iab-it"
levels_taxonomy number, optional # of hierarchical levels considered for classification 1, 2, ..., all levels (default)
limit_taxonomy number, optional max # of relevant categories returned per each level of the taxonomy 1, 2, 3 (default)
limit_entity number, optional max # of relevant entities to be returned, in decreasing order of confidence (if not specified, all results are returned)
limit_keyword number, optional max # of relevant keywords to be returned, in decreasing order of relevance (if not specified, all results are returned)
limit_concept number, optional max # of relevant tags to be returned, in decreasing order of relevance 1, 2, ..., 10 (default), etc.
nwords number, optional approximate number of words in the summary 1,2, ..., 150 (default), ...
ratio number, optional compression ratio of the summary [0.1, 0.2, ..., 0.9]. If 'ratio' is specified, 'nwords' is ignored

access_token | string, required | your access token (40 digits) | - | Examples of how-to-call the API and the related output are provided in the right panel.

API on Text Collections

A Text Collection is a repository of metadata coming from multiple text documents. The following set of API allows for analyzing inter-documents relations in Text Collections (e.g. measuring document similarities, building entity graphs, etc.). If you need to analyze documents without creating a collection, please refer to YonderAPI on Text Documents provided above.

Text Collection

Request example to "Create a Text Collection" - POST...

curl --ssl-reqd --request POST "https://api.yonderlabs.com/1.0/textcollection/textcollection?collection_name=donald-duck&description=this-is-my-first-collection&access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "type": "private", 
  "description": "this-is-my-first-collection", 
  "collection_name": "donald-duck", 
  "created": true
}

Request example to "Get info from a Text Collection" - GET...

curl --ssl-reqd --request GET "https://api.yonderlabs.com/1.0/textcollection/textcollection?collection_name=donald-duck&access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "count": 0, 
  "type": "private", 
  "description": "this-is-my-first-collection", 
  "collection_name": "donald-duck"
}

Request example to "List all Text Collections" - GET...

curl --ssl-reqd --request GET "https://api.yonderlabs.com/1.0/textcollection/textcollection?access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "collections": [
    {
      "count": 5, 
      "collection_name": "scrooge", 
      "type": "private", 
      "description": "This-is-my-first-collection."
    }, 
    {
      "count": 12, 
      "collection_name": "donald-duck", 
      "type": "private", 
      "description": "This-is-another-collection."
    }, 
    {
      "count": 0, 
      "collection_name": "daisy", 
      "type": "private", 
      "description": "Yet-another-text-collection."
    }
  ]
}

Request example to "Delete a Text Collection" - DELETE...

curl --ssl-reqd --request DELETE "https://api.yonderlabs.com/1.0/textcollection/textcollection?collection_name=donald-duck&access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "deleted": true, 
  "type": "private", 
  "description": "this-is-my-first-collection", 
  "collection_name": "donald-duck"
}

Create, delete, and retrieve information from Text Collections

This API allows you to create, delete, and get information from a single Text Collection, and list all existing Text Collections.

Create a Text Collection - POST

This API allows you to create a new Text Collection:

Parameter Type Description
collection_name string, required the name of the Text Collection to be created
description string, optional a textual description of the Text Collection
access_token string, required your access token (40 digits)

Examples of how-to-call the API and the related output are provided in the right panel.

Get info from a Text Collection - GET

This API allows you to retrieve all information from a Text Collection:

Parameter Type Description
collection_name string, required the name of the Text Collection from which to retrieve information
access_token string, required your access token (40 digits)

Examples of how-to-call the API and the related output are provided in the right panel.

List all Text Collections - GET

This API allows you to retrieve information about all your existing Text Collections:

Parameter Type Description
access_token string, required your access token (40 digits)

Examples of how-to-call the API and the related output are provided in the right panel.

Delete a Text Collection - DELETE

This API allows you to delete a Text Collection:

Parameter Type Description
collection_name string, required the name of the Text Collection to be deleted
access_token string, required your access token (40 digits)

Examples of how-to-call the API and the related output are provided in the right panel.

Text Item

Request example to "Create Text Item fromURL" - POST fromURL...

curl --ssl-reqd --request POST --data url=https%3A%2F%2Fwww.theguardian.com%2Fworld%2F2016%2Fjul%2F22%2Fmissing-flight-mh370-hunt-for-debris-will-not-be-extended "https://api.yonderlabs.com/1.0/textcollection/textitem/fromURL?collection_name=donald_duck&access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "url": "https://www.theguardian.com/world/2016/jul/22/missing-flight-mh370-hunt-for-debris-will-not-be-extended", 
  "collection_name": "donald_duck", 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]", 
  "timestamp": "2015-12-29 16:28:06.517297", 
  "inserted_id": "5665a1e8b1f5391201471f86"
}

Request example to "Create Text Item fromText" - POST fromText...

curl --ssl-reqd --request POST --data text="The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]" "https://api.yonderlabs.com/1.0/textcollection/textitem/fromText?collection_name=donald_duck&access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "url": null, 
  "collection_name": "donald_duck", 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]", 
  "timestamp": "2015-12-29 16:28:06.517297", 
  "inserted_id": "5665a1e8b1f5391201471f86"
}

Request example to "Get info from Text Item" - GET...

curl --ssl-reqd --request GET "https://api.yonderlabs.com/1.0/textcollection/textitem?collection_name=donald_duck&id=5665a1e8b1f5391201471f86&access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "collection_name": "donald_duck", 
  "document": {
    "keywords": [
     {
      "score": 1,
      "name": "search"
     },
     {
      "score": 1,
      "name": "area"
     },
     {
      "score": 1,
      "name": "sq km"
     }
    ], 
   "entities": [
     {
      "info": null,
      "score": 1,
      "type": "Organization",
      "name": "MH370"
     },
     {
      "info": null,
      "score": 1,
      "type": "Organization",
      "name": "ATSB"
     },
     {
      "info": {
        "wikipedia": "http://en.wikipedia.org/wiki/Chester",
        "description": "Chester (/ˈtʃɛstər/ CHESS-tər), is a city in Cheshire, England. Lying on the [...]"
      },
      "score": 0.6,
      "type": "Place",
      "name": "Chester"
     }
    ], 
    "timestamp": "2015-12-29 16:28:06.517297", 
    "_id": "5665a1e8b1f5391201471f86"
  }, 
  "fetched_id": "5665a1e8b1f5391201471f86"
}

Request example to "List all Text Items" - GET...

curl --ssl-reqd --request GET "https://api.yonderlabs.com/1.0/textcollection/textitem?collection_name=donald_duck&access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "count": 12, 
  "ids": [
    "584aca4fb1f53952bc3a8781", 
    "584aca4fb1f53952bc3a8782", 
    "584aca50b1f53952c76440ee", 
    "584aca50b1f53952bc3a8783", 
    "584aca52b1f53952ba8cf07d", 
    "584aca51b1f53952c2845a4c", 
    "584aca51b1f53952c2845a4d", 
    "584aca51b1f53952c3672c0b", 
    "584aca51b1f53952c3672c0c", 
    "584aca52b1f53952c3672c0d", 
    "584aca52b1f53952c55577ea", 
    "584aca53b1f53952c3672c0e"
  ]
}

Request example to "Modify Text Item fromURL" - PUT fromURL...

curl --ssl-reqd --request PUT --data url=http%3A%2F%2Fwww.theguardian.com%2Fworld%2F2015%2Fnov%2F11%2Fgermany-spied-fbi-un-bodies-french-foreign-minister "https://api.yonderlabs.com/1.0/textcollection/textitem/fromText?collection_name=donald_duck&id=5665a1e8b1f5391201471f86&access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "url": "http://www.theguardian.com/world/2015/nov/11/germany-spied-fbi-un-bodies-french-foreign-minister", 
  "collection_name": "donald_duck", 
  "modified_id": "5665a1e8b1f5391201471f86", 
  "timestamp": "2015-12-29 16:28:06.517297", 
  "text": "Germany's foreign intelligence service spied on targets including the French foreign minister, Laurent Fabius, the FBI and the UN Children's Fund, a media report said on Wednesday. The latest news report on the BND spy service fuels a debate in Germany about state surveillance kicked off by the revelations of the US whistleblower Edward Snowden [...]"
}

Request example to "Modify Text Item fromText" - PUT fromText...

curl --ssl-reqd --request PUT --data text="Germany's foreign intelligence service spied on targets including the French foreign minister, Laurent Fabius, the FBI and the UN Children's Fund, a media report said on Wednesday. The latest news report on the BND spy service fuels a debate in Germany about state surveillance kicked off by the revelations of the US whistleblower Edward Snowden [...]" "https://api.yonderlabs.com/1.0/textcollection/textitem/fromText?collection_name=donald_duck&id=5665a1e8b1f5391201471f86&access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "url": null, 
  "collection_name": "donald_duck", 
  "modified_id": "5665a1e8b1f5391201471f86",
  "timestamp": "2015-12-29 16:28:06.517297",  
  "text": "Germany's foreign intelligence service spied on targets including the French foreign minister, Laurent Fabius, the FBI and the UN Children's Fund, a media report said on Wednesday. The latest news report on the BND spy service fuels a debate in Germany about state surveillance kicked off by the revelations of the US whistleblower Edward Snowden [...]"
}

Request example to "Delete Text Item" - DELETE...

curl --ssl-reqd --request DELETE "https://api.yonderlabs.com/1.0/textcollection/textitem?collection_name=donald_duck&id=5665a1e8b1f5391201471f86&access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "collection_name": "donald_duck", 
  "deleted_id": "5665a1e8b1f5391201471f86" 
 }

Create, modify, delete, and retrieve info from Text Items in your Text Collections

This API allows you to manage Text Items in your Text Collections (i.e. create, delete, modify, list).

Create Text Item - POST fromURL

This API allows you to create a new Text Item from the text contained in a URL:

Parameter Type Description Values
collection_name string, required the name of the Text Collection where to insert the new Item -
url string, required the url of the text to be inserted as a new Item of the Text Collection use url-encoding
access_token string, required your access token (40 digits) -

Examples of how-to-call the API and the related output are provided in the right panel.

Create Text Item - POST fromText

This API allows you to create a new Text Item inserting simple text:

Parameter Type Description Values
collection_name string, required the name of the Text Collection where to insert the new Item -
text string, required the text to be inserted as a new Text Item pass the text between "" (e.g. "This is an example") or use url-encoded text
access_token string, required your access token (40 digits) -

Examples of how-to-call the API and the related output are provided in the right panel.

Get info from Text Item - GET

This API allows you to retrieve all information from a Text Item:

Parameter Type Description
collection_name string, required the name of the Text Collection which contains the Text Item
id string, required the ID of the text item
access_token string, required your access token (40 digits)

Examples of how-to-call the API and the related output are provided in the right panel.

List all Text Items - GET

This API allows you to list all Text Items in a Text Collection:

Parameter Type Description
collection_name string, required the name of the Text Collection which contains the Text Item
access_token string, required your access token (40 digits)

Examples of how-to-call the API and the related output are provided in the right panel.

Change Text Item fromURL - PUT fromURL

This API allows you to change the text contained in a Text Item of a Text Collection:

Parameter Type Description Values
collection_name string, required the name of the Text Collection where to change the item -
id string, required the ID of the text item -
url string, required the url of the text to be inserted use url-encoding
access_token string, required your access token (40 digits) -

Examples of how-to-call the API and the related output are provided in the right panel.

Change Text Item fromText - PUT fromText

This API allows you to change the text contained in a Text Item of a Text Collection:

Parameter Type Description Values
collection_name string, required the name of the Text Collection where to change the item -
id string, required the ID of the text item -
text string, required the new text pass the text between "" (e.g. "This is an example") or use url-encoded text
access_token string, required your access token (40 digits) -

Examples of how-to-call the API and the related output are provided in the right panel.

Delete a Text Item - DELETE

This API allows you to delete a Text Item from a Text Collection:

Parameter Type Description
collection_name string, required the name of the Text Collection where to delete the Item
id string, required the ID of the Text Item to be deleted
access_token string, required your access token (40 digits)

Examples of how-to-call the API and the related output are provided in the right panel.

Document Graph

Request example to "Create a Document Graph" - POST...

curl --ssl-reqd --include --request POST "https://api.yonderlabs.com/1.0/textcollection/documentgraph?collection_name=goofy&access_token=YOUR_ACCESS_TOKEN"

... and response header and body (202 "ACCEPTED"):

HTTP/1.1 202 ACCEPTED
Server: nginx/1.4.6 (Ubuntu)
Date: Thu, 26 Oct 2017 10:50:27 GMT
Content-Type: application/json
Content-Length: 157
Connection: keep-alive
API-instance: instance01
{
  "task_type": "DocumentGraphAPI", 
  "collection-name": "goofy", 
  "task_id": "a4e31278-4432-43da-8fbf-1b21562d02f9", 
  "task_status": "PENDING"
}

Request example to "Get results from Document Graph" - GET...

curl --ssl-reqd --header "API-instance: instance01" --request GET "https://api.yonderlabs.com/1.0/textcollection/documentgraph?task_id=e92dff8f-29ca-4286-9876-68d965f4a066&access_token=YOUR_ACCESS_TOKEN"

... and response body, case 1) SUCCESS, i.e. the task is over:

{
  "task_error": null, 
  "task_type": "DocumentGraphAPI", 
  "task_id": "a4e31278-4432-43da-8fbf-1b21562d02f9", 
  "task_result": {
    "timestamp": "2015-12-29 16:28:06.517297", 
    "graph_list": [
      {
        "id": "5661ce38b1f53961fbb5ba8f", 
        "similar_documents": [
          {
            "id": "5661ce38b1f53961fbb5ba90", 
            "score": 0.2182018253178482
          }, 
          {
            "id": "5661ce38b1f53961fbb5bb43", 
            "score": 0.20725070321790517
          }
        ]
      }, 
      {
        "id": "5661ce38b1f53961fbb5bac7", 
        "similar_documents": [
          {
            "id": "5661ce38b1f53961fbb5bb78", 
            "score": 0.25007882768872314
          }, 
          {
            "id": "5661ce38b1f53961fbb5ba2d", 
            "score": 0.20836793197293701
          }, 
          {
            "id": "5661ce38b1f53961fbb5bb75", 
            "score": 0.1719251614907218
          }
        ]
      }
    ]
  }, 
  "collection_name": "goofy", 
  "task_status": "SUCCESS"
}

... and response body, case 2) STARTED (the task has started, but it is not over):

{
  "task_type": "DocumentGraphAPI", 
  "task_id": "e92dff8f-29ca-4286-9876-68d965f4a066", 
  "task_status": "STARTED"
}

... and response body, case 3) PENDING (the task is still pending):

{
  "task_type": "DocumentGraphAPI", 
  "task_id": "e92dff8f-29ca-4286-9876-68d965f4a066", 
  "task_status": "PENDING"
}

Compute all document similarities in your Text Collection

This API analyzes a collection of texts and returns all document cross-similarities.

Create a Document Graph - POST

This API allows you to launch the task which computes document cross-similarities on all items contained in a Text Collection. As detailed in the right panel, as an immediate response to this API, you will get a 202 answer ("ACCEPTED") containing a task identifier task_id to be used later in the GET call.

Please notice that the --include in the POST call displays the response header, which includes the API-instance field. The value of API-instance field (e.g. instance01) must be included later in the following GET call.

Parameter Type Description
collection_name string, required the name of the Text Collection from which to build a Document Graph
access_token string, required your access token (40 digits)

Get results from Document Graph - GET

This API allows you to retrieve computed document cross-similarities on all items contained in a Text Collection. Please notice that the value of the API-instance field shown in the response header of the previous POST call (e.g. instance01) must be included in the GET call after the option --header, as detailed in the right panel.

Parameter Type Description
task_id string, required the identifier of the created Document Graph task
access_token string, required your access token (40 digits)

If results are ready (i.e. document similarities have been computed) you will get a 200 answer ("SUCCESS") and the resulting ouput, as detailed in the right panel (notice that only documents whose list of similar ones is not empty are reported). If the process is still ongoing you will get an adequate status code answer ("STARTED" or "PENDING") meaning that you have to try again a bit later with another GET call.

Document Discovery

Request example to "Discover related documents" - POST fromURL...

curl --ssl-reqd --include --request POST --data url=https%3A%2F%2Fwww.theguardian.com%2Fworld%2F2016%2Fjul%2F22%2Fmissing-flight-mh370-hunt-for-debris-will-not-be-extended "https://api.yonderlabs.com/1.0/textcollection/documentdiscovery/fromURL?collection_name=scrooge&access_token=YOUR_ACCESS_TOKEN"

... and response header and body (202 "ACCEPTED"):

HTTP/1.1 202 ACCEPTED
Server: nginx/1.4.6 (Ubuntu)
Date: Thu, 26 Oct 2017 10:50:27 GMT
Content-Type: application/json
Content-Length: 157
Connection: keep-alive
API-instance: instance01
{
  "task_type": "DocumentDiscoveryAPI", 
  "task_id": "8292fd19-6c94-4570-90bf-c7d2f0afb9ed", 
  "url": "https://www.theguardian.com/world/2016/jul/22/missing-flight-mh370-hunt-for-debris-will-not-be-extended", 
  "collection_name": "scrooge", 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]", 
  "task_status": "PENDING"
}

Request example to "Discover related documents" - POST fromText...

curl --ssl-reqd --include --request POST --data text="The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]" "https://api.yonderlabs.com/1.0/textcollection/documentdiscovery/fromText?collection_name=scrooge&access_token=YOUR_ACCESS_TOKEN"

... and response header and body (202 "ACCEPTED"):

HTTP/1.1 202 ACCEPTED
Server: nginx/1.4.6 (Ubuntu)
Date: Thu, 26 Oct 2017 10:50:27 GMT
Content-Type: application/json
Content-Length: 157
Connection: keep-alive
API-instance: instance01
{
  "task_type": "DocumentDiscoveryAPI", 
  "task_id": "8292fd19-6c94-4570-90bf-c7d2f0afb9ed", 
  "url": null, 
  "collection_name": "scrooge", 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]", 
  "task_status": "PENDING"
}

Request example to "Get related documents" - GET...

curl --ssl-reqd --header "API-instance: instance01" --request GET "https://api.yonderlabs.com/1.0/textcollection/documentdiscovery?task_id=8292fd19-6c94-4570-90bf-c7d2f0afb9ed&access_token=YOUR_ACCESS_TOKEN"

... and response body, case 1) SUCCESS, i.e. the task is over:

{
  "task_error": null, 
  "task_type": "DocumentDiscoveryAPI", 
  "task_id": "8292fd19-6c94-4570-90bf-c7d2f0afb9ed", 
  "url": "https://www.theguardian.com/world/2016/jul/22/missing-flight-mh370-hunt-for-debris-will-not-be-extended", 
  "collection_name": "scrooge", 
  "task_result": {
    "timestamp": "2015-12-29 16:28:06.517297", 
    "discovery_list": [
      {
        "score": 0.24134128928939388, 
        "id": "5661ce38b1f53961fbb5bb25"
      }, 
      {
        "score": 0.18162858119988462, 
        "id": "5661ce38b1f53961fbb5bb24"
      }, 
      {
        "score": 0.15711326735569822, 
        "id": "5661ce38b1f53961fbb5bb29"
      }
    ]
  }, 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]", 
  "task_status": "SUCCESS"
}

... and response body, case 2) STARTED (the task has started, but it is not over):

{
  "task_type": "DocumentDiscoveryAPI", 
  "task_id": "8292fd19-6c94-4570-90bf-c7d2f0afb9ed", 
  "task_status": "STARTED"
}

... and response body, case 3) PENDING (the task is still pending):

{
  "task_type": "DocumentDiscoveryAPI", 
  "task_id": "8292fd19-6c94-4570-90bf-c7d2f0afb9ed", 
  "task_status": "PENDING"
}

Suggest other documents relevant to your text from a Text Collection

Based on the provided text, this API suggests other contextually relevant documents by retrieving them from a Text Collection.

Discover related documents in a Collection - POST fromURL

Given an URL, this API allows you to discover other contextually relevant documents by retrieving them from a Text Collection. As detailed in the right panel, as an immediate response to this API, you will get a 202 answer ("ACCEPTED") containing a task identifier task_id to be used later in the GET call.

Please notice that the --include in the POST call displays the response header, which includes the API-instance field. The value of API-instance field (e.g. instance01) must be included later in the following GET call.

Parameter Type Description Values
collection_name string, required the name of the Text Collection -
url string, required the url of the text use url-encoding
access_token string, required your access token (40 digits) -

Discover related documents in a Collection - POST fromText

Given a text, this API allows you to discover other contextually relevant documents by retrieving them from a Text Collection. As detailed in the right panel, as an immediate response to this API, you will get a 202 answer ("ACCEPTED") containing a task identifier task_id to be used later in the GET call.

Please notice that the --include in the POST call displays the response header, which includes the API-instance field. The value of API-instance field (e.g. instance01) must be included later in the following GET call.

Parameter Type Description Values
collection_name string, required the name of the Text Collection -
text string, required the text document pass the text between "" (e.g. "This is an example") or use url-encoded text
access_token string, required your access token (40 digits) -

Get results from Document Discovery - GET

This API allows you to retrieve most related documents contained in a Text Collection. Please notice that the value of the API-instance field shown in the response header of the previous POST call (e.g. instance01) must be included in the GET call after the option --header, as detailed in the right panel.

Parameter Type Description
task_id string, required the identifier of the created Document Discovery task
access_token string, required your access token (40 digits)

If results are ready (i.e. document similarities have been computed) you will get a 200 answer ("SUCCESS") and the resulting ouput, as detailed in the right panel. If the process is still ongoing you will get an adequate status code answer ("STARTED" or "PENDING") meaning that you have to try again a bit later with another GET call.

Entity Graph

Request example to "Create an Entity Graph" - POST...

curl --ssl-reqd --include --request POST "https://api.yonderlabs.com/1.0/textcollection/entitygraph?collection_name=scrooge&limit=5&access_token=YOUR_ACCESS_TOKEN"

... and response header and body (202 "ACCEPTED"):

HTTP/1.1 202 ACCEPTED
Server: nginx/1.4.6 (Ubuntu)
Date: Thu, 26 Oct 2017 10:50:27 GMT
Content-Type: application/json
Content-Length: 157
Connection: keep-alive
API-instance: instance01
{
  "task_type": "EntityGraphAPI", 
  "collection-name": "scrooge", 
  "task_id": "a4e31278-4432-43da-8fbf-1b21562d02f9", 
  "task_status": "PENDING"
}

Request example to "Get results from Entity Graph" - GET...

curl --ssl-reqd --header "API-instance: instance01" --request GET "https://api.yonderlabs.com/1.0/textcollection/entitygraph?task_id=a4e31278-4432-43da-8fbf-1b21562d02f9&access_token=YOUR_ACCESS_TOKEN"

... and response body, case 1) SUCCESS, i.e. the task is over:

{
  "task_error": null,
  "task_type": "EntityGraphAPI",
  "task_id": "a4e31278-4432-43da-8fbf-1b21562d02f9",
  "collection_name": "scrooge",
  "task_result": {
    "timestamp": "2016-05-06 09:31:44.987771",
    "nodes": [
      {
        "count": 2,
        "info": "Malaysia (/məˈleɪʒə/ mə-LAY-zhə or /məˈleɪsiə/ mə-LAY-see-ə) (Malaysian pronunciation: [məlejsiə]) is a federal constitutional monarchy located in [...]",
        "name": "Malaysia",
        "neighbors": [
          {
            "edge_weight": 0.02197802197802198,
            "id": 1,
            "edge_count": 2
          },
          {
            "edge_weight": 0.02197802197802198,
            "id": 2,
            "edge_count": 2
          },
          {
            "edge_weight": 0.01098901098901099,
            "id": 3,
            "edge_count": 1
          },
          {
            "edge_weight": 0.01098901098901099,
            "id": 4,
            "edge_count": 1
          },
          {
            "edge_weight": 0.01098901098901099,
            "id": 5,
            "edge_count": 1
          }
        ],
        "weight": 0.012578616352201259,
        "type": "Place",
        "id": 0
      },
      {
        "count": 2,
        "info": "Kuala Lumpur is the federal capital and most populous city in Malaysia [...]",
        "name": "Kuala Lumpur",
        "neighbors": [
          {
            "edge_weight": 0.02197802197802198,
            "id": 0,
            "edge_count": 2
          },
          {
            "edge_weight": 0.02197802197802198,
            "id": 2,
            "edge_count": 2
          },
          {
            "edge_weight": 0.01098901098901099,
            "id": 3,
            "edge_count": 1
          },
          {
            "edge_weight": 0.01098901098901099,
            "id": 4,
            "edge_count": 1
          },
          {
            "edge_weight": 0.01098901098901099,
            "id": 5,
            "edge_count": 1
          }
        ],
        "weight": 0.012578616352201259,
        "type": "Place",
        "id": 1
      }
    ],
      "general_info": {
      "edge_type": "sentence",
      "number_of_nodes": 4458,
      "number_of_edges": 73867,
      "density": 0.007435287372392373
    },
    "limit": 5
  },
  "task_status": "SUCCESS"
}      

... and response body, case 2) STARTED (the task has started, but it is not over):

{
  "task_type": "EntityGraphAPI", 
  "task_id": "a4e31278-4432-43da-8fbf-1b21562d02f9", 
  "task_status": "STARTED"
}

... and response body, case 3) PENDING (the task is still pending):

{
  "task_type": "EntityGraphAPI", 
  "task_id": "a4e31278-4432-43da-8fbf-1b21562d02f9", 
  "task_status": "PENDING"
}

Identify a graph of entities from your Text Collection

This API analyzes a collection of texts and extracts a graph with most related named entities, highlighting hidden interactions between people, places and organizations.

Create an Entity Graph - POST

This API allows you to launch the task which computes a co-occurrence graph on all named entities contained in a Text Collection. Co-occurrency is here evaluated at 'sentence' level. As detailed in the right panel, as an immediate response to this API, you will get a 202 answer ("ACCEPTED") containing a task identifier task_id to be used later in the GET call.

Please notice that the --include in the POST call displays the response header, which includes the API-instance field. The value of API-instance field (e.g. instance01) must be included later in the following GET call.

Parameter Type Description
collection_name string, required the name of the Text Collection from which to build an Entity Graph
limit number, optional max # of relevant entities to be returned, in decreasing order of edge weight (if not specified, all results are returned)
access_token string, required your access token (40 digits)

Get results from Entity Graph - GET

This API allows you to retrieve the computed co-occurrence graph on all named entities contained in a Text Collection, where co-occurrency is evaluated at 'sentence' level. Please notice that the value of the API-instance field shown in the response header of the previous POST call (e.g. instance01) must be included in the GET call after the option --header, as detailed in the right panel.

Parameter Type Description
task_id string, required the identifier of the created Entity Graph task
access_token string, required your access token (40 digits)

If results are ready (i.e. the entity graph has been computed) you will get a 200 answer ("SUCCESS") and the resulting ouput, as detailed in the right panel. If the process is still ongoing you will get an adequate status code answer ("STARTED" or "PENDING") meaning that you have to try again a bit later with another GET call.

Entity Discovery

Request example to "Discover related entities" - POST fromURL...

curl --ssl-reqd --include --request POST --data url=https%3A%2F%2Fwww.theguardian.com%2Fworld%2F2016%2Fjul%2F22%2Fmissing-flight-mh370-hunt-for-debris-will-not-be-extended "https://api.yonderlabs.com/1.0/textcollection/entitydiscovery/fromURL?collection_name=scrooge&limit=5&access_token=YOUR_ACCESS_TOKEN"

... and response header and body (202 "ACCEPTED"):

HTTP/1.1 202 ACCEPTED
Server: nginx/1.4.6 (Ubuntu)
Date: Thu, 26 Oct 2017 10:50:27 GMT
Content-Type: application/json
Content-Length: 157
Connection: keep-alive
API-instance: instance01
{
  "task_type": "EntityDiscoveryAPI", 
  "task_id": "8292fd19-6c94-4570-90bf-c7d2f0afb9ed", 
  "url": "https://www.theguardian.com/world/2016/jul/22/missing-flight-mh370-hunt-for-debris-will-not-be-extended", 
  "collection_name": "scrooge", 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]", 
  "task_status": "PENDING"
}

Request example to "Discover related entities" - POST fromText...

curl --ssl-reqd --include --request POST --data text="The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]" "https://api.yonderlabs.com/1.0/textcollection/entitydiscovery/fromText?collection_name=scrooge&limit=5&access_token=YOUR_ACCESS_TOKEN"

... and response header and body (202 "ACCEPTED"):

HTTP/1.1 202 ACCEPTED
Server: nginx/1.4.6 (Ubuntu)
Date: Thu, 26 Oct 2017 10:50:27 GMT
Content-Type: application/json
Content-Length: 157
Connection: keep-alive
API-instance: instance01
{
  "task_type": "EntityDiscoveryAPI", 
  "task_id": "8292fd19-6c94-4570-90bf-c7d2f0afb9ed", 
  "url": null, 
  "collection_name": "scrooge", 
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]", 
  "task_status": "PENDING"
}

Request example to "Get related entities" - GET...

curl --ssl-reqd --header "API-instance: instance01" --request GET "https://api.yonderlabs.com/1.0/textcollection/entitydiscovery?task_id=8292fd19-6c94-4570-90bf-c7d2f0afb9ed&access_token=YOUR_ACCESS_TOKEN"

... and response body, case 1) SUCCESS, i.e. the task is over:

{
  "task_error": null,
  "task_type": "EntityDiscoveryAPI",
  "task_id": "8292fd19-6c94-4570-90bf-c7d2f0afb9ed",
  "url": "https://www.theguardian.com/world/2016/jul/22/missing-flight-mh370-hunt-for-debris-will-not-be-extended",
  "collection_name": "scrooge",
  "task_result": {
    "timestamp": "2016-05-06 09:58:00.787070",
    "limit": 5,
    "entities": [
      {
        "count": 1,
        "info": "Malaysia is a federal constitutional monarchy located in Southeast Asia. It consists of [...]",
        "type": "Place",
        "name": "Malaysia",
        "graph": {
          "is_in_graph": true,
          "neighbors": [
            {
              "edge_weight": 0.02197802197802198,
              "id": 0,
              "edge_count": 2
            },
            {
              "edge_weight": 0.02197802197802198,
              "id": 2,
              "edge_count": 2
            },
            {
              "edge_weight": 0.01098901098901099,
              "id": 3,
              "edge_count": 1
            },
            {
              "edge_weight": 0.01098901098901099,
              "id": 4,
              "edge_count": 1
            },
            {
              "edge_weight": 0.01098901098901099,
              "id": 5,
              "edge_count": 1
            }
          ],
          "id": 1,
          "weight": 0.012578616352201259
        }
      }
    ],
    "graph": {
      "discovered_neighbors": [
        {
          "count": 2,
          "info": "The South China Sea is a marginal sea that is part of the Pacific Ocean [...]",
          "name": "South China Sea",
          "weight": 0.012578616352201259,
          "type": "Place",
          "id": 0
        },
        {
          "count": 15,
          "info": "The Yang di-Pertuan Agong is the monarch and head of state of Malaysia [...]",
          "name": "Yang di-Pertuan Agong",
          "weight": 0.09433962264150944,
          "type": "Person",
          "id": 2
        },
        {
          "count": 1,
          "info": "Indonesia, officially the Republic of Indonesia, is a country in Southeast Asia [...]",
          "name": "Indonesia",
          "weight": 0.006289308176100629,
          "type": "Place",
          "id": 3
        },
        {
          "count": 1,
          "info": "Singapore officially the Republic of Singapore, and often referred to as the Lion City, the Garden City, and the Red Dot, is a global city [...]",
          "name": "Singapore",
          "weight": 0.006289308176100629,
          "type": "Place",
          "id": 4
        },
        {
          "count": 1,
          "info": "Vietnam, officially the Socialist Republic of Vietnam, is the easternmost country on the Indochina Peninsula in Southeast Asia [...]",
          "name": "Vietnam",
          "weight": 0.006289308176100629,
          "type": "Place",
          "id": 5
        }
      ],
      "general_info": {
        "edge_type": "sentence",
        "number_of_nodes": 4458,
        "number_of_edges": 73867,
        "density": 0.007435287372392373
      }
    }
  },
  "text": "The hunt for Malaysia Airlines flight MH370 is to be suspended if evidence of the missing jet is not found in the current search area. The transport ministers of Australia, Malaysia and China, representing the country leading the search, the airline and the home of the majority of its passengers, met to discuss the future of the search in the Malaysian federal administrative centre of Putrajaya on Friday. They announced that [...]",
  "task_status": "SUCCESS"
}

... and response body, case 2) STARTED (the task has started, but it is not over):

{
  "task_type": "EntityDiscoveryAPI", 
  "task_id": "8292fd19-6c94-4570-90bf-c7d2f0afb9ed", 
  "task_status": "STARTED"
}

... and response body, case 3) PENDING (the task is still pending):

{
  "task_type": "EntityDiscoveryAPI", 
  "task_id": "8292fd19-6c94-4570-90bf-c7d2f0afb9ed", 
  "task_status": "PENDING"
}

Find other relevant entities not in your text from a Text Collection

Based on the submitted text, this API finds contextually relevant named entities originally not in your text, by mining them from a Text Collection.

Discover related entities from a Collection - POST fromURL

Given an URL, this API allows you to discover other contextually relevant named entities by retrieving them from a Text Collection. As detailed in the right panel, as an immediate response to this API, you will get a 202 answer ("ACCEPTED") containing a task identifier task_id to be used later in the GET call.

Please notice that the --include in the POST call displays the response header, which includes the API-instance field. The value of API-instance field (e.g. instance01) must be included later in the following GET call.

Parameter Type Description Values
collection_name string, required the name of the Text Collection -
url string, required the url of the text use url-encoding
limit number, optional the max # of relevant entities to be returned If not specified, all results are returned
access_token string, required your access token (40 digits) -

Discover related entities in a Collection - POST fromText

Given a text, this API allows you to discover other contextually relevant named entities by retrieving them from a Text Collection. As detailed in the right panel, as an immediate response to this API, you will get a 202 answer ("ACCEPTED") containing a task identifier task_id to be used later in the GET call.

Please notice that the --include in the POST call displays the response header, which includes the API-instance field. The value of API-instance field (e.g. instance01) must be included later in the following GET call.

Parameter Type Description Values
collection_name string, required the name of the Text Collection -
text string, required the text document pass the text between "" (e.g. "This is an example") or use url-encoded text
limit number, optional the max # of relevant entities to be returned If not specified, all results are returned
access_token string, required your access token (40 digits) -

Get results from Entity Discovery - GET

This API allows you to get results containing relevant named entities discovered in a Text Collection. Please notice that the value of the API-instance field shown in the response header of the previous POST call (e.g. instance01) must be included in the GET call after the option --header, as detailed in the right panel.

Parameter Type Description
task_id string, required the identifier of the created Entity Discovery task
access_token string, required your access token (40 digits)

If results are ready (i.e. the graph-related entities have been computed) you will get a 200 answer ("SUCCESS") and the resulting ouput, as detailed in the right panel. If the process is still ongoing you will get an adequate status code answer ("STARTED" or "PENDING") meaning that you have to try again a bit later with another GET call.

Document Clustering

Request example to "Cluster your text documents" - POST...

curl --ssl-reqd --include --request POST "https://api.yonderlabs.com/1.0/textcollection/documentclustering?collection_name=goofy&access_token=YOUR_ACCESS_TOKEN"

... and response header and body (202 "ACCEPTED"):

HTTP/1.1 202 ACCEPTED
Server: nginx/1.4.6 (Ubuntu)
Date: Thu, 26 Oct 2017 10:50:27 GMT
Content-Type: application/json
Content-Length: 157
Connection: keep-alive
API-instance: instance01
{
  "task_type": "DocumentClusteringAPI", 
  "collection-name": "goofy", 
  "task_id": "7284e228-a934-4a88-ac52-82764ed0b838", 
  "task_status": "PENDING"
}

Request example to "Get results from Document Clustering" - GET...

curl --ssl-reqd --header "API-instance: instance01" --request GET "https://api.yonderlabs.com/1.0/textcollection/documentclustering?task_id=7284e228-a934-4a88-ac52-82764ed0b838&access_token=YOUR_ACCESS_TOKEN"

... and response body, case 1) SUCCESS, i.e. the task is over:

{
  "task_error": null, 
  "task_type": "DocumentClusteringAPI", 
  "task_id": "7284e228-a934-4a88-ac52-82764ed0b838", 
  "collection_name": "goofy", 
  "task_result": {
    "timestamp": "2017-02-20 10:12:20.047671", 
    "graph_clusters": [
      {
        "common_entities": [
          "Melania Trump", 
          "Melbourne", 
          "Fla", 
          "Donald Trump", 
          "Mussler", 
          "Florida", 
          "Melani", 
          "White House", 
          "Russian", 
          "U.S."
        ], 
        "common_tags": [
          "Melania Trump", 
          "president", 
          "rally", 
          "media", 
          "side", 
          "event", 
          "supporters", 
          "Melbourne", 
          "reporters", 
          "Donald Trump"
        ], 
        "ids": [
          "58aabf66b1f539056ab02d30", 
          "58aabfd1b1f539055b0aa27a"
        ], 
        "near_duplicates": [ ], 
        "common_keywords": [
          "president", 
          "rally", 
          "media", 
          "side", 
          "event", 
          "supporters", 
          "reporters", 
          "guests", 
          "attendance", 
          "way"
        ], 
        "size": 2
      }, 
      {
        "common_entities": [
          "USA TODAY Sports", 
          "NBA", 
          "Bob Donnan", 
          "James", 
          "Davis", 
          "Derick E. Hingle", 
          "Westbrook", 
          "Gerald Herbert", 
          "Western Conference", 
          "AP"
        ], 
        "common_tags": [
          "USA TODAY Sports", 
          "NBA", 
          "Bob Donnan", 
          "dunk", 
          "James", 
          "slam", 
          "Davis", 
          "contest", 
          "Derick E. Hingle", 
          "ball"
        ], 
        "ids": [
          "58aac083b1f53905654849f7", 
          "58aac0abb1f539056c74ef2f"
        ],
        "near_duplicates": [
          [ 
            "58aac083b1f53905654849f7", 
            "58aac0abb1f539056c74ef2f"
          ]
        ], 
        "common_keywords": [
          "dunk", 
          "slam", 
          "contest", 
          "ball", 
          "laugh", 
          "celebrities", 
          "guard", 
          "game", 
          "western conference", 
          "scores"
        ], 
        "size": 2
      }
    ]
  }, 
  "task_status": "SUCCESS"
}

... and response body, case 2) STARTED (the task has started, but it is not over):

{
  "task_type": "DocumentClusteringAPI", 
  "task_id": "7284e228-a934-4a88-ac52-82764ed0b838", 
  "task_status": "STARTED"
}

... and response body, case 3) PENDING (the task is still pending):

{
  "task_type": "DocumentClusteringAPI", 
  "task_id": "7284e228-a934-4a88-ac52-82764ed0b838", 
  "task_status": "PENDING"
}

Cluster text documents in your Text Collection

This API analyzes a collection of texts and clusters documents according to their similarities.

Launch a Document Clustering - POST

This API allows you to launch the task which computes document clusters on all the items contained in a Text Collection. As detailed in the right panel, as an immediate response to this API, you will get a 202 answer ("ACCEPTED") containing a task identifier task_id to be used later in the GET call.

Please notice that the --include in the POST call displays the response header, which includes the API-instance field. The value of API-instance field (e.g. instance01) must be included later in the following GET call.

Parameter Type Description
collection_name string, required the name of the Text Collection on which to lauch Document Clustering
access_token string, required your access token (40 digits)

Get results from Document Clustering - GET

This API allows you to retrieve computed document clusters contained in a Text Collection. Please notice that the value of the API-instance field shown in the response header of the previous POST call (e.g. instance01) must be included in the GET call after the option --header, as detailed in the right panel.

Parameter Type Description
task_id string, required the identifier of the created Document Clustering task
access_token string, required your access token (40 digits)

If results are ready (i.e. document clusters have been computed) you will get a 200 answer ("SUCCESS") and the resulting ouput, as detailed in the right panel. Please notice that, in case duplicates or near-duplicates are found, these are listed in the dedicated field near_duplicates.

If the process is still ongoing you will get an adequate status code answer ("STARTED" or "PENDING") meaning that you have to try again a bit later with another GET call.

API on Images

The following set of API allows for extracting semantic information from images.

Face Analysis

Request example - POST fromURL...

curl --ssl-reqd --request POST --data url="http://media.salon.com/2016/01/donald_trump69.jpg" "https://api.yonderlabs.com/1.0/image/faceanalysis/fromURL?access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "url": "http://media.salon.com/2016/01/donald_trump69.jpg", 
  "image": null, 
  "image_width": 620, 
  "image_height": 412, 
  "faces": [
    {
      "position": {
        "bottom_right_y": 198, 
        "top_left_x": 288, 
        "top_left_y": 30, 
        "bottom_right_x": 455
      }, 
      "attributes": {
        "gender": "Male", 
        "age": "60-100"
      }
    }
  ], 
  "total_faces": 1
}

Request example - POST fromFile...

curl --ssl-reqd --request POST --form image="@donald-trump.jpg" "https://api.yonderlabs.com/1.0/image/faceanalysis/fromImage?access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
  "url": null, 
  "image": "@donald-trump.jpg", 
  "image_width": 620, 
  "image_height": 412, 
  "faces": [
    {
      "position": {
        "bottom_right_y": 198, 
        "top_left_x": 288, 
        "top_left_y": 30, 
        "bottom_right_x": 455
      }, 
      "attributes": {
        "gender": "Male", 
        "age": "60-100"
      }
    }
  ], 
  "total_faces": 1
}

Analyze faces in an image

This service provides facial analysis on images, including detection, gender and age prediction. Allowed input sources are: images retrieved from an URL ("from URL") or images uploaded from files ("from file").

Face Analysis - POST fromURL

Attribute Type Description Values
url string, required the URL of the image use url-encoding
Parameter Type Description Values
gender string, optional gender prediction "false", "true" (default)
age string, optional age prediction (beta) "false", "true" (default)
access_token string, required your access token (40 digits) -

Examples of how-to-call the API and the related output are provided in the right panel.

Face Analysis - POST fromFile

Attribute Type Description Values
file string, required the path of the local image file pass the path between "" (e.g. "@/usr/myself/Desktop/donald-trump.jpg")
Parameter Type Description Values
gender string, optional gender prediction "false", "true" (default)
age string, optional age prediction (beta) "false", "true" (default)
access_token string, required your access token (40 digits) -

Examples of how-to-call the API and the related output are provided in the right panel.

Get User Information

Request example

curl --ssl-reqd --request GET "https://api.yonderlabs.com/1.0/user/userinfo?access_token=YOUR_ACCESS_TOKEN"

... and response body (200/JSON):

{
    "username": "test",
    "total_premium_credits": 1000000,
    "class": "premium",
    "available_credits_today": 100000,
    "available_premium_credits": 950264,
    "credits_limit": {
        "day": 100000
    },
    "requests_limit": {
        "all": {
            "second": 100
        },
        "documentdiscovery": {
            "minute": 100
        },
        "documentgraph": {
            "minute": 100
        },
        "entitygraph": {
            "minute": 100
        },
        "image": {
            "second": 100
        },
        "entitydiscovery": {
            "minute": 100
        },
        "documentclustering": {
            "minute": 100
        }
    },
    "authorized_for": [
        "textextraction",
        "languagedetection",
        "entityextraction",
        "keywordextraction",
        "sentimentanalysis"
    ],
    "email": "demo@yonderlabs.com"
}

The following API allows for extracting user information.

Parameter Type Description
access_token string, required your access token (40 digits)

Examples of how-to-call the API and the related output are provided in the right panel.

Return Codes & Errors

YonderAPI returns codes that follow the HTTP standard.

Successfull requests

When everything goes fine, YonderAPI returns HTTP codes of the type 2xx:

Error Code Meaning
200 OK
201 CREATED
202 ACCEPTED
204 NO CONTENT

Client-side errors

When something goes wrong on the request side, YonderAPI returns HTTP error codes of type 4xx:

Error Code Meaning
400 BAD REQUEST (e.g. a required parameter is missing)
401 UNAUTHORIZED (e.g. wrong credentials)
404 NOT FOUND (e.g. misspelled resource)
405 METHOD NOT ALLOWED (e.g. GET is requested but only POST is available)

Error messages are self-explanatory and clearly point where the problem is. Examples of some possible error responses are provided aside:

{
    "message": {
        "language": "AR language is not supported."
    }
}
{
    "message": {
        "language": "Text and taxonomy languages do not match."
    }
}
{
    "message": {
        "text": "Text too short."
    }
}
{
    "message": {
        "text": "Missing required parameter in the post body."
    }
}
{
    "message": {
        "url": "Missing required parameter in the post body."
    }
}
{
    "message": {
        "url ": "Extracted text is empty. Invalid URL?"
    }
}
{
    "message": {
        "limit": "Value is too low: the minimum accepted is 3."
    }
}
{
    "message": {
        "ratelimit": "Limit of 1000000 requests/day reached for endpoint languagedetection."
    }
}
{
    "message": {
        "url": "Unsuccessful text extraction. Invalid URL?"
    }
}
{
  "message": {
    "collection": "The collection you are trying to create already exists."
  }
}
{
  "message": {
    "collection": "The collection you are trying to access does not exist."
  }
}
{
  "message": {
    "collection": "Error while processing your request."
  }
}
{
  "message": {
    "collection": "The document you are trying to access does not exist."
  }
}
{
  "message": {
    "collection": "The id is not a valid ObjectId."
  }
}
{
  "message": {
    "collection": "The collection name you choose is reserved."
  }
}
{
  "message": {
    "collection": "The collection you are trying to access is full (100,000 documents)."
  }
}
{
  "message": {
    "collection": "You reached the maximum allowed number of collections (1000)."
  }
}

Server-side errors

When something goes wrong on the API side, YonderAPI returns HTTP error code 500 INTERNAL SERVER ERROR with a message body such as the ones provided aside:

{
    "message": {
        "error": "API processing error - Code 001." 
    }
}