Search the web with Web Data
curl --request POST \
--url https://api.floppydata.net/v2/web-data/search \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"query": "browser automation"
}
'import requests
url = "https://api.floppydata.net/v2/web-data/search"
payload = { "query": "browser automation" }
headers = {
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({query: 'browser automation'})
};
fetch('https://api.floppydata.net/v2/web-data/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"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."
}
]
}{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters.",
"details": {
"issues": [
{
"path": "countryCode",
"code": "invalid_format",
"message": "Expected a 2-letter country code."
}
]
}
}
}{
"error": {
"code": "unauthorized",
"message": "Unauthorized",
"details": {}
}
}{
"error": {
"code": "insufficient_balance",
"message": "Insufficient proxy traffic balance.",
"details": {}
}
}{
"error": {
"code": "forbidden",
"message": "Forbidden",
"details": {}
}
}{
"error": {
"code": "not_found",
"message": "Requested resource was not found.",
"details": {}
}
}{
"error": {
"code": "account_not_configured",
"message": "Account is not configured for proxy products.",
"details": {}
}
}{
"error": {
"code": "internal_error",
"message": "Internal Server Error",
"details": {}
}
}{
"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.
POST
https://api.floppydata.net
/
v2
/
web-data
/
search
Search the web with Web Data
curl --request POST \
--url https://api.floppydata.net/v2/web-data/search \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"query": "browser automation"
}
'import requests
url = "https://api.floppydata.net/v2/web-data/search"
payload = { "query": "browser automation" }
headers = {
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({query: 'browser automation'})
};
fetch('https://api.floppydata.net/v2/web-data/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"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."
}
]
}{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters.",
"details": {
"issues": [
{
"path": "countryCode",
"code": "invalid_format",
"message": "Expected a 2-letter country code."
}
]
}
}
}{
"error": {
"code": "unauthorized",
"message": "Unauthorized",
"details": {}
}
}{
"error": {
"code": "insufficient_balance",
"message": "Insufficient proxy traffic balance.",
"details": {}
}
}{
"error": {
"code": "forbidden",
"message": "Forbidden",
"details": {}
}
}{
"error": {
"code": "not_found",
"message": "Requested resource was not found.",
"details": {}
}
}{
"error": {
"code": "account_not_configured",
"message": "Account is not configured for proxy products.",
"details": {}
}
}{
"error": {
"code": "internal_error",
"message": "Internal Server Error",
"details": {}
}
}{
"error": {
"code": "upstream_error",
"message": "Failed to fetch data from an upstream service.",
"details": {
"upstreamStatus": 503
}
}
}This playground sends real production requests. Each successful search consumes one Web Data request.
Results come from Google Search. The search engine is fixed; this endpoint does not accept an engine selector.
Authorizations
Client API key for the authenticated account.
Body
application/json
Response
Normalized organic search results.
Unique identifier for this search request.
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)$Normalized search query.
Minimum string length:
1Organic results in provider ranking order.
Show child attributes
Show child attributes
Was this page helpful?