XMLRiver

https://xmlriver.com/apidoc
Admin
XMLRiver provides an API for collecting and parsing search results from Google and Yandex, including...
Tokens:13,792
Snippets:80
Trust Score:8.2
Update:3 months ago
Show doc for...
Tokens:
Raw
### Google Shopping Search URL Example

Source: https://xmlriver.com/apidoc/api-shop

To search only within the Google Shopping tab, append the 'setab=shop' parameter to your search query. This example shows the base URL with the required parameter.

```URL
xmlriver.com/search/xml?setab=shop &user=...&key=...
```

--------------------------------

### OneBox and Mixed Result Types

Source: https://xmlriver.com/apidoc/api-organic

Example showing different content types within a single XMLRiver response, including 'organic' and 'news' OneBox types.

```xml
<group id="4">
  <doccount>1</doccount>
  <doc>
    <url>https://ru.wikipedia.org/wiki/Microsoft</url>
	    <title>Microsoft - Википедия</title>
	    <contenttype>organic</contenttype>
	    <breadcrumbs>https://ru.wikipedia.org › wiki › Microsoft</breadcrumbs>
	    <passages><passage>Ма́йкрософт (Microsoft Corporation, Microsoft) — одна из крупнейших транснациональных компаний по производству проприетарного программного обеспечения для ...</passage></passages>
	 </doc>
</group>
<group id="5">
  <doccount>1</doccount>
	 <doc>
	 <url>https://3dnews.ru/1063762/operatsionnoy-sisteme-microsoft-windows-31x-ispolnilos-30-let</url>
	   <title>Главные новости</title> 
	   <contenttype>news</contenttype>
	   <breadcrumbs/>
	   <passages>
	     <passage></passage>
	   </passages>
	 </doc>
</group>
```

--------------------------------

### Google Maps Search URL Example

Source: https://xmlriver.com/apidoc/api-maps

To search for establishments on Google Maps, append `_setab=maps_` along with the mandatory `_zoom_` and `_coords_` parameters to your search query. Ensure you also include `user`, `key`, and `query` parameters.

```url
xmlriver.com/search/xml?setab=maps &zoom=12&coords=51.5468,45.9968&user=...&key=...&query=...
```

--------------------------------

### XML Response Structure for Maps Search

Source: https://xmlriver.com/apidoc/api-maps

This is an example of the XML response structure when performing a Google Maps search. It includes details about found establishments such as title, rating, type, address, coordinates, and review information.

```xml
<yandexsearch version="1.0">
<response date="20240626T135440">
  <found priority="all">10</found>
  <maps>
    <item>
      <title>PERK Cafe</title>
      <stars>4,7</stars>
      <type>Кафе</type>
      <address>· ул. Вольская, 63/69</address>
      <url></url>
      <phone></phone>
      <review></review> 
      <possibility>Еда в заведении ⋅ Заказ с улицы ⋅ Доставка</possibility>
      <latitude>51.5299502</latitude> 
      <longitude>46.022773</longitude>  
      <placeid>ChIJNY-Nx77HFEERe9R4sgvI1Fw</placeid>  
      <countreviews>1400</countreviews>  
      <accessibility>false</accessibility>  
      <price></price>  
      <gasprice></gasprice>
    </item>
    <item>
      <title>Кафе "По Щучьему Велению"</title>
      <stars>4,7</stars>
      <type>Кафе</type>
      <address>· ул. Советская, 45</address>
      <url></url>
      <phone></phone>
      <review></review> 
      <possibility>Еда в заведении ⋅ Еда навынос</possibility> 
      <latitude>51.5292109</latitude> 
      <longitude>46.020041</longitude>  
      <placeid>ChIJHx6uAbzHFEER9WtY98DaixQ</placeid>  
      <countreviews>150</countreviews>  
      <accessibility>true</accessibility>  
      <price></price>  
      <gasprice></gasprice>
    </item>
    ...
  </maps>
</response>
</yandexsearch>
```

--------------------------------

### XMLRiver API Response Structure for Images

Source: https://xmlriver.com/apidoc/api-images

This is an example of the XML structure returned by the XMLRiver API when performing an image search. It includes suggested searches and detailed information about individual image results.

