# Pinterest Ads Repository Search

> Pinterest Ads Repository Search 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).

Searches Pinterest's public ad repository and returns structured ad data filtered by country, category, age, gender, date range, and advertiser name.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/pinterest-ads?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-ads-repository-search-2da60ecb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ICYjdVuyRU29qSRxU5YAj

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-ads-repository-search-2da60ecb -d '<json body>'
```

Example prompt: Can you pull the last 60 days of Pinterest ads in the TRAVEL category from France, targeting women aged 25-34, and give me up to 50 results? I want to see what advertisers are running there.

## When to prefer this

Choose this endpoint when you need structured, filterable access to Pinterest's public ad repository — especially for competitive intelligence, market research, or ad creative benchmarking across specific countries, demographics, and categories. It is particularly useful when you need historical ad data going back up to 365 days or want to filter by advertiser name.

## Known failure modes

- No ads found matching the filters — returns empty items array (not charged)
- Invalid date format for startDate/endDate — request rejected
- Unsupported country code provided — enum validation error
- Rate limiting or upstream Pinterest repository unavailability — service error
- Invalid category or gender enum value — schema validation failure

## How this service works

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

## Output

Returns a JSON object with a count of matched ads and an array of ad items, each containing the ad's ID, URL, title, domain, image URL, video URL, description, and advertiser name. Failed or empty runs are not billed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "age": {
   "enum": [
    "ALL",
    "AGE_18_24",
    "AGE_25_34",
    "AGE_35_44",
    "AGE_45_49",
    "AGE_50_54",
    "AGE_55_64",
    "AGE_65_PLUS"
   ],
   "type": "string",
   "default": "ALL",
   "description": "Target age filter; ALL includes every group."
  },
  "gender": {
   "enum": [
    "ALL",
    "MALE",
    "FEMALE",
    "UNSPECIFIED"
   ],
   "type": "string",
   "default": "ALL",
   "description": "Target gender filter; ALL includes every group."
  },
  "country": {
   "enum": [
    "AT",
    "BE",
    "BG",
    "HR",
    "CY",
    "CZ",
    "DK",
    "EE",
    "FI",
    "FR",
    "DE",
    "GR",
    "HU",
    "IE",
    "IT",
    "LV",
    "LT",
    "LU",
    "MT",
    "NL",
    "PL",
    "PT",
    "RO",
    "SK",
    "SI",
    "ES",
    "SE",
    "BR",
    "TR"
   ],
   "type": "string",
   "default": "DE",
   "description": "Country whose public ad repository results to search."
  },
  "endDate": {
   "type": "string",
   "description": "Last date to search, as YYYY-MM-DD or a relative value such as 1 day. Empty means today."
  },
  "category": {
   "enum": [
    "ALL",
    "ANIMALS",
    "ARCHITECTURE",
    "ART",
    "BEAUTY",
    "CHILDRENS_FASHION",
    "DESIGN",
    "DIY_AND_CRAFTS",
    "EDUCATION",
    "ELECTRONICS",
    "ENTERTAINMENT",
    "EVENT_PLANNING",
    "FINANCE",
    "FOOD_AND_DRINKS",
    "HEALTH",
    "HOME_DECOR",
    "GARDENING",
    "MENS_FASHION",
    "PARENTING",
    "QUOTES",
    "SPORT",
    "TRAVEL",
    "VEHICLES",
    "WEDDING",
    "WOMENS_FASHION",
    "OTHER"
   ],
   "type": "string",
   "default": "ALL",
   "description": "Ad category; ALL includes every category."
  },
  "startDate": {
   "type": "string",
   "default": "30 days",
   "description": "First date to search, as YYYY-MM-DD or a relative value such as 7 days. Searches can go back 365 days."
  },
  "maxResults": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Stop after this many unique ads. Zero removes the output cap."
  },
  "advertiserName": {
   "type": "string",
   "description": "Filter repository results by advertiser name."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "id": null,
    "url": null,
    "title": null,
    "domain": null,
    "imageUrl": null,
    "videoUrl": null,
    "description": null,
    "advertiserName": null
   }
  ],
  "product": "pinterest-ads"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pinterest-ads-repository-search-2da60ecb/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)