# Pinterest Ads Repository Scraper

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

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

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/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-scraper-a58fba06
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uys0BOWPa_HY3ww6Zl_OZ

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

Example prompt: Pull up to 50 Pinterest ads from Germany in the TRAVEL category targeting FEMALE users aged 25-34, going back 60 days — I want to see what travel advertisers are running there.

## When to prefer this

Use this endpoint when you need structured, filterable access to Pinterest's public ad repository without building your own scraper. Ideal for competitive ad research, creative benchmarking, and market monitoring across specific European, Brazilian, or Turkish markets. Prefer this over generic web scrapers when you need normalized ad fields (image, video, title, advertiser) and want cost efficiency since failed/empty calls aren't billed.

## Known failure modes

- No ads found matching filters — returns empty items array (not charged)
- Invalid date format causes request failure
- Country code not in supported enum causes validation error
- Scraper blocked or rate-limited by Pinterest — returns error or empty result (not charged)
- maxResults of 0 may return very large result sets causing timeouts

## How this service works

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

## Output

A JSON object containing a count of returned ads and an array of ad items, each with fields for ad ID, URL, title, domain, image URL, video URL, description, and advertiser name. Only ads matching all specified filters are returned. Failed or empty runs are not charged.

## 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-scraper-a58fba06/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)