```XML
...
<suggestedsearches>
  <item><name>любовь</name></item>
  <item><name>фон</name></item>
  <item><name>рабочий стол</name></item>
  <item><name>телефон</name></item>
  <item><name>лето</name></item>
  ...
</suggestedsearches>
...
<group id="2">
  <doccount>1</doccount>
  <doc>
    <url>https://www.1zoom.ru/Природа/обои/576752/z1143.9/</url>
    <imgurl>https://s1.1zoom.ru/big0/697/Love_Night_Moon_Trees_Silhouette_Two_Dating_576752_1280x853.jpg</imgurl>
    <title>Картинка Свидание Силуэт Двое Любовь Природа Луна Ночь Деревья</title>
    <displaylink>1zoom.ru</displaylink>
    <originalwidth>500</originalwidth>
    <originalheight>1200</originalheight>
    <passages><passage></passage></passages>
  </doc>
</group>
...
```

--------------------------------

### XMLRiver Google Shopping Search Result Structure

Source: https://xmlriver.com/apidoc/api-shop

This is an example of the XML structure returned by XMLRiver for a Google Shopping search query. It includes details such as URL, title, price, source, rating, reviews, and passages for a product.

```XML
...
<group id="1">
  <doccount>1</doccount>
  <doc>
    <url>https://www.google.com/shopping/product/10239789207511907458?q=iphone&uule=w CAIQIFISCUG8mwUJxxRBEfY1kENWUWgc&pws=0&hl=ru&prds=eto:6314458009857151387_0&sa=X&ved=0ahUKEwiTso6xrZzxAhWilosKHa6sBXgQ8gIItgY</url> 
    <title>Apple iPhone 11 128Gb MHDM3RU/A</title>
    <price>54	290,00	₽</price>
    <source>МТС</source>
    <rating>4,6</rating> 
    <reviews>34 431</reviews> 
    <passages><passage>Apple 	iPhone 	iPhone 11 	Purple (Фиолетовый) Быстрая и плавная работа. Долгое время работы от аккумулятора.И система iOS 14 с мощными встроенными функциями для повышения ... Другие варианты: 	 64GB - Black (Черный) 	 64GB - Red (Красный) 	 Ещё</passage></passages>  
  </doc>
</group>
...
```

--------------------------------

### Organic Search Result Structure

Source: https://xmlriver.com/apidoc/api-organic

Example of the XMLRiver response structure for a standard organic search result. Includes URL, title, content type, passages, breadcrumbs, cache link, and sitelinks.

```xml
<group id="1">
  <doccount>1</doccount>
  <doc>
    <url>https://ru.wikipedia.org/wiki/Чай</url>
    <title> Чай — Википедия </title>
    <contenttype>organic</contenttype> 
    <passages>
      <passage>
Чай (кит. 茶 — «ча́» на пекинском и гуандунском диалекте, «те̂» на амойском и «тцай-е» на тайваньском, « чай » — на хинди) — напиток, получаемый ...
      </passage>
    </passages>
	   <breadcrumbs>https://ru.wikipedia.org › wiki › Чай</breadcrumbs>
    <cachelink>https://webcache.googleusercontent.com/search?q=cache:T-XOLbp8aSkJ:https://ru.wikipedia.org/wiki/%D0%A7%D0%B0%D0%B9+&cd=1&hl=ru&ct=clnk&gl=ua</cachelink>
    <oneline_sitelinks>
      <sitelink>
        <url>
https://ru.wikipedia.org/wiki/%D0%A7%D0%B0%D0%B9_(%D1%80%D0%B0%D1%81%D1%82%D0%B5%D0%BD%D0%B8%D0%B5)
        </url>
        <title> Чай (растение) </title>
        <snippet/>
      </sitelink>
      <sitelink>
        <url>
https://ru.wikipedia.org/wiki/%D0%97%D0%B5%D0%BB%D1%91%D0%BD%D1%8B%D0%B9_%D1%87%D0%B0%D0%B9
        </url>
        <title> Зелёный чай </title>
        <snippet/>
      </sitelink>
      <sitelink>
        <url>
https://ru.wikipedia.org/wiki/%D0%A7%D1%91%D1%80%D0%BD%D1%8B%D0%B9_%D1%87%D0%B0%D0%B9
        </url>
        <title> Чёрный чай </title>
        <snippet/>
      </sitelink>
      <sitelink>
        <url>
https://ru.wikipedia.org/wiki/%D0%A7%D0%B0%D0%B9_%D0%B2_%D0%A0%D0%BE%D1%81%D1%81%D0%B8%D0%B8
        </url>
        <title> Чай в России </title>
        <snippet/>
      </sitelink>
    </oneline_sitelinks>
  </doc>
</group>
```

--------------------------------

### XMLRiver Google News Response Structure

Source: https://xmlriver.com/apidoc/api-news

This is an example of the XML structure returned by the API when searching the Google News tab. It includes document details like URL, title, media source, publication date, and passages.

