For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Go to Platform
HomeSDKs & toolsAPI referencePricing
  • API reference
      • GETSearch
      • POSTSearch
      • POSTContents
      • POSTResearch
      • POSTFinance Research
  • Error handling
    • Error code reference
LogoLogo
HomeSDKs & toolsAPI referencePricing
LogoLogo
Go to Platform
API reference

Search

|View as Markdown|Open in Claude|
GET
https://ydc-index.io/v1/search
GET
/v1/search
$curl -G https://ydc-index.io/v1/search \
>     -H "X-API-Key: <apiKey>" \
>     --data-urlencode "query=What are the latest geopolitical updates from India" \
>     -d count=10 \
>     --data-urlencode "include_domains=timesofindia.indiatimes.com, ndtv.com, thehindu.com"
1{
2  "results": {
3    "web": [
4      {
5        "url": "https://timesofindia.indiatimes.com/topic/geopolitics/news",
6        "title": "Geopolitics News | Latest News on Geopolitics - Times of India",
7        "description": "European nations, particularly Denmark and Norway, are scrutinizing Chinese-made Yutong buses over security fears. Operators worry that 'over-the-air' software updates could allow remote immobilization of the fleet, mirroring concerns over Chinese tech in 5G networks. This potential vulnerability, inherent in connected vehicles, raises geopolitical questions about reliance on foreign manufacturers. India ...",
8        "snippets": [
9          "European nations, particularly Denmark and Norway, are scrutinizing Chinese-made Yutong buses over security fears. Operators worry that 'over-the-air' software updates could allow remote immobilization of the fleet, mirroring concerns over Chinese tech in 5G networks. This potential vulnerability, inherent in connected vehicles, raises geopolitical questions about reliance on foreign manufacturers. India secures 3rd place in Oz think tank's Asia Power Index",
10          "Nations like New Zealand, parts of Australia, Iceland, and select South American and African countries are frequently cited as potentially more resilient to widespread conflict and its devastating aftermath. India-EU summit: FTA, defence and connectivity among key outcomes, EU seeks Paris commitment ... Pheasant Island, a tiny river island between Spain and France, uniquely swaps sovereignty every six months. This geopolitical gem's alternating control stems from the 1659 Treaty of the Pyrenees, a testament to centuries of cooperation.",
11          "Check out for the latest news on geopolitics along with geopolitics live news at Times of India",
12          "Despite massive viewership, he feels his content tackling geopolitical issues is too risky for corporate partners, leading him to expect no further wins. Economy enters H2 on stable footing: Finance ministry ... India's economy enters the second half of FY26 on a stable footing, supported by contained inflation, resilient domestic demand, and supportive policies. While global uncertainties pose risks to exports and capital flows, strong public capital expenditure and firming rural and urban demand are expected to maintain growth momentum."
13        ],
14        "thumbnail_url": "https://static.toiimg.com/photo/47529300.cms",
15        "favicon_url": "https://you.com/favicon?domain=timesofindia.indiatimes.com&size=128"
16      },
17      {
18        "url": "https://worldview.stratfor.com/region/south-asia/india",
19        "title": "India - Geopolitics, Analysis and News",
20        "description": "Profile · Notifications · Sign Out · Articles · India · FILTER: · Select · SORT:",
21        "snippets": [
22          "The Weekly Rundown: U.S.-Saudi Meeting, Military Escalation in the Caribbean · AssessmentsNov 11, 2025 · Back-to-Back Blasts in India and Pakistan Raise Fears of Another Escalation · SnapshotsOct 16, 2025 · India and Canada's Diplomatic Reset: Opportunities and Challenges · On GeopoliticsOct 7, 2025 ·",
23          "U.S. Tariffs Strain India's Exports Amid Stalled Trade Talks"
24        ],
25        "favicon_url": "https://you.com/favicon?domain=worldview.stratfor.com&size=128"
26      },
27      {
28        "url": "https://timesofindia.indiatimes.com/blogs/the-crisis-of-shallow-information/from-participant-to-power-why-2025-marks-indias-geopolitical-coming-of-age/",
29        "title": "From participant to power: Why 2025 marks India's geopolitical ...",
30        "description": "For years, India has been called a “rising power.“ The phrase carried promise, but also hesitation as if India's ascent was always just over the horizon. The Asia Power Index 2025, released by the Lowy...",
31        "snippets": [
32          "For years, India has been called a “rising power.“ The phrase carried promise, but also hesitation as if India's ascent was always just over the horizon. The Asia Power Index 2025, released by the Lowy Institute, finally settles that debate. India has emerged as Asia's third most powerful nation, surpassing Japan and solidifying its place behind only the United States and China.",
33          "As the author of Mindscape Unveiled and The Blood of Baiskahi, I explore how policies, economic systems, and international relations influence people's daily lives, especially those in India's middle and lower-income groups. My writing emphasizes geopolitics, diplomacy, inequality, and global trade, blending academic analysis with social insight.",
34          "More importantly, this year's edition introduced a dedicated India Spotlight, recognizing New Delhi as a unique force shaping the continent's balance of power. India is no longer a peripheral participant in Asian geopolitics it's now a central pillar of influence in a region undergoing seismic change.",
35          "Economic inequality, uneven education quality, and environmental stress remain unresolved. But the narrative has shifted India is now seen as a nation that confronts its weaknesses instead of being defined by them. ... The geopolitical context makes India's rise even more significant."
36        ],
37        "thumbnail_url": "https://static.toiimg.com/photo/115047089.cms",
38        "page_age": "2025-11-30T04:39:48",
39        "favicon_url": "https://you.com/favicon?domain=timesofindia.indiatimes.com&size=128"
40      },
41      {
42        "url": "https://www.drishtiias.com/daily-updates/daily-news-analysis/geopolitical-challenges-and-opportunities-for-india-in-2023",
43        "title": "Geopolitical Challenges and Opportunities for India in 2023",
44        "description": "As the G20 Chair India is looking forward to shaping conversations on issues confronting the world.",
45        "snippets": [
46          "India's strategic response has been guided by a thinking that one has to stand up to the bully, but that has come at a cost, with soldiers braving the harsh winter in eastern Ladakh for the third year in a row. As China sees itself as a superpower and whose time has come, more clashes and competing interests with India are likely, which will have to be resolved through negotiations.",
47          "Nepal witnessed a dramatic turn of events, with rebel-turned-politician Pushpa Kamal Dahal 'Prachanda' becoming the Prime Minister and former PM K P Oli — a known India-baiter in recent years — holding the keys to the government. This will pose a significant challenge for India, which has seen Beijing's influence grow in Kathmandu in recent years. ... Elections in Pakistan are scheduled for later in 2023.",
48          "In respect of India-Sri Lanka relations, discuss how domestic factors influence foreign policy. (2013) Q2. At the international level, bilateral relations between most nations are governed on the policy of promoting one's own national interest without any regard for the interest of other nations.",
49          "As UN Security Council's non-permanent member for 2 years, India sought to project its views and contribute to the global conversations. ... The Russian invasion of Ukraine has upended the global order in place since World War II, impacted the world's food and energy security, and is pushing the global economy towards a recession. The nuclear rhetoric from Russian leaders has caused anxiety, while the strategic embrace of Russia and China is another worry."
50        ],
51        "thumbnail_url": "https://www.drishtiias.com/drishti/img/drishti-dual-logo.jpg",
52        "favicon_url": "https://you.com/favicon?domain=www.drishtiias.com&size=128"
53      },
54      {
55        "url": "https://www.drishtiias.com/daily-updates/daily-news-editorials/india-s-multi-alignment-in-contemporary-geopolitics",
56        "title": "India's Multi-alignment in Contemporary Geopolitics",
57        "description": "Indian Prime Minister's recent visit to Russia showcased India's adept multi-alignment strategy. While maintaining warm ties with Russia, including agreements on boosting trade and cooperation on various fronts, India also addressed concerns about the Ukraine war and the need for peaceful ...",
58        "snippets": [
59          "Indian Prime Minister's recent visit to Russia showcased India's adept multi-alignment strategy. While maintaining warm ties with Russia, including agreements on boosting trade and cooperation on various fronts, India also addressed concerns about the Ukraine war and the need for peaceful resolution.",
60          "Enhanced Inter-ministerial Coordination: Establish a more robust inter-ministerial coordination mechanism, perhaps a 'Diplomatic Strategy Group', that brings together representatives from various ministries (External Affairs, Defense, Commerce, Science & Technology, etc.) to ensure coherence in India's international engagements across different domains. Specialized Diplomatic Cadres: Develop specialized diplomatic cadres focused on emerging areas like tech diplomacy, climate diplomacy, and health diplomacy. These experts can navigate the complex intersections of these fields with geopolitics, ensuring more informed and nuanced engagement in these crucial areas.",
61          "This editorial is based on “Message from Moscow: India-Russia relationship is not in 'terminal decline'“ which was published in The Indian Express on 11/072024. The article highlights India's nuanced multi-alignment strategy, balancing relations with Russia amid global geopolitical challenges, emphasizing diplomatic finesse, economic cooperation, and strategic engagement to reinforce bilateral resilience and navigate international complexities effectively.",
62          "For instance, India's continued oil purchases from Russia amid the Ukraine conflict have strained its relations with Western allies, particularly the EU. This balancing act becomes increasingly difficult as geopolitical tensions rise, forcing India to make tough choices that may disappoint one partner or another."
63        ],
64        "thumbnail_url": "https://www.drishtiias.com/drishti/img/drishti-dual-logo.jpg",
65        "favicon_url": "https://you.com/favicon?domain=www.drishtiias.com&size=128"
66      },
67      {
68        "url": "https://www.ndtv.com/topic/geopolitical",
69        "title": "Geopolitical: Latest News, Photos, Videos on Geopolitical - NDTV.COM",
70        "description": "Find Geopolitical Latest News, Videos & Pictures on Geopolitical and see latest updates, news, information from NDTV.COM. Explore more on Geopolitical.",
71        "snippets": [
72          "Gold surged above $4,000 an ounce to hit a record on Wednesday, driven by investors seeking safety from mounting economic and geopolitical uncertainty, alongside expectations of further interest rate cuts by the US Federal Reserve. In a landmark development that could reshape regional geopolitics, Afghan Foreign Minister Amir Khan Muttaqi of the Taliban government is all set to visit India on October 9.",
73          "IndiGo flight 6E1703 from Kolkata touched down in the southern Chinese city ofGuangzhou shortly before 4:00 am, officially resuming nonstop air links that had been suspended since 2020 due to the pandemic and subsequent geopolitical tensions. Dimon noted that several factors are contributing to the current atmosphere of uncertainty, including geopolitical tensions.",
74          "China's new visa programme aimed at attracting foreign tech talent launches this week, a move seen boosting Beijing's fortunes in its geopolitical rivalry with Washington as a new US visa policy prompts would-be applicants to search for alternatives. Congress's Sam Pitroda, mired deep in another controversy after his “at home in neighbouring countries“ remark, has issued a clarification. The Chinese government's heavy investment in AI, coupled with its strategic goal to lead the global AI race by 2030, offered him unparalleled resources. Amid trade tensions between India and the United States over President Donald Trump's punitive tariffs, US Secretary of State Marco Rubio has hailed New Delhi as one of Washington's “top relationships“ in the world today.",
75          "India's defence manufacturing is not only about Atmanirbharta, but also about making in India and selling to the world, according to industry leaders at the NDTV Defence Summit 2025. ... BCCI secretary Devajit Saikia said that the no-handshake policy is expected to continue on the cricket field as the geopolitical situation between the two countries is not 'conductive'."
76        ],
77        "thumbnail_url": "https://cdn.ndtv.com/common/images/ogndtv.png",
78        "favicon_url": "https://you.com/favicon?domain=www.ndtv.com&size=128"
79      },
80      {
81        "url": "https://www.sanskritiias.com/current-affairs/indias-position-in-the-current-global-geopolitical-scenario",
82        "title": "India's Position in the Current Global Geopolitical Scenario - ...",
83        "description": "Global geopolitics is changing and traditional power alignments are changing due to conflicts, economic instability and changing alliances. India needs to deal with these changes to safeguard its interests.",
84        "snippets": [
85          "India's silent stance on Israel-Gaza and Israel-Iran conflicts threatens to reduce geopolitical influence.",
86          "Regional conflicts: Ukraine war, West Asia tensions and Indo-Pacific militarization are increasing pressure on global governance. Economic nationalism: Supply chain fragmentation, technology restrictions and protectionism. US imposing high import duties on various countries. Pakistan based terrorist groups involved in Pahalgam attack declared as terrorists by UN (April 22, 2025). India's decisive military retaliation received mixed global reactions.",
87          "US imposes 25% tariff on Indian goods on the day of India-US NISAR satellite launch. Threat of tariff hike on Russian oil imports despite Russia-related imports. 'America First' policies discouraging US companies from investing in India.",
88          "Purchase of crude oil from Russia by various countries despite US sanctions like CAATSA · Fragmented multilateralism: WTO, UN and other institutions are facing a crisis of credibility and effectiveness."
89        ],
90        "thumbnail_url": "https://www.sanskritiias.com/frontview/assets/images/sanskriti-logo.png",
91        "favicon_url": "https://you.com/favicon?domain=www.sanskritiias.com&size=128"
92      },
93      {
94        "url": "https://www.drishtiias.com/daily-updates/daily-news-analysis/global-geopolitical-intricacies-and-opportunities-for-india",
95        "title": "Global Geopolitical Intricacies and Opportunities for India",
96        "description": "India must continue evolving its diplomatic stance in the Israel-Hamas conflict, aiming for a balanced approach between supporting Israel and addressing concerns of the Global South",
97        "snippets": [
98          "India must continue evolving its diplomatic stance in the Israel-Hamas conflict, aiming for a balanced approach between supporting Israel and addressing concerns of the Global South. Seeking ways to contribute positively to peace-building efforts and advocating for humanitarian aid could be crucial. The free trade pacts with the UK and European partners are said to be at a critical stage.",
99          "For Mains: Global Geopolitical Intricacies and Opportunities for India. ... Despite India's emphasis on that, “this is not the era of war“, the Year 2023 became a year of wars: Russia-Ukraine conflict and the ongoing war in the Gaza Strip are now among the most destructive conflicts of recent decades.",
100          "For Prelims: Global Geopolitical Intricacies and Opportunities for India, Russia-Ukraine conflict and the ongoing war in the Gaza Strip, Khalistani separatist in the US.",
101          "Israel's angry and disproportionate response has so far killed more than 20,000 Palestinians in Gaza — which has attracted criticism from even the US. The Israeli-Arab reconciliation process has been derailed for now, and the future of Gaza is unknown. India backed a two-state solution to resolve the decades-old Israel-Palestine conflict and bring lasting peace to the troubled region. ... After successful visits by the Indian and President Joe Biden to each other's capitals, bilateral ties are facing headwinds over allegations of an Indian official link to an assassination plot against a Khalistani separatist in the US."
102        ],
103        "thumbnail_url": "https://www.drishtiias.com/drishti/img/drishti-dual-logo.jpg",
104        "favicon_url": "https://you.com/favicon?domain=www.drishtiias.com&size=128"
105      },
106      {
107        "url": "https://www.lowyinstitute.org/the-interpreter/india-may-not-be-interested-geopolitics-geopolitics-interested-india",
108        "title": "India may not be interested in geopolitics, but geopolitics is ...",
109        "description": "The coming year will test the boundaries of India's “strategic autonomy“.",
110        "snippets": [
111          "So far India has managed to maintain close relations with both Russia and the West (Sajjad Hussain/AFP via Getty Images) ... If 2024 was the year of elections, then 2025 will be the year of geopolitics. At least that is the case for South Asia where every country in the region (minus Nepal) went to the polls within a span of 12 months.",
112          "However, for India in 2025, geopolitics will trump domestic politics. The government of Prime Minister Narendra Modi was re-elected for a third consecutive term in 2024, albeit on a weakened mandate. The country faces a limited electoral schedule this year, with only two states going to the polls – Delhi and Bihar.",
113          "Relations with Bangladesh will also be tested as Dhaka submitted a request to extradite Sheikh Hasina who has been residing in India since she was ousted in August. All these developments come amid a more volatile global geopolitical climate fuelled by the return of Donald Trump to the White House.",
114          "One of the first tests for New Delhi will come with Putin's visit to India during the first half of the year. So far India has managed to maintain close relations with both Russia and the West while distinguishing itself from other countries that are aligned with Moscow, including China, North Korea and Iran."
115        ],
116        "thumbnail_url": "https://www.lowyinstitute.org/sites/default/files/2025-01/GettyImages-2057346280.jpg",
117        "favicon_url": "https://you.com/favicon?domain=www.lowyinstitute.org&size=128"
118      },
119      {
120        "url": "https://www.geopoliticalmonitor.com/tag/india-politics/",
121        "title": "India Politics News, Background, & Risk Analysis",
122        "description": "The latest India Politics news and risk analysis. The Geopolitical Monitor provides objective and critical insights into the most pressing issues shaping global geopolitics, helping you keep pace with a changing world.",
123        "snippets": [
124          "Prime Minister Modi is in Central Asia trying to widen India's footprint in the region, with one major concern being an early implementation of the Turkmenistan-Afghanistan-Pakistan-India (TAPI) pipeline. ... The Geopoliticalmonitor's V.Balasubramaniyan explores the evolution and present composition of the Maoist movement in India.",
125          "In cozying up to India, Washington is putting geopolitics over any shared commitment to democracy and human rights.",
126          "Narratives of a 'greater India,' or civilizational state reaching back thousands of years have paid dividends in domestic Indian politics.",
127          "But they're also unnerving India's neighbors and creating new headaches for New Delhi's regional engagement in South Asia."
128        ],
129        "thumbnail_url": "https://www.geopoliticalmonitor.com/wp-content/uploads/2014/01/gpm_splash.jpg",
130        "favicon_url": "https://you.com/favicon?domain=www.geopoliticalmonitor.com&size=128"
131      }
132    ],
133    "news": [
134      {
135        "title": "India entering golden era of defence innovation: Rajnath",
136        "description": "New Delhi, Nov 25 (PTI) Amid a rapidly changing world and evolving geopolitics, India must move beyond a reactive approach and adopt a “proactive“ outlook to make itself future-ready, Defence Minister Rajnath Singh said on Tuesday. In his address at 'Swavlamban 2025' being held at the Manekshaw Centre here, the Navy's flagship event on innovation […]",
137        "page_age": "2025-11-25T12:31:29",
138        "thumbnail_url": "https://static.theprint.in/wp-content/uploads/2023/06/theprint_default_image_new.jpg",
139        "url": "https://theprint.in/india/india-entering-golden-era-of-defence-innovation-rajnath/2791865/"
140      },
141      {
142        "title": "I'm Indy's last GOP mayor. Redistricting hurts our city. | Opinion",
143        "description": "“I've always believed in doing what's best for Indy, not what's politically convenient. This map fails that test,“ former Mayor Greg Ballard writes.",
144        "page_age": "2025-12-02T18:45:11",
145        "thumbnail_url": "https://www.indystar.com/gcdn/authoring/authoring-images/2025/12/01/PIND/87554090007-2025-12-01-redistricting-rally-037.JPG?crop=2999,1687,x0,y7&width=2999&height=1687&format=pjpg&auto=webp",
146        "url": "https://www.indystar.com/story/opinion/2025/12/02/indy-redistricting-greg-ballard-map/87568271007/"
147      },
148      {
149        "title": "Indy Clinton Addresses Claims She 'Looked Cracked Out' at TikTok Awards",
150        "description": "Influencer Indy Clinton spoke out after a user claimed she 'looked cracked out' at the TikTok Awards",
151        "page_age": "2025-12-02T18:16:17",
152        "thumbnail_url": "https://www.usmagazine.com/wp-content/uploads/2025/12/Influencer-Indy-Clinton-Addresses-Claims-She-Was-Cracked-Out-at-TikTok-Awards.jpg?crop=228px%2C74px%2C1223px%2C643px&resize=1200%2C630&quality=40&strip=all",
153        "url": "https://www.usmagazine.com/celebrity-news/news/indy-clinton-addresses-claims-she-looked-cracked-out-at-tiktok-awards/"
154      },
155      {
156        "title": "West Indies' pace trio shines as New Zealand struggle on day one of first Test",
157        "description": "Kane Williamson reached his 38th Test fifty while sharing the crease with Tom Latham",
158        "page_age": "2025-12-02T00:00:00",
159        "thumbnail_url": "https://www.geosuper.tv/assets/uploads/updates/2025-12-02/l_51141_010019_updates.jpg",
160        "url": "https://www.geosuper.tv/latest/51141-west-indies-pace-trio-shines-as-new-zealand-struggle-on-day-one-of-first-test"
161      },
162      {
163        "title": "How Wilding Brands hopes to reshape the craft beer industry and keep the indie brewer spirit alive",
164        "description": "With its recent flurry of deals, Wilding has brought mergers and acquisitions back into the beer industry spotlight.",
165        "page_age": "2025-12-02T08:58:07",
166        "thumbnail_url": "https://www.dailycamera.com/wp-content/uploads/2025/12/TDP-L-CIDERAO5_9843x-1.jpg?w=1024&h=693",
167        "url": "https://www.dailycamera.com/2025/12/02/wilding-brands-craft-beer-cider-bars/"
168      },
169      {
170        "title": "Sick of the snow already? There's bad news, Indy",
171        "description": "After Indianapolis got hit with snow during the past 24 hours, people already tired of the cold stuff might not be happy with this article.",
172        "page_age": "2025-12-02T15:54:56",
173        "thumbnail_url": "https://www.indystar.com/gcdn/authoring/authoring-images/2025/11/29/PIND/87526832007-mp-snow-036.JPG?crop=2999,1688,x0,y115&width=2999&height=1688&format=pjpg&auto=webp",
174        "url": "https://www.indystar.com/story/weather/2025/12/02/when-will-the-snow-indiana-indianapolis-go-away-temperatures-low-arctic-front-wind-chills/87563954007/"
175      },
176      {
177        "title": "Andrew Alderson: The West Indies quick who bettered the Black Caps' best",
178        "description": "OPINION: The all-rounder removed NZ's most important players as his side claimed day one.",
179        "page_age": "2025-12-02T07:00:00",
180        "thumbnail_url": "https://www.nzherald.co.nz/resizer/v2/2RNUU6GH5BEOZJTNKZKEJMKY6Q.jpg?auth=539cfe751433c6d7fe1edbf21667861329f5f82b2336825ee8452ea43f9b36e1&width=1200&height=675&quality=70&focal=584%2C177&smart=false",
181        "url": "https://www.nzherald.co.nz/sport/cricket/black-caps/black-caps-v-west-indies-justin-greaves-display-outdoes-new-zealands-best-at-hagley-oval/premium/3SA5FNSFGFBNFE3WMXYZQ2WMSQ/"
182      },
183      {
184        "title": "The Ashes: Australia look to Starc and Lyon at the Gabba, and why England must follow West Indies' lead",
185        "description": "Day-night Test cricket brings its challenges and Australia are seasoned in the Gabba's quirks - but touring teams have prevailed before",
186        "page_age": "2025-12-02T05:30:44",
187        "thumbnail_url": "https://static01.nyt.com/athletic/uploads/wp/2025/12/01081813/GettyImages-2247887938-scaled.jpg?width=1200&height=630&fit=cover",
188        "url": "https://www.nytimes.com/athletic/6851475/2025/12/02/ashes-brisbane-australia-england-starc-lyon/"
189      },
190      {
191        "title": "West Indies pace puts New Zealand on the ropes in Christchurch",
192        "description": "West Indies produced a fine display of disciplined fast bowling to leave New Zealand clinging on at 231 for nine when bad light brought an early end to play on the opening day of the first test at Christchurch's Hagley Oval on Tuesday.",
193        "page_age": "2025-12-02T06:26:52",
194        "thumbnail_url": "https://www.reuters.com/resizer/v2/466BJJQ7PVGY5O53NZ3KL65MHM.png?auth=b9c3bf166c40a6778eb5672993fde7c30a15f48329026674eff92afd8da1d0ca&height=1005&width=1920&quality=80&smart=true",
195        "url": "https://www.reuters.com/sports/cricket/west-indies-pace-puts-new-zealand-ropes-christchurch-2025-12-02/"
196      },
197      {
198        "title": "Talked the talk, walked the walk: How a second-year's accountability turned into production in Indy",
199        "description": "After bold public criticism of team's effort, second-year player delivers best performance of his young career with exceptional efficiency to exemplify the standard he demanded from teammates.",
200        "page_age": "2025-12-02T10:30:42",
201        "thumbnail_url": "https://www.cleveland.com/resizer/v2/6ZBPZCEZ2BAUHKHMMU4CWJE34U.JPG?auth=d6c0080d5493a90a4e805db0866b59dd1d2e49e3d57c2a1e381a34cd9560dce4&width=1280&smart=true&quality=90",
202        "url": "https://www.cleveland.com/cavs/2025/12/talked-the-talk-walked-the-walk-how-a-second-years-accountability-turned-into-production-in-indy.html"
203      }
204    ]
205  },
206  "metadata": {
207    "search_uuid": "f4593192-3fbe-47e7-95fc-46df3cc0f970",
208    "query": "What are the latest geopolitical updates from India",
209    "latency": 0.7296042442321777
210  }
211}
This endpoint is designed to return LLM-ready web results based on a user's query. Based on a classification mechanism, it can return web results and news associated with your query. If you need to feed an LLM with the results of a query that sounds like `What are the latest geopolitical updates from India`, then this endpoint is the right one for you. `GET` is a good choice for simple queries where HTTP cacheability matters—GET responses can be cached at CDN and proxy layers, whereas POST responses are not cached by default per the HTTP spec. For requests with complex parameters such as `include_domains`, `exclude_domains`, or `boost_domains`, use POST instead - domain lists are passed as comma-separated strings in GET and are limited by URL length.
Was this page helpful?
Built with

