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|
POST
https://ydc-index.io/v1/search
POST
/v1/search
$curl -X POST https://ydc-index.io/v1/search \
>     -H "X-API-Key: <apiKey>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "query": "What are the latest geopolitical updates from India",
>  "count": 10,
>  "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://www.ndtv.com/topic/geopolitical",
19        "title": "Geopolitical: Latest News, Photos, Videos on Geopolitical - NDTV.COM",
20        "description": "Find Geopolitical Latest News, Videos & Pictures on Geopolitical and see latest updates, news, information from NDTV.COM. Explore more on Geopolitical.",
21        "snippets": [
22          "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.",
23          "IndiGo flight 6E1703 from Kolkata touched down in the southern Chinese city of Guangzhou shortly before 4:00 am, officially resuming nonstop air links that had been suspended since 2020 due to the pandemic and subsequent geopolitical tensions.",
24          "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.",
25          "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."
26        ],
27        "thumbnail_url": "https://cdn.ndtv.com/common/images/ogndtv.png",
28        "favicon_url": "https://you.com/favicon?domain=www.ndtv.com&size=128"
29      }
30    ],
31    "news": [
32      {
33        "title": "India entering golden era of defence innovation: Rajnath",
34        "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.",
35        "page_age": "2025-11-25T12:31:29",
36        "thumbnail_url": "https://static.theprint.in/wp-content/uploads/2023/06/theprint_default_image_new.jpg",
37        "url": "https://theprint.in/india/india-entering-golden-era-of-defence-innovation-rajnath/2791865/"
38      },
39      {
40        "title": "India-Pakistan Tensions: Geopolitical Fallout and Regional Stability",
41        "description": "As tensions between India and Pakistan persist following recent military exchanges, analysts assess the broader geopolitical implications for South Asia and global powers.",
42        "page_age": "2025-11-20T08:15:00",
43        "thumbnail_url": "https://cdn.ndtv.com/common/images/ogndtv.png",
44        "url": "https://www.ndtv.com/india-news/india-pakistan-tensions-geopolitical-fallout-2025"
45      }
46    ]
47  },
48  "metadata": {
49    "search_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
50    "query": "What are the latest geopolitical updates from India",
51    "latency": 0.6842031478881836
52  }
53}
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. `POST` is the recommended method when using complex parameters such as `include_domains`, `exclude_domains`, or `boost_domains`. These fields accept JSON arrays in the request body, which is unambiguous and avoids URL length limits. Use GET for simple queries where HTTP cacheability matters.
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.

POST is the recommended method when using complex parameters such as include_domains, exclude_domains, or boost_domains. These fields accept JSON arrays in the request body, which is unambiguous and avoids URL length limits. Use GET for simple queries where HTTP cacheability matters.

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).

Request

This endpoint expects an object.
querystringRequired

The search query used to retrieve relevant results from the web. You can also include 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.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.

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_domainslist of stringsOptional

A list of domains to restrict search results to. Only results from these domains will be returned. Supports up to 500 domains. This is a strict allowlist, not a boost — results are limited exclusively to the specified domains.

Cannot be combined with exclude_domains; passing both will return a 422 error.

exclude_domainslist of stringsOptional

A list of domains to exclude from search results. Results from these domains will be filtered out. Supports up to 500 domains.

Cannot be combined with include_domains; passing both will return a 422 error.

boost_domainslist of stringsOptional

A list of domains to boost in search ranking. Matching results from these domains receive a fixed relative ranking boost, but this is not a filter. If the boosted domains do not have matching results, results from other domains can still appear. Supports up to 500 domains.

Can be combined with exclude_domains. Cannot be combined with include_domains. Passing both boost_domains and include_domains will return a 422 error.

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.