```XML
...
<group id="1">
  <doccount>1</doccount>
  <doc>
    <url>https://www.gazeta.ru/culture/news/2021/06/10/n_16088168.shtml</url> 
    <title>Лидер «Мужского государства» назвал арест Хованского своей заслугой</title>
    <media>1zoom.ru</media> 
    <pubDate>1 час назад</pubDate> 
    <passages><passage>Глава сообщества «Мужское Государство» Владислав Поздняков назвал себя причастным к аресту блогера Юрия Хованского. Об этом ...</passage></passages>  
  </doc>
</group>
...
```

--------------------------------

### Indented Search Result Structure

Source: https://xmlriver.com/apidoc/api-organic

Example of the XMLRiver response structure for an indented search result. It includes the 'indented' tag to signify this type of result.

```xml
<group id="5">
  <doccount>1</doccount>
  <doc>
    <url>https://ru.wikipedia.org/wiki/Чай</url>
    <title> Чай — Википедия </title>
    <passages>
      <passage>
Чай (кит. 茶 — «ча́» на пекинском и гуандунском диалекте, «те̂» на амойском и «тцай-е» на тайваньском, « чай » — на хинди) — напиток, получаемый ...
      </passage>
    </passages>
	   <indented>1</indented>
  </doc>
</group>
```

--------------------------------

### XML Structure for Discussions and Forums

Source: https://xmlriver.com/apidoc/api-inline-discuss

This XML snippet illustrates the structure of the 'discussions' block, containing individual 'item' elements with 'url' and 'title' for each discussion or forum link.

```xml
<discussions>
  <item>
    <url>https://www.reddit.com/r/cars/comments/rhcy25/what_is_your_experience_with_fully_vinyl_wrapping/</url> 
    <title>Looking for a local wrap installer in Houston TX : r/CarWraps - Reddit</title>
  </item>
  <item>
   <url>https://www.reddit.com/r/CarWraps/comments/12ap9sc/how_much_money_do_people_make_wrapping_cars/</url>
   <title>What is your experience with fully vinyl wrapping a car? - Reddit</title> 
  </item>
  <item>
   <url>https://www.quora.com/Are-there-any-disadvantages-to-wrapping-a-car-in-vinyl-rather-than-painting-it</url>
   <title>Are there any disadvantages to wrapping a car in vinyl rather than painting it? - Quora</title> 
  </item>
</discussions>
```

--------------------------------

### Search Establishments on Google Maps

Source: https://xmlriver.com/apidoc/api-maps

This endpoint allows you to search for establishments on Google Maps. You need to include the `_setab=maps_` parameter along with the mandatory `zoom` and `coords` parameters. Additional parameters like `user`, `key`, and `query` are also required for a complete search.

```APIDOC
## GET /search/xml

### Description
Searches for establishments on Google Maps.

### Method
GET

### Endpoint
/search/xml

### Parameters
#### Query Parameters
- **setab** (string) - Required - Must be set to `maps` to enable map search.
- **zoom** (integer) - Required - The zoom level for the map.
- **coords** (string) - Required - The coordinates for the search (latitude,longitude).
- **user** (string) - Required - Your user identifier.
- **key** (string) - Required - Your API key.
- **query** (string) - Required - The search query for establishments.

### Response
#### Success Response (200)
- **found** (integer) - The number of establishments found.
- **maps** (object) - Contains a list of map items.
  - **item** (array) - A list of establishments.
    - **title** (string) - The name of the establishment.
    - **stars** (string) - The star rating of the establishment.
    - **type** (string) - The type of establishment (e.g., Cafe).
    - **address** (string) - The address of the establishment.
    - **url** (string) - The URL of the establishment (if available).
    - **phone** (string) - The phone number of the establishment (if available).
    - **review** (string) - A brief review or description (if available).
    - **possibility** (string) - Services offered by the establishment (e.g., Dine-in, Takeaway).
    - **latitude** (number) - The latitude coordinate of the establishment.
    - **longitude** (number) - The longitude coordinate of the establishment.
    - **placeid** (string) - The Google Place ID of the establishment.
    - **countreviews** (integer) - The number of reviews for the establishment.
    - **accessibility** (boolean) - Indicates if the establishment is accessible.
    - **price** (string) - Price level information (if available).
    - **gasprice** (string) - Gas price information (if available).

### Request Example
```
xmlriver.com/search/xml?setab=maps&zoom=12&coords=51.5468,45.9968&user=YOUR_USER&key=YOUR_KEY&query=restaurants
```

### Response Example
```xml
<yandexsearch version="1.0">
<response date="20240626T135440">
  <found priority="all">10</found>
  <maps>
    <item>
      <title>PERK Cafe</title>
      <stars>4,7</stars>
      <type>Кафе</type>
      <address>· ул. Вольская, 63/69</address>
      <url></url>
      <phone></phone>
      <review></review> 
      <possibility>Еда в заведении ⋅ Заказ с улицы ⋅ Доставка</possibility>
      <latitude>51.5299502</latitude> 
      <longitude>46.022773</longitude>  
      <placeid>ChIJNY-Nx77HFEERe9R4sgvI1Fw</placeid>  
      <countreviews>1400</countreviews>  
      <accessibility>false</accessibility>  
      <price></price>  
      <gasprice></gasprice>
    </item>
    ...
  </maps>
