Эндпоинт ищет страницы в интернете по текстовому запросу и возвращает список результатов: заголовок, ссылку, выдержку из страницы и, по запросу, полный текст. Типичное применение — второй этап ответа: модель уточняет факты по свежим источникам, а вы передаёте ей найденные страницы.Модель для вызова не нужна. Запрос уходит на поисковую выдачу, а результаты приходят в том порядке, который задала выдача.
Ключ передаётся заголовком Authorization: Bearer sk-.... Он создаётся в личном кабинете и показывается один раз — подробности на странице Аутентификация.
Стоимость вызова зависит от фактической работы поиска. Поле usage.cost — сумма, списанная с вашего баланса; оно отсутствует, если списание не зафиксировано. Поиск, который не нашёл ни одной страницы, не тарифицируется: в этом случае поле usage.cost не приходит.Фактический остаток после вызова проверяйте через GET /api/v1/balance.
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Документация SpeShu.AI","colors":{"primary":"#ff7819","light":"#ff9038","dark":"#ff7819"},"logo":{"light":"https://mintcdn.com/speshu/HiupqL5TwnvMFufM/logo/speshu_logo.png?fit=max\u0026auto=format\u0026n=HiupqL5TwnvMFufM\u0026q=85\u0026s=fd0fe3cc5f642899ca9d4e8bdee6a0f0","dark":"https://mintcdn.com/speshu/HiupqL5TwnvMFufM/logo/speshu_logo.png?fit=max\u0026auto=format\u0026n=HiupqL5TwnvMFufM\u0026q=85\u0026s=fd0fe3cc5f642899ca9d4e8bdee6a0f0"},"favicon":"https://mintcdn.com/speshu/4vy74SrUrHtVMEav/favicon.svg?fit=max\u0026auto=format\u0026n=4vy74SrUrHtVMEav\u0026q=85\u0026s=3fe1d515b10b46d55add95c515686b24","api":{"mdx":{"auth":{"method":"bearer","name":"Authorization"},"server":"https://speshu.ai"}},"appearance":{"default":"light"},"navbar":{"links":[{"href":"/support","label":"Поддержка"}],"primary":{"type":"button","label":"Профиль","href":"https://speshu.ai/profile"}},"footer":{"links":[{"items":[{"label":"Сотрудничество","href":"mailto:info@speshu.ai"},{"label":"Написать в ТГ","href":"https://t.me/sprt_speshu_ai"},{"label":"Клуб AI-Профи","href":"https://t.me/+9Fkgdpnm3axlN2Ji"}]}]},"contextual":{"options":["copy","view"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Модели","icon":"microchip","href":"/api-reference/media/models"},{"anchor":"Каталог","icon":"list","href":"/models"},{"anchor":"Профиль","icon":"gauge","href":"https://speshu.ai/profile"},{"anchor":"Поддержка","icon":"headset","href":"/support"}]},"languages":[{"language":"ru","href":""}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"speshu","hasAudioNarration":false,"actualSubdomain":"speshu","customDomains":["speshu.ai"],"gitSource":{"type":"github","owner":"laoboost","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ad74369dcf1b2c01a0bc747","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"ru","tag":"Руководства","count":41},{"language":"ru","tag":"API Reference","count":23},{"language":"ru","tag":"Документация","count":13},{"language":"ru","tag":"Фреймворки","count":12},{"language":"ru","tag":"Текстовая генерация","count":7},{"language":"ru","tag":"Агенты и редакторы","count":7},{"language":"ru","tag":"Медиа","count":6},{"language":"ru","tag":"О сервисе","count":6},{"language":"ru","tag":"Возможности моделей","count":6},{"language":"ru","tag":"Начало","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/tools/search","slug":"/api-reference/tools/search","pageMetadata":{"title":"Поиск в интернете","description":"POST /api/v1/tools/search — поиск страниц в интернете по текстовому запросу","openapi":"api-reference/openapi.json POST /api/v1/tools/search","playground":"interactive","icon":"magnifying-glass","href":"/api-reference/tools/search"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"POST /api/v1/tools/search — поиск страниц в интернете по текстовому запросу\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,Heading,Note,Table}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Эндпоинт ищет страницы в интернете по текстовому запросу и возвращает список результатов: заголовок, ссылку, выдержку из страницы и, по запросу, полный текст. Типичное применение — второй этап ответа: модель уточняет факты по свежим источникам, а вы передаёте ей найденные страницы.`}),`\n`,_jsx(_components.p,{children:`Модель для вызова не нужна. Запрос уходит на поисковую выдачу, а результаты приходят в том порядке, который задала выдача.`}),`\n`,_jsx(Heading,{level:`2`,id:`минимальный-запрос`,children:`Минимальный запрос`}),`\n`,_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`6`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://speshu.ai/api/v1/tools/search`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$SPESHU_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"query\": \"Как вернуть товар?\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Ключ передаётся заголовком `,_jsx(_components.code,{children:`Authorization: Bearer sk-...`}),`. Он создаётся в личном кабинете и показывается один раз — подробности на странице `,_jsx(_components.a,{href:`/authentication`,children:`Аутентификация`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`поля-запроса`,children:`Поля запроса`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Поле`}),_jsx(_components.th,{children:`Тип`}),_jsx(_components.th,{children:`Описание`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`query`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Поисковый запрос. Обязательно; от 1 до 128 символов. Запрос из одних пробелов не принимается`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`count`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Сколько результатов вернуть. Необязательно; от 1 до 50. По умолчанию 10`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ori_question`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Исходный вопрос пользователя, которому служит поиск. Необязательно; до 128 символов`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`localization`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Подсказка по языку и региону выдачи. Необязательно`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`need_content`})}),_jsx(_components.td,{children:`boolean`}),_jsxs(_components.td,{children:[`Возвращать ли текст страницы целиком. Необязательно; по умолчанию `,_jsx(_components.code,{children:`false`})]})]})]})]}),`\n`,_jsx(_components.p,{children:`Длины считаются в символах, а не в байтах: кириллический запрос из 100 символов занимает 200 байт и проходит проверку.`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Поле `,_jsx(_components.code,{children:`count`}),` необязательное, но значение `,_jsx(_components.code,{children:`0`}),` — ошибка: явный ноль не равен отсутствующему полю. Чтобы получить 10 результатов, не передавайте `,_jsx(_components.code,{children:`count`}),` вовсе.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`ответ`,children:`Ответ`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`200 OK`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`19`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`19`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"results\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"rerank_score\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.97`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"title\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Возврат товара\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com/voztrat\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"snippet\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Вернуть товар можно в течение 14 дней...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"summary\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Правила возврата товара в течение 14 дней.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"content\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"site_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"site_icon\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com/favicon.ico\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"date\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-06-01\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"authority\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`80`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"usage\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"cost\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.0004`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Поле`}),_jsx(_components.th,{children:`Тип`}),_jsx(_components.th,{children:`Описание`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`results`})}),_jsx(_components.td,{children:`array`}),_jsx(_components.td,{children:`Найденные страницы. Пустой массив — успешный ответ, а не ошибка`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`results[].title`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Заголовок страницы`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`results[].url`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Адрес страницы`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`results[].snippet`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Выдержка из страницы`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`results[].summary`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Краткое описание страницы`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`results[].content`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Текст страницы. Заполняется, только если в запросе `,_jsx(_components.code,{children:`need_content: true`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`results[].site_name`})}),_jsx(_components.td,{children:`string | null`}),_jsx(_components.td,{children:`Название сайта, если выдача его знает`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`results[].site_icon`})}),_jsx(_components.td,{children:`string | null`}),_jsx(_components.td,{children:`Адрес иконки сайта`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`results[].date`})}),_jsx(_components.td,{children:`string | null`}),_jsx(_components.td,{children:`Дата публикации в том виде, в каком её отдала выдача`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`results[].authority`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Оценка авторитетности сайта`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`results[].rerank_score`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Оценка релевантности результата`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`usage`})}),_jsx(_components.td,{children:`object`}),_jsx(_components.td,{children:`Расход по вызову. Объект есть всегда, в каждом ответе`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`usage.cost`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Сумма, списанная с вашего баланса за вызов. Поле отсутствует, если списание не зафиксировано`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Дата приходит строкой в том виде, в каком её отдала выдача, и может быть `,_jsx(_components.code,{children:`null`}),`. Не разбирайте её как дату ISO без проверки формата.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`стоимость`,children:`Стоимость`}),`\n`,_jsxs(_components.p,{children:[`Стоимость вызова зависит от фактической работы поиска. Поле `,_jsx(_components.code,{children:`usage.cost`}),` — сумма, списанная с вашего баланса; оно отсутствует, если списание не зафиксировано. Поиск, который не нашёл ни одной страницы, не тарифицируется: в этом случае поле `,_jsx(_components.code,{children:`usage.cost`}),` не приходит.`]}),`\n`,_jsxs(_components.p,{children:[`Фактический остаток после вызова проверяйте через `,_jsx(_components.code,{children:`GET /api/v1/balance`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`проверки-перед-вызовом`,children:`Проверки перед вызовом`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Ситуация`}),_jsx(_components.th,{children:`Ответ`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Нет ключа или ключ недействителен`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`401 invalid_api_key`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Не хватает денег`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`402 insufficient_quota`})})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Нет `,_jsx(_components.code,{children:`query`}),`, `,_jsx(_components.code,{children:`query`}),` из одних пробелов, `,_jsx(_components.code,{children:`query`}),` длиннее 128 символов, `,_jsx(_components.code,{children:`count`}),` вне диапазона от 1 до 50, `,_jsx(_components.code,{children:`ori_question`}),` длиннее 128 символов`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`400 invalid_request`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Превышен лимит запросов в минуту`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`429 rate_limit_exceeded`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Превышен лимит потребления в минуту`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`429 token_limit_exceeded`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Поиск недоступен`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`503 service_unavailable`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Поисковая выдача вернула ошибку`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`502 upstream_error`})})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Ошибки приходят в конверте OpenAI — объект `,_jsx(_components.code,{children:`error`}),` с полями `,_jsx(_components.code,{children:`message`}),`, `,_jsx(_components.code,{children:`type`}),`, `,_jsx(_components.code,{children:`param`}),` и `,_jsx(_components.code,{children:`code`}),`. Полная таблица кодов — на странице `,_jsx(_components.a,{href:`/errors`,children:`Ошибки`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`что-дальше`,children:`Что дальше`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Загрузка страницы`,icon:`file-lines`,href:`/api-reference/tools/fetch`,children:_jsx(_components.p,{children:`Текст найденной страницы по ссылке`})}),_jsx(Card,{title:`Ранжирование`,icon:`arrow-down-short-wide`,href:`/api-reference/rerank/create`,children:_jsx(_components.p,{children:`Второй этап отбора документов`})}),_jsx(Card,{title:`Баланс`,icon:`wallet`,href:`/api-reference/other/balance`,children:_jsx(_components.p,{children:`Остаток кошелька по валютам`})}),_jsx(Card,{title:`Ошибки`,icon:`triangle-exclamation`,href:`/errors`,children:_jsx(_components.p,{children:`Полная таблица кодов`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Поиск в интернете","description":"POST /api/v1/tools/search — поиск страниц в интернете по текстовому запросу","openapi":"api-reference/openapi.json POST /api/v1/tools/search","playground":"interactive","icon":"magnifying-glass","href":"/api-reference/tools/search"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Минимальный запрос","slug":"минимальный-запрос","depth":2,"children":[]},{"title":"Поля запроса","slug":"поля-запроса","depth":2,"children":[]},{"title":"Ответ","slug":"ответ","depth":2,"children":[{"title":"Стоимость","slug":"стоимость","depth":3,"children":[]}]},{"title":"Проверки перед вызовом","slug":"проверки-перед-вызовом","depth":2,"children":[]},{"title":"Что дальше","slug":"что-дальше","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Инструменты"],"operationId":"createSearch","summary":"Поиск в интернете","description":"POST /api/v1/tools/search — поиск страниц в интернете по текстовому запросу","requestBody":"efd55518-df67-425e-b31a-4216f88f2bda","responses":{"200":"923bec21-f947-4a2a-9d43-50ddf93f5672","400":"66703eda-2e21-4084-a52c-df96289313e1","401":"9e154562-efd3-4329-9f19-a08673865f3f","402":"5c09815a-915b-450e-8671-e52ce121125b","429":"17d05bac-ad83-4d6e-8834-8aefbc4e2fdd","499":"6f6cb26b-4716-49d1-8f4e-819696ae0588","500":"54262d81-05d6-42dd-9e54-c1e144ac8966","502":"ef2533e2-a856-415a-9f1e-78011d004460","503":"25c9009e-33b7-4a42-8a0c-c9d4bd3e6804","504":"11875381-9e30-4bba-aff8-83073a9a725f"},"method":"post","type":"path","servers":["8a2807ef-ac4b-47e6-8d72-307eede96316"],"security":["e2ba089c-3a25-43cf-af05-e084bb9608e5"],"path":"/api/v1/tools/search","baseUrlOptions":["https://speshu.ai"],"title":"Поиск в интернете","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","minLength":1,"maxLength":128,"description":"Поисковый запрос. Обязательно; от 1 до 128 символов. Запрос из одних пробелов не принимается.","isRequired":true,"uniqueKey":"query","typeLabel":"string"},"count":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Сколько результатов вернуть. Необязательно; по умолчанию 10. Значение 0 отклоняется.","uniqueKey":"count","typeLabel":"integer"},"ori_question":{"type":"string","maxLength":128,"description":"Исходный вопрос пользователя, которому служит поиск. Необязательно.","uniqueKey":"ori_question","typeLabel":"string"},"localization":{"type":"string","description":"Подсказка по языку и региону выдачи. Необязательно.","uniqueKey":"localization","typeLabel":"string"},"need_content":{"type":"boolean","default":false,"description":"Возвращать ли текст страницы целиком. По умолчанию false.","uniqueKey":"need_content","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"query":"\u003cstring>","count":10,"ori_question":"\u003cstring>","localization":"\u003cstring>","need_content":false}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"923bec21-f947-4a2a-9d43-50ddf93f5672":{"description":"Найденные страницы.","content":{"application/json":{"schema":{"type":"object","required":["results","usage"],"properties":{"results":{"type":"array","description":"Найденные страницы. Пустой массив — успешный ответ, а не ошибка.","items":{"type":"object","properties":{"rerank_score":{"type":"number","description":"Оценка релевантности результата.","uniqueKey":"results.items.[INDEX].rerank_score","typeLabel":"number"},"title":{"type":"string","description":"Заголовок страницы.","uniqueKey":"results.items.[INDEX].title","typeLabel":"string"},"url":{"type":"string","description":"Адрес страницы.","uniqueKey":"results.items.[INDEX].url","typeLabel":"string"},"snippet":{"type":"string","description":"Выдержка из страницы.","uniqueKey":"results.items.[INDEX].snippet","typeLabel":"string"},"summary":{"type":"string","description":"Краткое описание страницы.","uniqueKey":"results.items.[INDEX].summary","typeLabel":"string"},"content":{"type":"string","description":"Текст страницы. Заполняется, только если в запросе need_content: true.","uniqueKey":"results.items.[INDEX].content","typeLabel":"string"},"site_name":{"oneOf":[{"type":"string","description":"Название сайта, если выдача его знает.","uniqueKey":"results.items.[INDEX].site_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Название сайта, если выдача его знает.","uniqueKey":"results.items.[INDEX].site_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].site_name","typeLabel":"string | null"},"site_icon":{"oneOf":[{"type":"string","description":"Адрес иконки сайта.","uniqueKey":"results.items.[INDEX].site_icon.oneOf.0","typeLabel":"string"},{"type":"null","description":"Адрес иконки сайта.","uniqueKey":"results.items.[INDEX].site_icon.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].site_icon","typeLabel":"string | null"},"date":{"oneOf":[{"type":"string","description":"Дата публикации в том виде, в каком её отдала выдача.","uniqueKey":"results.items.[INDEX].date.oneOf.0","typeLabel":"string"},{"type":"null","description":"Дата публикации в том виде, в каком её отдала выдача.","uniqueKey":"results.items.[INDEX].date.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].date","typeLabel":"string | null"},"authority":{"type":"integer","description":"Оценка авторитетности сайта.","uniqueKey":"results.items.[INDEX].authority","typeLabel":"integer"}},"uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results","typeLabel":"object[]"},"usage":{"type":"object","description":"Расход по вызову. Объект есть всегда, в каждом ответе.","properties":{"cost":{"type":"number","description":"Сумма, списанная с вашего баланса за вызов. Отсутствует, если списание не зафиксировано.","uniqueKey":"usage.cost","typeLabel":"number"}},"isRequired":true,"uniqueKey":"usage","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"results":[{"rerank_score":123,"title":"\u003cstring>","url":"\u003cstring>","snippet":"\u003cstring>","summary":"\u003cstring>","content":"\u003cstring>","site_name":"\u003cstring>","site_icon":"\u003cstring>","date":"\u003cstring>","authority":123}],"usage":{"cost":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"66703eda-2e21-4084-a52c-df96289313e1":{"description":"Ошибка в формате OpenAI.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","examples":["invalid_request_error"],"description":"`authentication_error` при 401, `rate_limit_error` при 429, `permission_error` при 403, в остальных случаях `invalid_request_error`, `api_error` или `internal_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"required":["message","type"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"invalid_request_error","param":"\u003cstring>","code":"invalid_request"}}}},"exampleType":"generated"}},"exampleType":"generated"},"9e154562-efd3-4329-9f19-a08673865f3f":{"description":"Ошибка в формате OpenAI.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","examples":["invalid_request_error"],"description":"`authentication_error` при 401, `rate_limit_error` при 429, `permission_error` при 403, в остальных случаях `invalid_request_error`, `api_error` или `internal_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"required":["message","type"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"invalid_request_error","param":"\u003cstring>","code":"invalid_request"}}}},"exampleType":"generated"}},"exampleType":"generated"},"5c09815a-915b-450e-8671-e52ce121125b":{"description":"Ошибка в формате OpenAI.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","examples":["invalid_request_error"],"description":"`authentication_error` при 401, `rate_limit_error` при 429, `permission_error` при 403, в остальных случаях `invalid_request_error`, `api_error` или `internal_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"required":["message","type"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"invalid_request_error","param":"\u003cstring>","code":"invalid_request"}}}},"exampleType":"generated"}},"exampleType":"generated"},"17d05bac-ad83-4d6e-8834-8aefbc4e2fdd":{"description":"Ошибка в формате OpenAI.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","examples":["invalid_request_error"],"description":"`authentication_error` при 401, `rate_limit_error` при 429, `permission_error` при 403, в остальных случаях `invalid_request_error`, `api_error` или `internal_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"required":["message","type"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"invalid_request_error","param":"\u003cstring>","code":"invalid_request"}}}},"exampleType":"generated"}},"exampleType":"generated"},"6f6cb26b-4716-49d1-8f4e-819696ae0588":{"description":"Ошибка в формате OpenAI.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","examples":["invalid_request_error"],"description":"`authentication_error` при 401, `rate_limit_error` при 429, `permission_error` при 403, в остальных случаях `invalid_request_error`, `api_error` или `internal_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"required":["message","type"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"invalid_request_error","param":"\u003cstring>","code":"invalid_request"}}}},"exampleType":"generated"}},"exampleType":"generated"},"54262d81-05d6-42dd-9e54-c1e144ac8966":{"description":"Ошибка в формате OpenAI.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","examples":["invalid_request_error"],"description":"`authentication_error` при 401, `rate_limit_error` при 429, `permission_error` при 403, в остальных случаях `invalid_request_error`, `api_error` или `internal_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"required":["message","type"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"invalid_request_error","param":"\u003cstring>","code":"invalid_request"}}}},"exampleType":"generated"}},"exampleType":"generated"},"ef2533e2-a856-415a-9f1e-78011d004460":{"description":"Ошибка в формате OpenAI.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","examples":["invalid_request_error"],"description":"`authentication_error` при 401, `rate_limit_error` при 429, `permission_error` при 403, в остальных случаях `invalid_request_error`, `api_error` или `internal_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"required":["message","type"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"invalid_request_error","param":"\u003cstring>","code":"invalid_request"}}}},"exampleType":"generated"}},"exampleType":"generated"},"25c9009e-33b7-4a42-8a0c-c9d4bd3e6804":{"description":"Ошибка в формате OpenAI.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","examples":["invalid_request_error"],"description":"`authentication_error` при 401, `rate_limit_error` при 429, `permission_error` при 403, в остальных случаях `invalid_request_error`, `api_error` или `internal_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"required":["message","type"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"invalid_request_error","param":"\u003cstring>","code":"invalid_request"}}}},"exampleType":"generated"}},"exampleType":"generated"},"11875381-9e30-4bba-aff8-83073a9a725f":{"description":"Ошибка в формате OpenAI.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","examples":["invalid_request_error"],"description":"`authentication_error` при 401, `rate_limit_error` при 429, `permission_error` при 403, в остальных случаях `invalid_request_error`, `api_error` или `internal_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"required":["message","type"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"invalid_request_error","param":"\u003cstring>","code":"invalid_request"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"e2ba089c-3a25-43cf-af05-e084bb9608e5":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API-ключ в формате `sk-...`. Альтернативно — заголовок `X-Api-Key: sk-...` (совместимо с Anthropic SDK).","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"8a2807ef-ac4b-47e6-8d72-307eede96316":{"url":"https://speshu.ai","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API-ключ в формате `sk-...`. Альтернативно — заголовок `X-Api-Key: sk-...` (совместимо с Anthropic SDK).","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API-ключ в формате `sk-...`. Альтернативно — заголовок `X-Api-Key: sk-...` (совместимо с Anthropic SDK).","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"speshu","siteName":"Документация SpeShu.AI","title":"Поиск в интернете - Документация SpeShu.AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"ru":{"href":"/api-reference/tools/search","matchLevel":0}}},"lastModified":"2026-10-20T10:33:24.153Z","originalFileLocation":"api-reference/tools/search.mdx","locale":"ru"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"POST /api/v1/tools/search — поиск страниц в интернете по текстовому запросу\">\u003cmeta data-mint-head name=\"application-name\" content=\"Документация SpeShu.AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/speshu/h8uCrMo0u7Pj0sRw/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/speshu/h8uCrMo0u7Pj0sRw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/speshu/h8uCrMo0u7Pj0sRw/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/speshu/h8uCrMo0u7Pj0sRw/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/speshu/h8uCrMo0u7Pj0sRw/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/speshu/h8uCrMo0u7Pj0sRw/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/speshu/h8uCrMo0u7Pj0sRw/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/speshu/h8uCrMo0u7Pj0sRw/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/speshu/h8uCrMo0u7Pj0sRw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Поиск в интернете - Документация SpeShu.AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"POST /api/v1/tools/search — поиск страниц в интернете по текстовому запросу\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Документация SpeShu.AI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://speshu.ai/docs/api-reference/tools/search\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://speshu.mintlify.site/docs/_mintlify/api/og/v2?division=%D0%98%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D1%8B\u0026amp;title=%D0%9F%D0%BE%D0%B8%D1%81%D0%BA+%D0%B2+%D0%B8%D0%BD%D1%82%D0%B5%D1%80%D0%BD%D0%B5%D1%82%D0%B5\u0026amp;description=POST+%2Fapi%2Fv1%2Ftools%2Fsearch+%E2%80%94+%D0%BF%D0%BE%D0%B8%D1%81%D0%BA+%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86+%D0%B2+%D0%B8%D0%BD%D1%82%D0%B5%D1%80%D0%BD%D0%B5%D1%82%D0%B5+%D0%BF%D0%BE+%D1%82%D0%B5%D0%BA%D1%81%D1%82%D0%BE%D0%B2%D0%BE%D0%BC%D1%83+%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D1%83\u0026amp;theme=e30006b63b476fd6b922259f\u0026amp;signature=eb13d36c1c715e1cd1c3f9470d2abf709cb7b0a1c454442a2bb917b820fcc0d9\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Поиск в интернете - Документация SpeShu.AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"POST /api/v1/tools/search — поиск страниц в интернете по текстовому запросу\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://speshu.mintlify.site/docs/_mintlify/api/og/v2?division=%D0%98%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D1%8B\u0026amp;title=%D0%9F%D0%BE%D0%B8%D1%81%D0%BA+%D0%B2+%D0%B8%D0%BD%D1%82%D0%B5%D1%80%D0%BD%D0%B5%D1%82%D0%B5\u0026amp;description=POST+%2Fapi%2Fv1%2Ftools%2Fsearch+%E2%80%94+%D0%BF%D0%BE%D0%B8%D1%81%D0%BA+%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86+%D0%B2+%D0%B8%D0%BD%D1%82%D0%B5%D1%80%D0%BD%D0%B5%D1%82%D0%B5+%D0%BF%D0%BE+%D1%82%D0%B5%D0%BA%D1%81%D1%82%D0%BE%D0%B2%D0%BE%D0%BC%D1%83+%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D1%83\u0026amp;theme=e30006b63b476fd6b922259f\u0026amp;signature=eb13d36c1c715e1cd1c3f9470d2abf709cb7b0a1c454442a2bb917b820fcc0d9\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/speshu/h8uCrMo0u7Pj0sRw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Документация SpeShu.AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ff7819\">\u003clink data-mint-head rel=\"canonical\" href=\"https://speshu.ai/docs/api-reference/tools/search\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/tools/search.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://speshu.ai/#organization\",\"name\":\"Документация SpeShu.AI\",\"url\":\"https://speshu.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/speshu/HiupqL5TwnvMFufM/logo/speshu_logo.png?fit=max\u0026auto=format\u0026n=HiupqL5TwnvMFufM\u0026q=85\u0026s=fd0fe3cc5f642899ca9d4e8bdee6a0f0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://speshu.ai/docs#website\",\"name\":\"Документация SpeShu.AI\",\"url\":\"https://speshu.ai/docs\",\"publisher\":{\"@id\":\"https://speshu.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://speshu.ai/docs/api-reference/tools/search#webpage\",\"url\":\"https://speshu.ai/docs/api-reference/tools/search\",\"name\":\"Поиск в интернете\",\"description\":\"POST /api/v1/tools/search — поиск страниц в интернете по текстовому запросу\",\"dateModified\":\"2026-10-20T10:33:24.153Z\",\"isPartOf\":{\"@id\":\"https://speshu.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://speshu.ai/docs/api-reference/tools/search#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://speshu.ai/docs/api-reference/tools/search#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Документация SpeShu.AI\",\"item\":\"https://speshu.ai/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Поиск в интернете\",\"item\":\"https://speshu.ai/docs/api-reference/tools/search\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://speshu.ai/docs/api-reference/tools/search#apireference\",\"headline\":\"Поиск в интернете\",\"name\":\"Поиск в интернете\",\"description\":\"POST /api/v1/tools/search — поиск страниц в интернете по текстовому запросу\",\"url\":\"https://speshu.ai/docs/api-reference/tools/search\",\"mainEntityOfPage\":{\"@id\":\"https://speshu.ai/docs/api-reference/tools/search#webpage\"},\"dateModified\":\"2026-10-20T10:33:24.153Z\",\"publisher\":{\"@id\":\"https://speshu.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://speshu.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Документация SpeShu.AI\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Документация SpeShu.AI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/tools/search.md","siteName":"Документация SpeShu.AI","nav":{"global":{"anchors":[{"anchor":"Модели","icon":"microchip","href":"/api-reference/media/models"},{"anchor":"Каталог","icon":"list","href":"/models"},{"anchor":"Профиль","icon":"gauge","href":"https://speshu.ai/profile"},{"anchor":"Поддержка","icon":"headset","href":"/support"}]},"languages":[{"language":"ru","tabs":[{"tab":"Документация","pages":[{"title":"Документация","href":""}]},{"tab":"Руководства","pages":[{"title":"Руководства","href":"/gaidy/getting-started"}]},{"tab":"API Reference","groups":[{"group":"Текстовая генерация","pages":[{"title":"Введение в API","icon":"book","href":"/api-reference/introduction"},{"title":"Запрос чату","openapi":"api-reference/openapi.json POST /api/v1/chat/completions","playground":"interactive","icon":"message","href":"/api-reference/chat/completions"},{"title":"Responses","openapi":"api-reference/openapi.json POST /api/v1/responses","icon":"list","href":"/api-reference/responses/create"},{"title":"Anthropic Messages","openapi":"api-reference/openapi.json POST /api/v1/messages","icon":"a","href":"/api-reference/messages/create"},{"title":"Оценка решений","openapi":"api-reference/openapi.json POST /api/v1/decisions","playground":"interactive","icon":"scale-balanced","href":"/api-reference/decisions/create"},{"title":"Эмбеддинги","openapi":"api-reference/openapi.json POST /api/v1/embeddings","playground":"interactive","icon":"circle-nodes","href":"/api-reference/embeddings/create"},{"title":"Ранжирование","description":"POST /api/v1/rerank — оценка релевантности документов относительно запроса","openapi":"api-reference/openapi.json POST /api/v1/rerank","playground":"interactive","icon":"arrow-down-short-wide","href":"/api-reference/rerank/create"}]},{"group":"Инструменты","pages":[{"title":"Поиск в интернете","openapi":"api-reference/openapi.json POST /api/v1/tools/search","playground":"interactive","icon":"magnifying-glass","href":"/api-reference/tools/search"},{"title":"Загрузка страницы","description":"POST /api/v1/tools/fetch — текст страницы по ссылке","openapi":"api-reference/openapi.json POST /api/v1/tools/fetch","playground":"interactive","icon":"file-lines","href":"/api-reference/tools/fetch"}]},{"group":"Аудио","pages":[{"title":"Синтез речи","openapi":"api-reference/openapi.json POST /api/v1/audio/speech","playground":"interactive","icon":"volume-high","href":"/api-reference/audio/speech"},{"title":"Распознавание речи","openapi":"api-reference/openapi.json POST /api/v1/audio/transcriptions","playground":"interactive","icon":"microphone","href":"/api-reference/audio/transcriptions"}]},{"group":"Медиа","pages":[{"title":"Создать задачу","openapi":"api-reference/openapi.json POST /api/v1/async/media/tasks","playground":"interactive","icon":"plus","href":"/api-reference/media/create"},{"title":"Статус задачи","openapi":"api-reference/openapi.json GET /api/v1/async/media/tasks/{task_id}","icon":"magnifying-glass","href":"/api-reference/media/status"},{"title":"Список задач","openapi":"api-reference/openapi.json GET /api/v1/async/media/tasks","icon":"list","href":"/api-reference/media/list"},{"title":"Жизненный цикл задачи","openapi":"/api-reference/openapi.json","icon":"rotate","href":"/api-reference/media/tasks"},{"title":"Медиа-сессии","icon":"folder","href":"/api-reference/media/sessions"},{"title":"Каталог медиа-моделей","openapi":"api-reference/openapi.json GET /api/v1/media/models","icon":"microchip","href":"/api-reference/media/models"}]},{"group":"Хранилище","pages":[{"title":"Загрузить файл","openapi":"api-reference/openapi.json POST /api/v1/storage/upload","playground":"interactive","icon":"upload","href":"/api-reference/storage/upload"},{"title":"Список файлов","openapi":"api-reference/openapi.json GET /api/v1/storage","playground":"interactive","icon":"list","href":"/api-reference/storage/list"},{"title":"Метаданные файла","openapi":"api-reference/openapi.json GET /api/v1/storage/{id}","playground":"interactive","icon":"magnifying-glass","href":"/api-reference/storage/get"},{"title":"Удалить файл","openapi":"api-reference/openapi.json DELETE /api/v1/storage/{id}","icon":"trash","href":"/api-reference/storage/delete"}]},{"group":"Модели и баланс","pages":[{"title":"Каталог моделей","openapi":"api-reference/openapi.json GET /api/v1/models","playground":"interactive","icon":"microchip","href":"/api-reference/models/list"},{"title":"Баланс","openapi":"api-reference/openapi.json GET /api/v1/balance","playground":"interactive","icon":"wallet","href":"/api-reference/other/balance"}]}]}]}]},"basePath":"","title":"Поиск в интернете - Документация SpeShu.AI","buildId":"dpl_2AK98Hxhwu4fUXpx9atbv41cC328","deploymentId":"dpl_2AK98Hxhwu4fUXpx9atbv41cC328","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-EBSrFTg1.js","utils-Y_7TcRh4.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D1wvvkPH.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-aT0ty6oN.js","snippetPresets-DoNRuyJc.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-DCFaZE46.js","ApiExamples-CXRajFpn.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BAyOsINj.js","shallow-CIcHqV1v.js","getApiPlaygroundDisplay-C5igZwEf.js","CodeSnippet-BFWnQLNh.js","CodeSnippets-Cx2mFgZW.js","getPastedJson-BOy09PZp.js","icon-BwmYtB6R.js","MethodPill-DAIhq-iu.js","DuplicateIcon-DFM8Q3ph.js","createIcon-0UdvzB4Z.js","DynamicMarkdown-DYYZTGpa.js","SectionHeading-BFCDRUuH.js","axios-vUo_bRtp.js","Markdown-C6TcKjiR.js","clsx-Y_UC780V.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-PCbBHBTv.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-D4q_oRML.js"]}