This endpoint is designed to return LLM-ready web results based on a user’s query. Based on a classification mechanism, it can return web results and news associated with your query. If you need to feed an LLM with the results of a query that sounds like What are the latest geopolitical updates from India, then this endpoint is the right one for you.

GET is a good choice for simple queries where HTTP cacheability matters—GET responses can be cached at CDN and proxy layers, whereas POST responses are not cached by default per the HTTP spec. For requests with complex parameters such as include_domains, exclude_domains, or boost_domains, use POST instead - domain lists are passed as comma-separated strings in GET and are limited by URL length.

Authentication

X-API-Keystring
A unique API Key is required to authorize API access. [Get your API Key with free credits](https://you.com/platform).

Query parameters

querystringRequired
The search query used to retrieve relevant results from the web. You can also include [search operators](https://you.com/docs/search/search-operators) to refine your search.
countintegerOptional1-100Defaults to 10

Specifies the maximum number of search results to return per section (the sections are web and news. See the JSON response to visualize them).

freshnessenum or stringOptional
Specifies the freshness of the results to return. Provide either one of `day`, `week`, `month`, `year`, or a date range string in the format `YYYY-MM-DDtoYYYY-MM-DD`. When your search query includes a temporal keyword and you also set a freshness parameter, the search will use the broader (i.e., less restrictive) of the two timeframes. For example, if you use `query=news+this+week&freshness=month`, the results will use a freshness of month.
offsetintegerOptional0-9Defaults to 0

Indicates the offset for pagination. The offset is calculated in multiples of count. For example, if count = 5 and offset = 1, results 5–10 will be returned. Range 0 ≤ offset ≤ 9.

countryenumOptional
The country code that determines the geographical focus of the web results.
languageenumOptionalDefaults to EN

The language of the web results that will be returned (BCP 47 format).

safesearchenumOptionalDefaults to moderate
Configures the safesearch filter for content moderation. This allows you to decide whether to return NSFW content or not.
Allowed values:
livecrawlenumOptional
Passing a value will turn on live crawling, which returns the full page content of each result in the specified section(s). This may add latency to the request. **Pricing:** Livecrawl is billed at $1.00 per 1,000 pages, on top of the base Search API rate of $5.00 per 1,000 calls. This is the same per-page rate as the Contents API. For example, a single call with `count=10` and `livecrawl=all` crawls up to 20 pages (10 web + 10 news), adding $0.02 to the $0.005 base call cost.
Allowed values:
livecrawl_formatslist of enumsOptional

Indicates the format(s) of the livecrawled content. Pass one or both values (html, markdown). In a GET request, repeat the parameter: ?livecrawl_formats=html&livecrawl_formats=markdown. In a POST body, provide a JSON array: ["html", "markdown"].

Allowed values:
include_domainsstringOptional
A list of domains to restrict search results to. Only results from these domains will be returned. For large domain lists (up to 500), use POST with a JSON array instead. This is a strict allowlist — cannot be combined with `exclude_domains` (returns `422`). **Important:** Use a single comma-separated value (e.g. `include_domains=nytimes.com,bbc.com`). Repeated parameters (`include_domains=a.com&include_domains=b.com`) are not supported.
exclude_domainsstringOptional
A list of domains to exclude from search results. Results from these domains will be filtered out. For large domain lists (up to 500), use POST with a JSON array instead. Cannot be combined with `include_domains` (returns `422`). **Important:** You must use a single comma-separated value (e.g. `exclude_domains=spam-site.com,other-site.com`). Repeated parameters are not supported.
boost_domainsstringOptional
A list of domains to boost in search ranking. Matching results from these domains receive a relative ranking boost, but results are not limited to these domains. Supports up to 500 domains. Can be combined with `exclude_domains`, but cannot be combined with `include_domains` (returns `422`). **Important:** You must use a single comma-separated value (e.g. `boost_domains=nytimes.com,wired.com`). Repeated parameters are not supported.
crawl_timeoutintegerOptional1-60Defaults to 10

Maximum time in seconds to wait for page content when livecrawl is enabled. Must be between 1 and 60 seconds. Default is 10 seconds.

Response

A JSON object containing unified search results from web and news sources
resultsobject
metadataobject

Errors

401
Unauthorized Error
403
Forbidden Error
422
Unprocessable Entity Error
500
Internal Server Error

A unique API Key is required to authorize API access. Get your API Key with free credits.

The search query used to retrieve relevant results from the web. You can also include search operators to refine your search.

Specifies the freshness of the results to return. Provide either one of day, week, month, year, or a date range string in the format YYYY-MM-DDtoYYYY-MM-DD.

When your search query includes a temporal keyword and you also set a freshness parameter, the search will use the broader (i.e., less restrictive) of the two timeframes. For example, if you use query=news+this+week&freshness=month, the results will use a freshness of month.

Passing a value will turn on live crawling, which returns the full page content of each result in the specified section(s). This may add latency to the request.

Pricing: Livecrawl is billed at 1.00per1,000pages,ontopofthebaseSearchAPIrateof1.00 per 1,000 pages, on top of the base Search API rate of 1.00per1,000pages,ontopofthebaseSearchAPIrateof5.00 per 1,000 calls. This is the same per-page rate as the Contents API. For example, a single call with count=10 and livecrawl=all crawls up to 20 pages (10 web + 10 news), adding 0.02tothe0.02 to the 0.02tothe0.005 base call cost.

A list of domains to restrict search results to. Only results from these domains will be returned. For large domain lists (up to 500), use POST with a JSON array instead. This is a strict allowlist — cannot be combined with exclude_domains (returns 422).

Important: Use a single comma-separated value (e.g. include_domains=nytimes.com,bbc.com). Repeated parameters (include_domains=a.com&include_domains=b.com) are not supported.

A list of domains to exclude from search results. Results from these domains will be filtered out. For large domain lists (up to 500), use POST with a JSON array instead. Cannot be combined with include_domains (returns 422).

Important: You must use a single comma-separated value (e.g. exclude_domains=spam-site.com,other-site.com). Repeated parameters are not supported.

A list of domains to boost in search ranking. Matching results from these domains receive a relative ranking boost, but results are not limited to these domains. Supports up to 500 domains. Can be combined with exclude_domains, but cannot be combined with include_domains (returns 422).

Important: You must use a single comma-separated value (e.g. boost_domains=nytimes.com,wired.com). Repeated parameters are not supported.