</response>
</yandexsearch>
```
```

--------------------------------

### Knowledge Graph for Persons (XMLRiver Structure)

Source: https://xmlriver.com/apidoc/api-knowledge-graph

This XML structure provides information about a person, including their name, category, Wikipedia link, birthdate, and birthplace. It's useful for displaying biographical details.

```xml
...
<knowledge_graph>
  <type>person</type>
  <name>Никола Тесла</name>
  <category>Изобретатель</category>
  <wiki>https://ru.wikipedia.org/wiki/%D0%A2%D0%B5%D1%81%D0%BB%D0%B0,_%D0%9D%D0%B8%D0%BA%D0%BE%D0%BB%D0%B0</wiki>
  <birthdate>10 июля 1856 г.,</birthdate>
  <birthplace>Смилян, Хорватия</birthplace>
</knowledge_graph>
...
```

--------------------------------

### Knowledge Graph for Businesses (XMLRiver Structure)

Source: https://xmlriver.com/apidoc/api-knowledge-graph

This XML structure details information about a business entity, including its name, rating, address, operating hours, website, and reviews. It is useful for displaying rich business information in applications.

```xml
...
<knowledge_graph>
  <type>firm</type>
  <place_id>ChIJn17Gi0NOqEcRfHX8oRvU9ms</place_id>
  <name>Berghain</name>
  <rating>3,9</rating>
  <countReviews>2494</countReviews>
  <address>Am Wriezener Bahnhof, 10243 Berlin, Германия</address>
  <phone/>
  <datafid>0x47a84e438bc65e9f:0x6bf6d41ba1fc757c</datafid>
  <countqueries>71</countqueries>
  <timework>
четверг 22:00–04:00 пятница 23:59–09:00 суббота 23:59–00:00 воскресенье 24 часа в сутки понедельник Закрыто вторник Закрыто среда Закрыто
  </timework>
  <isUnknownPlace>0</isUnknownPlace>
  <point>@52.5105777,13.4423837</point>
  <website>http://www.berghain.berlin/</website>
  <category>Ночной клуб в Берлине, Германия</category>
  <orgChecked>1</orgChecked>
  <orgCanManaged>0</orgCanManaged>
  <tableReservation>https://druzya.by/booking</tableReservation>
  <menu>https://www.danielnyc.com/cuisine/dinner</menu>
  <description/>
  <pricecategory>$$</pricecategory>
  <orderFood/>
  <information>
  Обычно здесь проводят 20 мин. – 3 ч.
  </information>
  <reviews>
    <item>
      <link>
https://ru.foursquare.com/v/berghain/4ae778a5f964a520a5ab21e3
      </link>
      <rating>8,9/10</rating>
    </item>
    <item>
      <link>
https://www.local-life.com/berlin/pubs/58-Berghain_Panorama_Bar
      </link>
      <rating>7,6/10</rating>
    </item>
    <item>
       <link>https://www.travelgay.com/venue/berghain/</link>
       <rating>3,5/5</rating>
    </item>
  </reviews>
  <upComingEvents>
    <event>
     пт, 8 нояб. 20:30 Pauls Jets
    </event>
    <event>
пт, 8 нояб. 23:59 Finest Fridays: Ben UFO + Joy Orbison + re:ni
    </event>
    <event>
сб, 9 нояб. 23:59 Fc Snax United @ Berlin
    </event>
  </upComingEvents>
  <visitStatistic>
    <statistic_item>
      <dayofweek></dayofweek>
      <info></info>
    </statistic_item>
  </visitStatistic>
  <posts>
    <post>
      <link></link>
      <info></info>
    </post>
  </posts>
</knowledge_graph>
...
```

--------------------------------

### Podcast Item Structure in XMLRiver Response

