{
"error": {
"code": "upstream_error",
"message": "Failed to fetch data from an upstream service.",
"details": {
"upstreamStatus": 503
}
}
}
Web Data
Search
Searches the public web and returns lightweight organic results in ranking order. One successful search consumes one Web Data request. Use this to discover relevant pages; use fetchWebData when you already have a URL and need its HTML. AI overviews, related questions, and location controls are not included.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Floppydata Client API","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/floppydata/t-In33JhdHge9jll/logo/light.svg?fit=max\u0026auto=format\u0026n=t-In33JhdHge9jll\u0026q=85\u0026s=2b3535dc315190c13602ee83ea3378c2","dark":"https://mintcdn.com/floppydata/t-In33JhdHge9jll/logo/dark.svg?fit=max\u0026auto=format\u0026n=t-In33JhdHge9jll\u0026q=85\u0026s=0f73f0b83947c39a68c2b0167841ab91"},"favicon":"https://mintcdn.com/floppydata/7MGx7VQNZ_E0n9Af/favicon.svg?fit=max\u0026auto=format\u0026n=7MGx7VQNZ_E0n9Af\u0026q=85\u0026s=eb959f0fd197b23eaa20c112427e3ede","api":{"openapi":["api-reference/openapi.json","api-reference/openapi-v1.json"],"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript"],"prefill":true},"url":"full"},"navbar":{"links":[{"href":"https://app.floppydata.com","label":"Dashboard"}],"primary":{"type":"button","label":"Get API key","href":"https://app.floppydata.com/api-keys"}},"footer":{"socials":{"github":"https://github.com/Floppydata/floppydata-docs"}},"contextual":{"options":["copy","view"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"floppydata","hasAudioNarration":false,"actualSubdomain":"floppydata","customDomains":["floppydata.com"],"gitSource":{"type":"github","owner":"floppydata","repo":"floppydata-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"issues":false,"edits":false},"entitlements":{},"buildId":"6acf3140c1c56b6740ebd9ed","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"API Reference","count":22},{"language":"default","tag":"V2","count":22},{"language":"default","tag":"Proxy","count":9},{"language":"default","tag":"Guides","count":9},{"language":"default","tag":"Cloud Browser","count":7},{"language":"default","tag":"Rotating","count":7},{"language":"default","tag":"Start","count":6},{"language":"default","tag":"Core API tasks","count":6},{"language":"default","tag":"Web Data","count":4},{"language":"default","tag":"Proxy setup","count":3}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/v2/endpoint/web-data-search","slug":"/api-reference/v2/endpoint/web-data-search","pageMetadata":{"title":"Search","openapi":"api-reference/openapi.json POST /v2/web-data/search","description":"Searches the public web and returns lightweight organic results in ranking order. One successful search consumes one Web Data request. Use this to discover relevant pages; use fetchWebData when you already have a URL and need its HTML. AI overviews, related questions, and location controls are not included.","href":"/api-reference/v2/endpoint/web-data-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: \"Searches the public web and returns lightweight organic results in ranking order. One successful search consumes one Web Data request. Use this to discover relevant pages; use fetchWebData when you already have a URL and need its HTML. AI overviews, related questions, and location controls are not included.\"\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={p:`p`,..._provideComponents(),...props.components},{Note,Warning}=_components;if(!Note)_missingMdxReference(`Note`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:_jsx(_components.p,{children:`This playground sends real production requests. Each successful search consumes one Web Data request.`})}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Results come from Google Search. The search engine is fixed; this endpoint does not accept an engine selector.`})})]})}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":"Search","openapi":"api-reference/openapi.json POST /v2/web-data/search","description":"Searches the public web and returns lightweight organic results in ranking order. One successful search consumes one Web Data request. Use this to discover relevant pages; use fetchWebData when you already have a URL and need its HTML. AI overviews, related questions, and location controls are not included.","href":"/api-reference/v2/endpoint/web-data-search"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"searchWebData","summary":"Search the web with Web Data","description":"Searches the public web and returns lightweight organic results in ranking order. One successful search consumes one Web Data request. Use this to discover relevant pages; use fetchWebData when you already have a URL and need its HTML. AI overviews, related questions, and location controls are not included.","tags":["Web Data"],"responses":{"200":"7911b92e-8e90-4faa-9757-f414f62da9ed","400":"ff209c96-4f6c-4cfa-8817-17b3c0f7d1c3","401":"9c8dc147-3d02-4a82-99e8-a7d813adaf5a","402":"98d081dd-ff05-47ce-aa76-01be9720ef30","403":"8528a2c5-1eaa-458d-a5b3-b16d083d37f8","404":"3da8dd25-6088-48b5-829f-06b18c48ffe3","409":"7c536b05-d0f2-4d36-942b-df214b028734","500":"add59130-ba44-41dc-a546-443f43b8bd3a","502":"8e4f086a-ef93-4d8b-b53d-306338d5c0d2"},"requestBody":"a7df8f0a-5f58-4395-8764-2f795f11b5cd","method":"post","type":"path","servers":["5a416e7f-7912-470a-86f6-f1cfb9117df7"],"security":["af1e0e9b-cfa3-42c1-ab39-d4abb4facf41"],"path":"/v2/web-data/search","baseUrlOptions":["https://api.floppydata.net"],"title":"Search the web with Web Data","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.query":"browser automation","body.numResults":10}],"urlDisplay":"full"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":200,"description":"Search query. Whitespace is trimmed before searching.","example":"browser automation","isRequired":true,"uniqueKey":"query","typeLabel":"string"},"numResults":{"default":10,"description":"Maximum number of organic results to return.","example":10,"type":"integer","minimum":1,"maximum":25,"uniqueKey":"numResults","typeLabel":"integer"}},"required":["query"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"query":"browser automation","numResults":10}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"7911b92e-8e90-4faa-9757-f414f62da9ed":{"description":"Normalized organic search results.","content":{"application/json":{"schema":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Unique identifier for this search request.","isRequired":true,"uniqueKey":"requestId","typeLabel":"string\u003cuuid>"},"query":{"type":"string","minLength":1,"description":"Normalized search query.","isRequired":true,"uniqueKey":"query","typeLabel":"string"},"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Unique identifier for this result.","isRequired":true,"uniqueKey":"results.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"title":{"type":"string","minLength":1,"description":"Page title.","isRequired":true,"uniqueKey":"results.items.[INDEX].title","typeLabel":"string"},"url":{"type":"string","format":"uri","description":"Page URL.","isRequired":true,"uniqueKey":"results.items.[INDEX].url","typeLabel":"string\u003curi>"},"snippet":{"description":"Search result excerpt when available.","type":"string","minLength":1,"uniqueKey":"results.items.[INDEX].snippet","typeLabel":"string"}},"required":["id","title","url"],"additionalProperties":false,"uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"description":"Organic results in provider ranking order.","isRequired":true,"uniqueKey":"results","typeLabel":"object[]"}},"required":["requestId","query","results"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"example":{"requestId":"b111bdad-09aa-41df-a216-5b22d85db45c","query":"browser automation","results":[{"id":"8ec7797f-d0b8-474d-a128-d96e88155253","title":"Browser automation guide","url":"https://example.com/browser-automation","snippet":"A practical guide to browser automation."}]},"examples":{"Example":{"title":"Example","value":{"requestId":"b111bdad-09aa-41df-a216-5b22d85db45c","query":"browser automation","results":[{"id":"8ec7797f-d0b8-474d-a128-d96e88155253","title":"Browser automation guide","url":"https://example.com/browser-automation","snippet":"A practical guide to browser automation."}]}}},"exampleType":"examples"}},"exampleType":"examples"},"ff209c96-4f6c-4cfa-8817-17b3c0f7d1c3":{"description":"The request body or query parameters are invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"invalid_request","message":"Invalid request parameters.","details":{"issues":[{"path":"countryCode","code":"invalid_format","message":"Expected a 2-letter country code."}]}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"Invalid request parameters.","details":{"issues":[{"path":"countryCode","code":"invalid_format","message":"Expected a 2-letter country code."}]}}}}},"exampleType":"examples"}},"exampleType":"examples"},"9c8dc147-3d02-4a82-99e8-a7d813adaf5a":{"description":"The API key is missing, invalid, or expired.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"unauthorized","message":"Unauthorized","details":{}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthorized","message":"Unauthorized","details":{}}}}},"exampleType":"examples"}},"exampleType":"examples"},"98d081dd-ff05-47ce-aa76-01be9720ef30":{"description":"The account does not have enough balance for this request.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"insufficient_balance","message":"Insufficient proxy traffic balance.","details":{}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"insufficient_balance","message":"Insufficient proxy traffic balance.","details":{}}}}},"exampleType":"examples"}},"exampleType":"examples"},"8528a2c5-1eaa-458d-a5b3-b16d083d37f8":{"description":"The API key does not grant access to this operation.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"forbidden","message":"Forbidden","details":{}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"forbidden","message":"Forbidden","details":{}}}}},"exampleType":"examples"}},"exampleType":"examples"},"3da8dd25-6088-48b5-829f-06b18c48ffe3":{"description":"The requested resource is not available.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"not_found","message":"Requested resource was not found.","details":{}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"not_found","message":"Requested resource was not found.","details":{}}}}},"exampleType":"examples"}},"exampleType":"examples"},"7c536b05-d0f2-4d36-942b-df214b028734":{"description":"The authenticated account is not configured for this product.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"account_not_configured","message":"Account is not configured for proxy products.","details":{}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"account_not_configured","message":"Account is not configured for proxy products.","details":{}}}}},"exampleType":"examples"}},"exampleType":"examples"},"add59130-ba44-41dc-a546-443f43b8bd3a":{"description":"An unexpected server error occurred.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"internal_error","message":"Internal Server Error","details":{}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"internal_error","message":"Internal Server Error","details":{}}}}},"exampleType":"examples"}},"exampleType":"examples"},"8e4f086a-ef93-4d8b-b53d-306338d5c0d2":{"description":"An upstream service failed while processing the request.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized","forbidden","invalid_request","insufficient_balance","account_not_configured","not_found","settings_in_use","settings_limit_reached","session_not_active","connection_in_use","upstream_error","internal_error"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"Invalid request parameters.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","properties":{"target":{"example":"settings.id","type":"string","uniqueKey":"error.details.target","typeLabel":"string"},"recoveryHint":{"example":"Stop the active session before reusing these settings.","type":"string","uniqueKey":"error.details.recoveryHint","typeLabel":"string"},"activeSessionId":{"example":"58e531ee-16ca-49d0-8722-b425d154cc10","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"error.details.activeSessionId","typeLabel":"string\u003cuuid>"},"nextOperationId":{"example":"stopBrowserSession","type":"string","uniqueKey":"error.details.nextOperationId","typeLabel":"string"},"requestId":{"example":"a1901a29e82a999f-CDG","type":"string","uniqueKey":"error.details.requestId","typeLabel":"string"},"upstreamStatus":{"example":503,"type":"integer","minimum":100,"maximum":599,"uniqueKey":"error.details.upstreamStatus","typeLabel":"integer"},"failureStage":{"example":"provider_browser_start","type":"string","uniqueKey":"error.details.failureStage","typeLabel":"string"},"diagnosticCode":{"example":"token_sign_failed","type":"string","uniqueKey":"error.details.diagnosticCode","typeLabel":"string"}},"additionalProperties":{"oneOf":[{}],"uniqueKey":"error.details.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"upstream_error","message":"Failed to fetch data from an upstream service.","details":{"upstreamStatus":503}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"upstream_error","message":"Failed to fetch data from an upstream service.","details":{"upstreamStatus":503}}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"af1e0e9b-cfa3-42c1-ab39-d4abb4facf41":{"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"Client API key for the authenticated account.","scopes":[]}}},"servers":{"5a416e7f-7912-470a-86f6-f1cfb9117df7":{"url":"https://api.floppydata.net","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"Client API key for the authenticated account.","scopes":[]},"schema":{"title":"X-Api-Key","type":"string","description":"Client API key for the authenticated account.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyHeader","name":"X-Api-Key"}],"title":"apiKeyHeader"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"floppydata","siteName":"Floppydata Client API","title":"Search - Floppydata Client API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-20T16:31:01.848Z","originalFileLocation":"api-reference/v2/endpoint/web-data-search.mdx"},"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=\"system\"}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=\"Searches the public web and returns lightweight organic results in ranking order. One successful search consumes one Web Data request. Use this to discover relevant pages; use fetchWebData when you already have a URL and need its HTML. AI overviews, related questions, and location controls are not included.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Floppydata Client API\">\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/floppydata/JO5OYhPSPV8YsrHU/_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/floppydata/JO5OYhPSPV8YsrHU/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/floppydata/JO5OYhPSPV8YsrHU/_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/floppydata/JO5OYhPSPV8YsrHU/_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/floppydata/JO5OYhPSPV8YsrHU/_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/floppydata/JO5OYhPSPV8YsrHU/_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/floppydata/JO5OYhPSPV8YsrHU/_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/floppydata/JO5OYhPSPV8YsrHU/_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/floppydata/JO5OYhPSPV8YsrHU/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Search - Floppydata Client API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Searches the public web and returns lightweight organic results in ranking order. One successful search consumes one Web Data request. Use this to discover relevant pages; use fetchWebData when you already have a URL and need its HTML. AI overviews, related questions, and location controls are not included.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Floppydata Client API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://floppydata.com/docs/api-reference/v2/endpoint/web-data-search\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://floppydata.mintlify.site/docs/_mintlify/api/og/v2?division=Web+Data\u0026amp;title=Search\u0026amp;description=Searches+the+public+web+and+returns+lightweight+organic+results+in+ranking+order.+One+successful+search+consumes+one+Web+Data+request.+Use+this+to+discover+rele\u0026amp;theme=1fa247ce104f288b8b83ea72\u0026amp;signature=a275f008c3e1dfed9c95a848395253c27e87440b1c4a046ecf227f94db9e743f\">\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=\"Search - Floppydata Client API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Searches the public web and returns lightweight organic results in ranking order. One successful search consumes one Web Data request. Use this to discover relevant pages; use fetchWebData when you already have a URL and need its HTML. AI overviews, related questions, and location controls are not included.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://floppydata.mintlify.site/docs/_mintlify/api/og/v2?division=Web+Data\u0026amp;title=Search\u0026amp;description=Searches+the+public+web+and+returns+lightweight+organic+results+in+ranking+order.+One+successful+search+consumes+one+Web+Data+request.+Use+this+to+discover+rele\u0026amp;theme=1fa247ce104f288b8b83ea72\u0026amp;signature=a275f008c3e1dfed9c95a848395253c27e87440b1c4a046ecf227f94db9e743f\">\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/floppydata/JO5OYhPSPV8YsrHU/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Floppydata Client API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://floppydata.com/docs/api-reference/v2/endpoint/web-data-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/v2/endpoint/web-data-search.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://floppydata.com/#organization\",\"name\":\"Floppydata Client API\",\"url\":\"https://floppydata.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/floppydata/t-In33JhdHge9jll/logo/light.svg?fit=max\u0026auto=format\u0026n=t-In33JhdHge9jll\u0026q=85\u0026s=2b3535dc315190c13602ee83ea3378c2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://floppydata.com/docs#website\",\"name\":\"Floppydata Client API\",\"url\":\"https://floppydata.com/docs\",\"publisher\":{\"@id\":\"https://floppydata.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://floppydata.com/docs/api-reference/v2/endpoint/web-data-search#webpage\",\"url\":\"https://floppydata.com/docs/api-reference/v2/endpoint/web-data-search\",\"name\":\"Search\",\"description\":\"Searches the public web and returns lightweight organic results in ranking order. One successful search consumes one Web Data request. Use this to discover relevant pages; use fetchWebData when you already have a URL and need its HTML. AI overviews, related questions, and location controls are not included.\",\"dateModified\":\"2026-07-20T16:31:01.848Z\",\"isPartOf\":{\"@id\":\"https://floppydata.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://floppydata.com/docs/api-reference/v2/endpoint/web-data-search#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://floppydata.com/docs/api-reference/v2/endpoint/web-data-search#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Floppydata Client API\",\"item\":\"https://floppydata.com/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Search\",\"item\":\"https://floppydata.com/docs/api-reference/v2/endpoint/web-data-search\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://floppydata.com/docs/api-reference/v2/endpoint/web-data-search#apireference\",\"headline\":\"Search\",\"name\":\"Search\",\"description\":\"Searches the public web and returns lightweight organic results in ranking order. One successful search consumes one Web Data request. Use this to discover relevant pages; use fetchWebData when you already have a URL and need its HTML. AI overviews, related questions, and location controls are not included.\",\"url\":\"https://floppydata.com/docs/api-reference/v2/endpoint/web-data-search\",\"mainEntityOfPage\":{\"@id\":\"https://floppydata.com/docs/api-reference/v2/endpoint/web-data-search#webpage\"},\"dateModified\":\"2026-07-20T16:31:01.848Z\",\"publisher\":{\"@id\":\"https://floppydata.com/#organization\"},\"isPartOf\":{\"@id\":\"https://floppydata.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Floppydata Client API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Floppydata Client API","nav":{"global":null,"tabs":[{"tab":"Start","pages":[{"title":"Start","href":"/overview"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/web-data"}]},{"tab":"API Reference","groups":[{"group":"Overview","root":{"title":"API Reference","description":"OpenAPI-generated reference for Client API v2.","href":"/api-reference/introduction"},"pages":[]},{"group":"V2","pages":[{"group":"Web Data","expanded":true,"pages":[{"title":"Search","openapi":"api-reference/openapi.json POST /v2/web-data/search","href":"/api-reference/v2/endpoint/web-data-search"},{"title":"Fetch","openapi":"api-reference/openapi.json POST /v2/web-data/fetch","description":"Fetches a target page through Web Data and returns the fetched HTML. Upstream scrape failures return structured v2 JSON errors with message \"Failed to scrape the URL\" and safe metadata only. Use this for page retrieval. Do not use it for usage reporting; use getWebDataUsage or getAccountUsage instead.","href":"/api-reference/v2/endpoint/web-data-fetch"},{"title":"Balance","openapi":"api-reference/openapi.json GET /v2/web-data/balance","href":"/api-reference/v2/endpoint/web-data-balance"},{"title":"Usage","openapi":"api-reference/openapi.json GET /v2/web-data/usage","href":"/api-reference/v2/endpoint/web-data-usage"}]},{"group":"Cloud Browser","expanded":true,"pages":[{"title":"Create a Session","openapi":"api-reference/openapi.json POST /v2/browser/sessions","href":"/api-reference/v2/endpoint/browser-session-create"},{"title":"Connect to a Session","openapi":"api-reference/openapi.json GET /v2/browser/sessions/{sessionId}/connect","href":"/api-reference/v2/endpoint/browser-session-connect"},{"title":"Get a Session","openapi":"api-reference/openapi.json GET /v2/browser/sessions/{sessionId}","href":"/api-reference/v2/endpoint/browser-session-get"},{"title":"List Sessions","openapi":"api-reference/openapi.json GET /v2/browser/sessions","href":"/api-reference/v2/endpoint/browser-session-list"},{"title":"Create a Live View","openapi":"api-reference/openapi.json POST /v2/browser/sessions/{sessionId}/live-view","href":"/api-reference/v2/endpoint/browser-session-live-view"},{"title":"Stop a Session","openapi":"api-reference/openapi.json POST /v2/browser/sessions/{sessionId}/stop","href":"/api-reference/v2/endpoint/browser-session-stop"},{"title":"Delete Saved Settings","openapi":"api-reference/openapi.json DELETE /v2/browser/settings/{settingsId}","href":"/api-reference/v2/endpoint/browser-settings-delete"}]},{"group":"Proxy","expanded":true,"pages":[{"group":"Rotating","expanded":true,"pages":[{"title":"Connections","openapi":"api-reference/openapi.json POST /v2/proxy/rotating/connections","href":"/api-reference/v2/endpoint/rotating-connection"},{"title":"List Subusers","openapi":"api-reference/openapi.json GET /v2/proxy/rotating/subusers","href":"/api-reference/v2/endpoint/rotating-subusers-list"},{"title":"Create a Subuser","openapi":"api-reference/openapi.json POST /v2/proxy/rotating/subusers","href":"/api-reference/v2/endpoint/rotating-subusers-create"},{"title":"Delete a Subuser","openapi":"api-reference/openapi.json DELETE /v2/proxy/rotating/subusers/{subuserId}","href":"/api-reference/v2/endpoint/rotating-subusers-delete"},{"title":"Locations","openapi":"api-reference/openapi.json GET /v2/proxy/rotating/locations","href":"/api-reference/v2/endpoint/rotating-locations"},{"title":"Balance","openapi":"api-reference/openapi.json GET /v2/proxy/rotating/balance","href":"/api-reference/v2/endpoint/rotating-balance"},{"title":"Usage","openapi":"api-reference/openapi.json GET /v2/proxy/rotating/usage","href":"/api-reference/v2/endpoint/rotating-usage"}]},{"group":"Static","expanded":true,"pages":[{"title":"List Proxies","openapi":"api-reference/openapi.json GET /v2/proxy/static","href":"/api-reference/v2/endpoint/static-proxies"}]},{"title":"Check Proxy","openapi":"api-reference/openapi.json POST /v2/proxy/check","href":"/api-reference/v2/endpoint/check-proxy"}]},{"group":"Account","expanded":true,"pages":[{"title":"Balances","openapi":"api-reference/openapi.json GET /v2/account/balances","href":"/api-reference/v2/endpoint/account-balances"},{"title":"Usage","openapi":"api-reference/openapi.json GET /v2/account/usage","href":"/api-reference/v2/endpoint/account-usage"}]}]}]},{"tab":"Legacy v1","pages":[{"title":"Legacy v1","href":"/legacy-v1"}]}]},"basePath":"","title":"Search - Floppydata Client API","buildId":"dpl_6dVqRXFR2Go5vF5RLvAdHuv189oT","deploymentId":"dpl_6dVqRXFR2Go5vF5RLvAdHuv189oT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-D_7my4bd.js","utils-Cq_itTNA.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B5KPEvGz.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DBX-JepP.js","snippetPresets-Bsspz-Ge.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-jcs-2nGf.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Dp53in7F.js","shallow-Dv9eUdUd.js","getApiPlaygroundDisplay-D8cDwNhi.js","CodeSnippet-DkwXLQor.js","CodeSnippets-DcSgKqs5.js","Page-t8ynOKTD.js","getPastedJson-I2RjoApV.js","icon-BIj57rZC.js","MethodPill-CTwLPWXC.js","DuplicateIcon-BJpFwygY.js","createIcon-C7PorfAe.js","DynamicMarkdown-BBht_uEs.js","SectionHeading-YIBwxbzj.js","axios-vUo_bRtp.js","Markdown--YCeFtOs.js","clsx-CrPa459s.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BWxsj3I0.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fBzVvq7k.js"]}