---
title: "Trends Search"
method: POST
path: "/search/trends"
tags: ["Search"]
---

# Trends Search

`POST /search/trends`

## Request

- Base URL: `https://api.weblens.dev`
- URL: `https://api.weblens.dev/search/trends`
- Auth: API key in header `Payment-Signature`

Google Trends interest over time for a topic, worldwide: a timeline of relative search interest per period (0-100, where 100 is the topic's peak). Use it to see whether interest in a product, technology, brand or keyword is rising, falling or seasonal. Price: $0.04.

## Request body

- object
  - `query` string, required: Topic to get trend data for

## Response `200`

Interest-over-time timeline for a topic.

- object
  - `query` string
  - `timeline` object[]: Interest-over-time points with date, timestamp, values[{query, value}]
    - `date` string
    - `timestamp` string
    - `values` object[]
  - `searchedAt` string
  - `requestId` string

## Other responses

- `400`: The body failed validation
- `402`: Payment required — x402 v2 protocol. Parse the PAYMENT-REQUIRED response header (base64-encoded JSON), sign the payment with your wallet, then retry the request with the Payment-Signature request header.

---

[API](https://skmtc.dev/weblens/apis/weblens-api.md) · [All operations](https://skmtc.dev/weblens/apis/weblens-api/llms.txt) · [OpenAPI document](https://skmtc.dev/weblens/apis/weblens-api/revisions/63a7e81b6921?raw)