Source: https://xmlriver.com/apidoc/api-podcasts

This snippet shows the XML structure for a single podcast item as returned by the XMLRiver API. It includes essential details for each podcast episode.

```xml
...
<podcasts>
  <item>
    <url>https://podcasts.google.com/feed/aHR0cHM6Ly9mZWVkcy5tZWdhcGhvbmUuZm0vZ3JpbGxpbmctanI/episode/MzJkYmJlYjYtMWEyZi0xMWViLThiNTMtNTNhZWFmZDU0YzIy</url> 
    <title>Grilling JR</title>
    <snippet>Episode 110: Mankind 1997</snippet>  
    <position>0</position>
    <pubdate>1	день назад</pubdate> 
    <duration>2 ч 31 мин</duration>
  </item>
 ...
</podcasts>
...
```

--------------------------------

### XML Structure for News Block

Source: https://xmlriver.com/apidoc/api-inline-news

This XML snippet illustrates the structure of the news block as returned by the API. Each 'item' represents a news article with its URL, title, and position.

```xml
<news>
  <item>
    <url>https://www.ixbt.com/news/2022/02/09/microsoft-windows-7-windows-8-1-windows-10-windows-11.html</url> 
    <title>Microsoft обновила Windows 7, Windows 8.1, Windows 10 и Windows 11</title>
    <position>0</position> 
  </item>
  <item>
   <url>https://3dnews.ru/1060030/microsoft-napomnila-o-skorom-prekrashchenii-poddergki-windows-10-20h2</url>
   <title>Microsoft напомнила о скором прекращении поддержки Windows 10 (20H2)</title> 
   <position>1</position> 
  </item>
  <item>
    <url>https://dtf.ru/s/xbox_club/1074399-microsoft-rassmatrivaet-perehod-na-bolee-gibkuyu-procentnuyu-stavku-v-magazine-xbox-vmesto-ustoyavsheysya-30-komissii</url>
    <title>Microsoft рассматривает переход на более «гибкую» процентную ставку в магазине Xbox вместо устоявшейся 30 ...</title> 
    <position>2</position> 
  </item>
  <item>
    <url>https://www.cnews.ru/news/top/2022-02-11_microsoft_zamanivaet_v_microsoft_365</url>
    <title>Microsoft переманивает к себе огромными скидками пользователей, которых обидела Google</title>
    <position>3</position> 
  </item> 
</news>
```

--------------------------------

### XMLRiver Applications Block Structure

Source: https://xmlriver.com/apidoc/api-app

This XML structure represents the applications relevant to a user's query as returned by XMLRiver. It includes a list of items, each with a URL and a title for an application.

```xml
<applications>
  <item>
    <url>https://play.google.com/store/apps/details?id=com.google.android.googlequicksearchbox&amp;hl=ru&amp;gl=US&amp;referrer=utm_source=google&utm_medium=organic&utm_term=приложения&amp;pcampaignid=APPU_1_t5L4X4KnN-OtrgT60q7QBQ</url> 
    <title>Google</title>
  </item>
  <item>
   <url>https://play.google.com/store/apps/details?id=com.google.android.apps.walletnfcrel&amp;hl=ru&amp;gl=US&amp;referrer=utm_source=google&utm_medium=organic&utm_term=приложения&amp;pcampaignid=APPU_1_t5L4X4KnN-OtrgT60q7QBQ</url>
   <title>Google Pay</title> 
  </item>
  <item>
    <url>https://play.google.com/store/apps/details?id=com.google.android.youtube&amp;hl=ru&amp;gl=US&amp;referrer=utm_source=google&utm_medium=organic&utm_term=приложения&amp;pcampaignid=APPU_1_t5L4X4KnN-OtrgT60q7QBQ</url>
    <title>YouTube</title> 
  </item>
</applications>
```

--------------------------------

### Search Google Images with XMLRiver API

Source: https://xmlriver.com/apidoc/api-images

To search specifically within Google Images, append the 'setab=images' parameter to your API request. This directs the search to the image tab.

```URL
xmlriver.com/search/xml?setab=images &user=...&key=...
```

--------------------------------

### XML Structure for Google Ads

Source: https://xmlriver.com/apidoc/api-ads

This XML structure represents the ads returned from Google search results, categorized into 'topads' and 'bottomads'. Each 'query' element contains details about a single ad, including its URL, the Google Ads service URL, title, and a descriptive snippet.

