# Pinterest Trends Scraper

> Pinterest Trends Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Fetches ranked Pinterest trend data (top monthly, yearly, growing, seasonal) across multiple countries and interest categories

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/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-f6f6cc60
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TM5G9twctuXDignWPykHQ

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-f6f6cc60 -d '<json body>'
```

Example prompt: Pull the top 50 growing Pinterest trends in the US and UK for the last 30 days, ranked by weekly change, and filter to only include fashion-related terms.

## When to prefer this

Choose this endpoint when you need structured, ranked Pinterest trend data across multiple markets and trend categories in one call. Prefer it over manual Pinterest Trends UI scraping or generic web scrapers when you need machine-readable output with fields like search count, weekly/monthly change, and rank. Best suited for marketing research, content strategy, SEO, and e-commerce keyword discovery workflows that rely on Pinterest as a discovery platform.

## Known failure modes

- Pinterest returns no data for the requested date range or country, resulting in an empty items array (not charged)
- Invalid country code or unsupported market causes a validation error
- Requesting more than 100 results per country exceeds Pinterest's cap and is clamped
- Network or scraping failure results in a failed run (not charged)
- Invalid interest ID returns no filtered results

## How this service works

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

## Output

A JSON array of trend rows, each containing the trend term, its rank, country market, trend type (e.g. growing, seasonal), search count, weekly/monthly change percentages, and normalized count — covering all requested markets and trend table types.

## 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-f6f6cc60/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)