# Pinterest Trends Scraper (x402)

> Pinterest Trends Scraper (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Fetches structured Pinterest trend data — top monthly, yearly, growing, or seasonal keywords — across multiple countries and interest categories.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/pinterest-trends?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pinterest-trends-scraper-x402-a8465525
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3xHrcalOq1JDDfA_YRqnC

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability pinterest-trends-scraper-x402-a8465525 -d '<json body>'
```

Example prompt: Pull the top 50 growing Pinterest trends in the US and Canada for the last 30 days, filtered to beauty-related interests, and rank them by monthly change.

## When to prefer this

Use this endpoint when you need structured, filterable Pinterest trend data across multiple countries and interest categories with flexible ranking options. Prefer this over manual Pinterest Trends browsing when you need programmatic access, multi-country batch queries, or keyword filtering. The pay-per-call model with no charge for empty results makes it low-risk for exploratory queries.

## Known failure modes

- Empty result set if keywords to include don't match any Pinterest trends (not charged)
- Invalid country code returns validation error
- End date beyond Pinterest's available data range may return latest available data instead
- Interest ID not recognized by Pinterest returns empty rows
- Rate limiting or payment failure results in 402 response without data charge

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON array of trend rows, each containing the keyword term, its rank, country, trend type (growing/seasonal/top_monthly/top_yearly), raw search count, weekly/monthly change percentages, and a normalized popularity count. Results are grouped by market and trend type.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "endDate": {
   "type": "string",
   "description": "Requested end date in YYYY-MM-DD format. Empty uses today; Pinterest may return its latest available data date."
  },
  "maxItems": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Stop after this many rows across all tables. Zero means no total cap."
  },
  "countries": {
   "type": "array",
   "items": {
    "enum": [
     "US",
     "CA",
     "GB+IE",
     "DE",
     "FR",
     "IT",
     "ES",
     "MX",
     "BR",
     "AU+NZ",
     "AR",
     "CO",
     "IN",
     "ID",
     "MY",
     "PH",
     "TH",
     "SA",
     "EG",
     "TR",
     "KR",
     "AT",
     "CH",
     "PT",
     "GR",
     "MT",
     "SE",
     "DK",
     "FI",
     "NO",
     "NL",
     "BE",
     "LU",
     "PL",
     "RO",
     "HU",
     "SK",
     "CZ",
     "CL",
     "AE",
     "KW",
     "QA",
     "OM",
     "BH",
     "IQ",
     "DZ",
     "IL",
     "NG",
     "PK",
     "ZA",
     "MA",
     "CR",
     "DO",
     "EC",
     "GT",
     "PE",
     "CY"
    ],
    "type": "string"
   },
   "default": [
    "US"
   ],
   "description": "Markets to query. Some countries resolve to a grouped Pinterest Trends region."
  },
  "trendTypes": {
   "type": "array",
   "items": {
    "enum": [
     "top_monthly",
     "top_yearly",
     "growing",
     "seasonal"
    ],
    "type": "string",
    "enumTitles": [
     "Top monthly",
     "Top yearly",
     "Growing",
     "Seasonal"
    ]
   },
   "default": [
    "growing"
   ],
   "description": "One or more ranked tables to collect per market."
  },
  "interestIds": {
   "type": "array",
   "default": [],
   "description": "Optional Pinterest top-level interest IDs, such as 935541271955 for beauty."
  },
  "rankingMethod": {
   "enum": [
    "TREND_RANK",
    "TOTAL_SEARCH",
    "WEEKLY_CHANGE",
    "MONTHLY_CHANGE",
    "YEARLY_CHANGE"
   ],
   "type": "string",
   "description": "Optional metric used to rank filtered trend rows."
  },
  "lookbackWindow": {
   "enum": [
    "7D",
    "30D",
    "90D",
    "180D",
    "365D"
   ],
   "type": "string",
   "default": "30D",
   "description": "Time range used for trend calculations."
  },
  "keywordsToExclude": {
   "type": "array",
   "default": [],
   "description": "Remove trends matching these terms."
  },
  "keywordsToInclude": {
   "type": "array",
   "default": [],
   "description": "Only return trends matching these terms. Leave empty for all topics."
  }
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "rank": null,
    "term": null,
    "country": null,
    "trendType": null,
    "searchCount": null,
    "weeklyChange": null,
    "monthlyChange": null,
    "normalizedCount": null
   }
  ],
  "product": "pinterest-trends"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pinterest-trends-scraper-x402-a8465525/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)