```xml
...
<topads>
  <query>
    <url>www.viknaplast.com.ua/</url>
    <adsurl>https://www.googleadservices.com/pagead/aclk?sa=L&amp;ai=DChcSEwipm5udpbKFAxXUF6IDHYDxCF0YABADGgJsZQ&amp;gclid=EAIaIQobChMIqZubnaWyhQMV1BeiAx2A8QhdEAAYASAAEgLeE_D_BwE&amp;ohost=www.google.com&amp;cid=CAASJORorylSejFJhcFQHeBVk1c_DX8K9fQKwNOML5a3D80RjpZ8Bg&amp;sig=AOD64_1pCLK2fjwGIclblSu7yTE81GNSMg&amp;q&amp;adurl</adsurl>
    <title>Пластиковые окна «под ключ» | Запорожье | viknaplast.com.ua‎‎</title>
    <snippet>Окна WDS по прошлогодней цене. От 1499 грн. Выгодные акции и предложения. Спешите приобрести пластиковые окна в Запорожье по прошлогодним ценам.
    </snippet>
  </query>
  <query>
    <url>www.okna-comfort.zp.ua/Установка_Окон_/в_Запорожье</url>
    <adsurl>https://www.googleadservices.com/pagead/aclk?sa=L&amp;ai=DChcSEwipm5udpbKFAxXUF6IDHYDxCF0YABAEGgJsZQ&amp;gclid=EAIaIQobChMIqZubnaWyhQMV1BeiAx2A8QhdEAAYAyAAEgJvqfD_BwE&amp;ohost=www.google.com&amp;cid=CAASJORorylSejFJhcFQHeBVk1c_DX8K9fQKwNOML5a3D80RjpZ8Bg&amp;sig=AOD64_3-A-ttmZ_SUukfcw8nkUYujJTVmg&amp;q&amp;adurl</adsurl>
    <title>Пластиковые Окна на Заказ | Лучшие Цены в Запорожье‎</title>
    <snippet>
Металлопластиковые Окна Надежных Производителей. Гарантия Теплоты и Уюта в Вашем Доме! Возвращаем 35% Стоимости Окон по Государственной Программе "Теплый Дом". Обращайтесь! Договорные отношения. Европейское качество.
    </snippet>
  </query>
  ...
</topads>
<bottomads>
  <query>
    <url>www.extra-domys.zp.ua/—Балконы—Окна/—Двери—Жалюзи</url>
    <adsurl>https://www.googleadservices.com/pagead/aclk?sa=L&amp;ai=DChcSEwipm5udpbKFAxXUF6IDHYDxCF0YABAAGgJsZQ&amp;gclid=EAIaIQobChMIqZubnaWyhQMV1BeiAx2A8QhdEAAYBCAAEgInR_D_BwE&amp;ohost=www.google.com&amp;cid=CAASJORorylSejFJhcFQHeBVk1c_DX8K9fQKwNOML5a3D80RjpZ8Bg&amp;sig=AOD64_0tG5e8GUQy1ljPnP7M0nLRKYPawg&amp;q&amp;adurl</adsurl>
    <title>Окна в Запорожье 2800 грн | Без Предоплаты За 3 Дня</title>
    <snippet>Балк.блок 4200грн Трехстворч 3600грн. Беспроцентная Рассрочка. Теплый Кредит! Замер и просчет бесплатно. Бесплатная доставка. Заключение договора.</snippet>
  </query>
  <query>
    <url>www.pvb.com.ua/окна/цены</url>
    <title>Пластиковые окна в Запорожье | Возвратим 35% от цены окон</title>
    <snippet>Цены энергосберегающих окон в Запорожье с профессиональной теплой установкой ДСТУ. Металлопластиковые окна WDS от Первого Оконного Бюро в Запорожье по оптимальным ценам. + энегосбережение. Оптовые цены от 30 кв.м.</snippet>
  </query>
  ...
</bottomads>
...
```

--------------------------------

### XML Structure for DMCA Messages

Source: https://xmlriver.com/apidoc/api-organic

This XML snippet illustrates the structure for DMCA messages within the XMLRiver API response. It shows how explanations for result filtering and highlighted words with links are organized.

```xml
...
<dmca_messages>
  <title>Пояснения к фильтрации результатов</title>
  <messages>
    <content>В ответ на жалобы, поданные в соответствии с законом США "Об авторском праве в цифровую эпоху" (DMCA), мы удалили некоторые результаты (5) с этой страницы. Вы можете ознакомиться с жалобами на сайте LumenDatabase.org: Жалоба, Жалоба, Жалоба, Жалоба</content>
    <highlighted_words>
      <item>
        <link>http://www.chillingeffects.org/notice.cgi?sID=16631256</link>
        <title>Жалоба</title> 
      </item>
      <item>
        <link>https://lumendatabase.org/notices/84731003</link>
        <title>Жалоба</title>
      </item> 
      <item>
        <link>https://lumendatabase.org/notices/85196339</link>
        <title>Decent upgrade</title>
      </item> 
      ...
    </highlighted_words>
  </messages> 
</dmca_messages>
...
```

