JSON POST request example
POST to https://api.litescrape.com/api/google/trends with Content-Type: application/json and your Authorization: Bearer header.
{
"limit": 2
}// request reference
Google Trending Searches parameters
Send query parameters with GET /api/google/trends. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.
POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.
Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.
Request parameters
geoTwo-letter country code in uppercase.
Type string · GET query or POST JSON · Default US
- Pattern: ^[A-Z]{2}$
limitMaximum currently trending searches to return.
Type integer · GET query or POST JSON · Default 10
Example / input hint: 2
- Minimum: 1
- Maximum: 100
// response
Work with the complete JSON response
Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.
Response groups include search_parameters, trends, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.
Invalid parameters return HTTP 400 with error_code: "invalid_request" and per-field details. Unavailable resources return HTTP 404 with error_code: "not_found". Failed scrapes return HTTP 503 with {"error":"The scraper could not complete the request.","error_code":"service_unavailable"}. Failed requests are not billed.
Illustrative success response. Result groups and optional fields depend on upstream content.
{
"search_parameters": {
"geo": "US",
"limit": 2
},
"trends": [
{
"query": "taylor swift",
"traffic": "200+",
"started_at": "Fri, 23 Oct 2026 00:50:00 -0700",
"articles": [
{
"title": "Taylor Swift's Self-Titled Debut Turns 20",
"link": "https://stereogum.com/2514834/taylor-swift-turns-20/reviews/the-anniversary",
"published_at": null,
"source": "Stereogum",
"source_url": null
},
{
"title": "20 years of feeling 22: Ranking the Taylor Swift albums that will live evermore",
"link": "https://dailybruin.com/2026/10/22/20-years-of-feeling-22-ranking-the-taylor-swift-albums-that-will-live-evermore",
"published_at": null,
"source": "Daily Bruin",
"source_url": null
},
{
"title": "Taylor Swift's Debut Album Turns 20 Next Week—and Fans Are Still Waiting for One Major Announcement",
"link": "https://parade.com/news/taylor-swifts-debut-album-turns-20-next-week-and-fans-are-still-waiting-for-one-major-announcement",
"published_at": null,
"source": "Parade Magazine",
"source_url": null
}
]
},
{
"query": "openai",
"traffic": "200+",
"started_at": "Fri, 23 Oct 2026 00:50:00 -0700",
"articles": [
{
"title": "OpenAI trims valuation target to $1.25tn after pitching higher price",
"link": "https://www.ft.com/content/bb564eb1-79d4-4694-aa24-1155202a9abc?syn-25a6b1a6=1",
"published_at": null,
"source": "Financial Times",
"source_url": null
},
{
"title": "OpenAI nears up to $30 billion funding round at $1.25 trillion valuation led by UAE investors",
"link": "https://www.cnbc.com/2026/10/22/openai-funding-round-uae-investors.html",
"published_at": null,
"source": "CNBC",
"source_url": null
},
{
"title": "EXCLUSIVE: OpenAI seeks to accelerate fundraising ahead of Anthropic IPO, sources say",
"link": "https://www.reuters.com/world/openai-seeks-accelerate-fundraising-ahead-anthropic-ipo-sources-say-2026-10-19/",
"published_at": null,
"source": "Reuters",
"source_url": null
}
]
}
],
"submit_feedback_for_this_response_here": "https://api.litescrape.com/api/feedback/example-not-a-valid-token"
}