{
  "description": "Collect public Pinterest trending searches, keyword history and supporting trend content by market.",
  "properties": {
    "ageGroup": {
      "default": "all",
      "description": "Pinterest audience age filter for trending searches and keyword research.",
      "editor": "select",
      "enum": [
        "all",
        "18-20",
        "18-24",
        "21-24",
        "25-34",
        "35-44",
        "45-49",
        "50-54",
        "55-64",
        "65+"
      ],
      "enumTitles": [
        "All ages",
        "18-20",
        "18-24",
        "21-24",
        "25-34",
        "35-44",
        "45-49",
        "50-54",
        "55-64",
        "65+"
      ],
      "prefill": "all",
      "title": "Audience age",
      "type": "string"
    },
    "categoryNames": {
      "default": [],
      "description": "Exact Pinterest shopping category names for metrics, such as `Sofas` or `Wedding dress` (mode=shoppingMetrics). Leave empty to use Pinterest's featured level-2 categories.",
      "editor": "stringList",
      "prefill": [],
      "title": "Shopping category names",
      "type": "array"
    },
    "days": {
      "default": 90,
      "description": "History length in days for keyword research and shopping metrics.",
      "maximum": 730,
      "minimum": 30,
      "prefill": 90,
      "title": "History window",
      "type": "integer"
    },
    "endDate": {
      "description": "Historical end date in `YYYY-MM-DD` format. Leave empty for Pinterest's latest available date (mode=trendingSearches, keywordResearch, shoppingCategories, shoppingMetrics).",
      "editor": "textfield",
      "title": "End date",
      "type": "string"
    },
    "gender": {
      "default": "all",
      "description": "Pinterest audience gender filter for trending searches and keyword research.",
      "editor": "select",
      "enum": [
        "all",
        "female",
        "male",
        "unspecified"
      ],
      "enumTitles": [
        "All genders",
        "Female",
        "Male",
        "Unspecified"
      ],
      "prefill": "all",
      "title": "Audience gender",
      "type": "string"
    },
    "includeAudience": {
      "default": false,
      "description": "Add age and gender distributions for each keyword (mode=keywordResearch).",
      "prefill": false,
      "title": "Include audience demographics",
      "type": "boolean"
    },
    "includeImages": {
      "default": false,
      "description": "Add a representative Pinterest image for each keyword (mode=keywordResearch).",
      "prefill": false,
      "title": "Include images",
      "type": "boolean"
    },
    "includeRelated": {
      "default": false,
      "description": "Add Pinterest's related terms and their weekly history for each keyword (mode=keywordResearch).",
      "prefill": false,
      "title": "Include related terms",
      "type": "boolean"
    },
    "includeSuggestions": {
      "default": false,
      "description": "Add Pinterest search suggestions for each keyword (mode=keywordResearch).",
      "prefill": false,
      "title": "Include search suggestions",
      "type": "boolean"
    },
    "includeTopCategories": {
      "default": false,
      "description": "Add Pinterest's fastest-growing shopping categories with related searches (mode=shoppingCategories).",
      "prefill": false,
      "title": "Include ranked shopping categories",
      "type": "boolean"
    },
    "interest": {
      "default": "all",
      "description": "Pinterest interest filter for trending searches (mode=trendingSearches).",
      "editor": "select",
      "enum": [
        "all",
        "Food and drinks",
        "Beauty",
        "Home decor",
        "Fashion",
        "Men's fashion",
        "Children's fashion",
        "Travel",
        "Art",
        "Quotes",
        "Entertainment",
        "DIY and crafts",
        "Health",
        "Wedding",
        "Event planning",
        "Gardening",
        "Animals",
        "Parenting",
        "Education",
        "Vehicles",
        "Design",
        "Sport",
        "Electronics",
        "Finance",
        "Architecture"
      ],
      "enumTitles": [
        "All interests",
        "Food and drinks",
        "Beauty",
        "Home decor",
        "Fashion",
        "Men's fashion",
        "Children's fashion",
        "Travel",
        "Art",
        "Quotes",
        "Entertainment",
        "DIY and crafts",
        "Health",
        "Wedding",
        "Event planning",
        "Gardening",
        "Animals",
        "Parenting",
        "Education",
        "Vehicles",
        "Design",
        "Sport",
        "Electronics",
        "Finance",
        "Architecture"
      ],
      "prefill": "all",
      "title": "Interest category",
      "type": "string"
    },
    "keywords": {
      "default": [],
      "description": "Terms to research (mode=keywordResearch). Leave empty to use Pinterest's current top trending searches.",
      "editor": "stringList",
      "prefill": [],
      "title": "Keywords",
      "type": "array"
    },
    "keywordsToExclude": {
      "default": [],
      "description": "Drop trending searches containing any of these words (mode=trendingSearches).",
      "editor": "stringList",
      "prefill": [],
      "title": "Exclude keywords",
      "type": "array"
    },
    "keywordsToInclude": {
      "default": [],
      "description": "Only keep trending searches containing at least one of these words (mode=trendingSearches).",
      "editor": "stringList",
      "prefill": [],
      "title": "Include keywords",
      "type": "array"
    },
    "lookbackWindow": {
      "default": "30D",
      "description": "Comparison window used by Pinterest for trending searches (mode=trendingSearches).",
      "editor": "select",
      "enum": [
        "7D",
        "30D",
        "90D",
        "180D",
        "365D"
      ],
      "enumTitles": [
        "7 days",
        "30 days",
        "90 days",
        "180 days",
        "365 days"
      ],
      "prefill": "30D",
      "title": "Lookback window",
      "type": "string"
    },
    "maxItems": {
      "default": 100,
      "description": "Maximum records to return. Trending lists are partitioned by interest to go beyond Pinterest's 100-term list ceiling.",
      "maximum": 10000,
      "minimum": 1,
      "prefill": 3,
      "title": "Maximum records",
      "type": "integer"
    },
    "mode": {
      "default": "trendingSearches",
      "description": "Choose a Pinterest Trends dataset.",
      "editor": "select",
      "enum": [
        "trendingSearches",
        "keywordResearch",
        "featuredTopics",
        "editorialStories",
        "shoppingCategories",
        "shoppingMetrics",
        "moments",
        "featured",
        "editorial"
      ],
      "enumTitles": [
        "Trending searches",
        "Keyword research",
        "Featured topics",
        "Editorial stories",
        "Shopping categories",
        "Shopping category metrics",
        "Seasonal moments",
        "Featured topics (legacy, mapped)",
        "Editorial stories (legacy, mapped)"
      ],
      "prefill": "trendingSearches",
      "title": "What to collect",
      "type": "string"
    },
    "moment": {
      "default": "all",
      "description": "Pinterest seasonal moment filter for trending searches (mode=trendingSearches).",
      "editor": "select",
      "enum": [
        "all",
        "thanksgiving",
        "valentines day",
        "independence day",
        "memorial day",
        "fathers day",
        "hanukkah",
        "new years eve",
        "easter",
        "st patricks day",
        "summer",
        "christmas",
        "mothers day",
        "halloween"
      ],
      "enumTitles": [
        "All moments",
        "Thanksgiving",
        "Valentine's Day",
        "Independence Day",
        "Memorial Day",
        "Father's Day",
        "Hanukkah",
        "New Year's Eve",
        "Easter",
        "St Patrick's Day",
        "Summer",
        "Christmas",
        "Mother's Day",
        "Halloween"
      ],
      "prefill": "all",
      "title": "Seasonal moment",
      "type": "string"
    },
    "predictedDays": {
      "default": 0,
      "description": "Pinterest forecast horizon. Forecasts are published for the US only (mode=keywordResearch, shoppingMetrics).",
      "maximum": 28,
      "minimum": 0,
      "prefill": 0,
      "title": "Forecast days",
      "type": "integer"
    },
    "region": {
      "default": "US",
      "description": "Pinterest Trends market. Combined codes such as `GB+IE` cover Pinterest's published regional groups.",
      "editor": "select",
      "enum": [
        "US",
        "GB+IE",
        "CA",
        "IT+ES+PT+GR+MT",
        "IT",
        "ES",
        "DE+AT+CH",
        "DE",
        "FR",
        "SE+DK+FI+NO",
        "NL+BE+LU",
        "PL+RO+HU+SK+CZ",
        "MX+AR+CO+CL",
        "CO",
        "AR",
        "MX",
        "BR",
        "AU+NZ",
        "MY",
        "PH",
        "TH",
        "EG",
        "TR",
        "KR",
        "CR+DO+EC+GT+PE",
        "CY+CZ+GR+HU+MT+PL+RO+SK"
      ],
      "enumTitles": [
        "United States",
        "Great Britain + Ireland",
        "Canada",
        "Italy, Spain, Portugal, Greece + Malta",
        "Italy",
        "Spain",
        "Germany, Austria + Switzerland",
        "Germany",
        "France",
        "Sweden, Denmark, Finland + Norway",
        "Netherlands, Belgium + Luxembourg",
        "Poland, Romania, Hungary, Slovakia + Czechia",
        "Mexico, Argentina, Colombia + Chile",
        "Colombia",
        "Argentina",
        "Mexico",
        "Brazil",
        "Australia + New Zealand",
        "Malaysia",
        "Philippines",
        "Thailand",
        "Egypt",
        "Türkiye",
        "South Korea",
        "Costa Rica, Dominican Republic, Ecuador, Guatemala + Peru",
        "Cyprus, Czechia, Greece, Hungary, Malta, Poland, Romania + Slovakia"
      ],
      "prefill": "US",
      "title": "Region",
      "type": "string"
    },
    "shoppingEvent": {
      "default": "OUTBOUND_CLICK",
      "description": "Pinterest shopping signal used for category metrics and ranked shopping trends.",
      "editor": "select",
      "enum": [
        "OUTBOUND_CLICK",
        "SAVE"
      ],
      "enumTitles": [
        "Outbound clicks",
        "Saves"
      ],
      "prefill": "OUTBOUND_CLICK",
      "title": "Shopping signal",
      "type": "string"
    },
    "trendType": {
      "default": "topMonthly",
      "description": "Trending list to collect (mode=trendingSearches).",
      "editor": "select",
      "enum": [
        "topMonthly",
        "topYearly",
        "growing",
        "seasonal"
      ],
      "enumTitles": [
        "Top monthly searches",
        "Top yearly searches",
        "Fast-growing searches",
        "Seasonal searches"
      ],
      "prefill": "topMonthly",
      "title": "Trend list",
      "type": "string"
    }
  },
  "required": [
    "mode"
  ],
  "schemaVersion": 1,
  "title": "Pinterest Trends Input",
  "type": "object"
}