--------------------------------

### AI Block Presence Indicator

Source: https://xmlriver.com/apidoc/api-ai

When the AI block is present in the search results, this XML structure is returned.

```xml
<ai><present>1</present></ai>
```

--------------------------------

### XML Structure for Related Questions

Source: https://xmlriver.com/apidoc/api-rq

This XML structure represents the 'Related Questions' data as returned by the API. It includes the question, title, snippet, and URL for each related item.

```xml
...
<relatedQuestions>
   <item>
      <question>How do I find related search queries?</question>   
      <title>Find related searches - Trends Help - Google Support</title> 
      <snippet>When you search for a term in Trends, you see searches related to your term in the related searches sections at the bottom of the page. If you're comparing multiple search terms, locations, or time ranges, you can see related top searches by selecting the tab for your term.</snippet> 
      <url>https://support.google.com/trends/answer/4355000?hl=en</url> 
   </item> 
   ...
</relatedQuestions>
...
```

--------------------------------

### Sidebar Shopping Results Structure

Source: https://xmlriver.com/apidoc/api-inlineshopping

This XML structure represents inline shopping ads displayed in the sidebar. It contains similar item details as the carousel format.

```xml
<sideshoppingresults>
  <item>
    <url>https://pokupki.market.yandex.ru/product/motornyi-filtr-avs-dlia-pylesosa-bosch-bsa-bsa2-bsa3-bsa5-bsd-bsd2-bsd3-bsg4-bsg6-bsg7-bsg8-bsgl2-bsgl4-bsgls-bsgmove-siemens-vs04-vs06-vs07-vs08-vsz3-vsz4-vsz5-vsz6/101110979654?utm_term=278341|101110979654</url> 
    <title>Моторный фильтр для пылесоса Bosch BSA***</title>
    <position>0</position> 
    <cost>420 ₽</cost> 
    <shop>Яндекс.Маркет</shop> 
    <sale></sale> 
  </item>
  <item>
    <url>https://shop.dyson.ru/dyson-vacuums/cordless/v8-absolute-v8-extra-353323-01/</url>      
    <title>Вертикальный пылесос Dyson V8 Absolute+ Extra (353323-01)</title>
    <position>1</position>
    <cost>29 990 ₽</cost> 
    <shop>Dyson</shop>
    <sale></sale>
  </item>
  ...
</sideshoppingresults>
```

--------------------------------

### XML Structure for Related Searches

Source: https://xmlriver.com/apidoc/api-rs

This XML snippet illustrates the structure for related searches within the XMLRiver API response. It shows how individual search queries are enclosed within the <relatedSearches> tag.

```xml
...
<relatedSearches>
   <query>
      <title>Связанные подзапросы postgresql</title>   
   </query>
   <query>
      <title>подзапросы sql</title> 
   </query>
   <query>
      <title>вложенные запросы sql</title>
   </query>
   <query>
      <title>связанные подзапросы mysql</title>
   </query>
    <query>
      <title>коррелирующие подзапросы</title>
   </query>
    <query>
      <title>сложные запросы sql</title>  
   </query>
    <query>
      <title>подчиненные подзапросы sql</title>  
   </query>
    <query>
      <title>связанные подзапросы mysql</title>
   </query>
</relatedSearches>
...
```

--------------------------------

### Search Google News Tab API

Source: https://xmlriver.com/apidoc/api-news

To search only the Google News tab, append the 'setab=news' parameter to your search query. Ensure you also include your user and key parameters.

```URL
xmlriver.com/search/xml?setab=news &user=...&key=...
```

--------------------------------

### Shopping Results Carousel Structure

Source: https://xmlriver.com/apidoc/api-inlineshopping

This XML structure represents inline shopping ads displayed as a carousel. It includes item details like URL, title, position, cost, and shop.

```xml
<shoppingresults>
  <item>
    <url>https://pokupki.market.yandex.ru/product/motornyi-filtr-avs-dlia-pylesosa-bosch-bsa-bsa2-bsa3-bsa5-bsd-bsd2-bsd3-bsg4-bsg6-bsg7-bsg8-bsgl2-bsgl4-bsgls-bsgmove-siemens-vs04-vs06-vs07-vs08-vsz3-vsz4-vsz5-vsz6/101110979654?utm_term=278341|101110979654</url> 
    <title>Моторный фильтр для пылесоса Bosch BSA***</title>
    <position>0</position> 
    <cost>420 ₽</cost> 
    <shop>Яндекс.Маркет</shop> 
    <sale></sale> 
  </item>
  <item>
    <url>https://shop.dyson.ru/dyson-vacuums/cordless/v7-animal-extra-227610-01/</url>      
    <title>Пылесос Dyson Пылесос Dyson V7 Animal Extra</title>
    <position>1</position>
    <cost>19 990 ₽</cost> 
    <shop>Dyson</shop>
    <sale></sale>
  </item>
  ...
</shoppingresults>
```

--------------------------------

### XMLRiver AI Response Structure

Source: https://xmlriver.com/apidoc/api-ai

This is the typical structure of an AI response from XMLRiver when paid parameters are enabled. The AI answer is base64 encoded HTML.

```xml
...
<ai>
  <answer>PGgxIHN0eWxlPSJtYXJnaW46IDA7cGFkZGluZzogMDtjbG...</answer>
  <item>
    <title>Фрики - Википедия</title>
    <snippet>Фрик (англ. Freak — ненормальный, также человек сильно помешанный на чём-либо) в современном понимании — человек, отличающийся ярк...</snippet>
    <url>https://ru.wikipedia.org/wiki/Фрики#::text=Фрик (англ.,результате отказа от социальных стереотипов.</url>
  </item>
  <item>
    <title>Фрики — кто они? | Главный портал МПГУ</title>
    <snippet>Фрик (freak) – слово, заимствованное из английского языка в дословном переводе имеет несколько значений: «чудак», «придурок», «при...</snippet>
    <url>https://mpgu.su/kultura/fiziologiya-moskvyi/friki-kto-oni/#::text=Фрик (freak) – слово,,п.</url>
  </item>
  ...
</ai>
...
```

--------------------------------

### XMLRiver Structure for Organic Result with Table

Source: https://xmlriver.com/apidoc/api-answerbox

This XML structure shows an organic result featured snippet that includes a table. The 'snippettable' tag contains the table data with header and rows.

```xml
...
<zeroposition>
   <title>сколько стоит страховка ОСАГО на Hyundai Solaris - Банки.ру</title>
   <type>organic_result</type>
   <url>https://www.banki.ru/insurance/order/auto/type/osago/brand/hyundai/model/solaris/</url>
   <snippet></snippet>
   <snippettable>
     <thead>
       <row>
         <col>Год выпуска</col>
         <col>Средняя цена</col>
         <col>Максимальная цена</col>
       </row>
     </thead>
     <row>
       <col>2008</col>
       <col>3 912 ₽</col>
       <col>3 912 ₽</col>
     </row>
     <row>
       <col>2009</col>
       <col>4 017 ₽</col>
       <col>4 017 ₽</col>
     </row>
   </snippettable> 
</zeroposition>
...
```

--------------------------------

### XMLRiver Structure for Song Lyrics Answer Box

Source: https://xmlriver.com/apidoc/api-answerbox

This XML structure represents a song lyrics featured snippet extracted by XMLRiver. It includes the title, type, URL, a snippet, and the full lyrics in the 'lyrics' tag.

```xml
...
<zeroposition>
   <title>Перевод песен Nirvana: перевод песни Dive, текст песни ...</title>
   <type>song</type>
   <url>https://lyrics.lyricfind.com/</url>
   <snippet>YouTube Music Deezer</snippet>
   <lyrics>Oh Pick me, pick me yeah Live alone, lone single Atleast, atleast yeah Everyone is hollow Pick me, pick me yeah Everyone is waiting Pick me pick me yeah You can be the baby Hey Dive Dive Dive Dive in me Dive Dive Dive Dive in me Dive in me Dive in me Dive in me Kiss this, kiss that yeah Live alone, lone single Atleast, atleast yeah You could be my hero Pick me, pick me yeah Everyone is waiting Hit me, hit me yeah I'm real good at hitting Hey Dive Dive Dive Dive in me Dive Dive Dive Dive in me Dive Dive Dive Dive in me Dive in me Dive in me Dive in me Dive Dive Dive Dive in me Dive Dive Dive Dive in me Dive Dive Dive Dive in me Dive in me Dive in me Dive in me Dive in me Dive in me Dive in me Произошла ошибка. Повторите попытку. Перевести на русский</lyrics> 
</zeroposition>
...
```
Tokens:
Raw