{
  "openapi": "3.0.1",
  "info": {
    "title": "Pinterest Trends Scraper | Trending Keywords and Forecasts",
    "description": "Pinterest Trends scraper: trending searches and your own keywords by country, with weekly interest history, week, month and year change, audience by age and gender, US forecasts, related searches and the most saved pins of each trend. 78 rows in 38 seconds, 12 fields each. No account or API key.",
    "version": "1.0",
    "x-build-id": "TUxFAAgYqq0hdgI1i"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~pinterest-trends-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-pinterest-trends-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/silentflow~pinterest-trends-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-pinterest-trends-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/silentflow~pinterest-trends-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-pinterest-trends-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "keywords": {
            "title": "🔎 Your keywords",
            "type": "array",
            "description": "Your own search terms, one per line, e.g. <code>christmas nails</code>. Each one gets its weekly interest over the history you pick, its week, month and year change, who searches it, Pinterest's related searches and, in the US, a 13-week forecast. Leave empty to read the trend lists only.",
            "items": {
              "type": "string"
            }
          },
          "expandKeywords": {
            "title": "💡 Add keyword ideas",
            "type": "boolean",
            "description": "Also research the searches Pinterest Trends suggests for each of your keywords (about 10 per keyword): each one becomes a keyword row with its own history, changes, audience and related searches, and says which keyword it came from. Counts toward Max trends and keywords.",
            "default": false
          },
          "countries": {
            "title": "🌍 Countries",
            "type": "array",
            "description": "Pinterest Trends markets, one or several. You can also type a country name: Austria and Switzerland read as Germany, Austria and Switzerland, Ireland as the UK and Ireland, Portugal as Southern Europe. Japan, the UAE, South Africa and Singapore are not covered by Pinterest Trends.",
            "items": {
              "type": "string",
              "enumSuggestedValues": [
                "US",
                "CA",
                "GB",
                "GB+IE",
                "DE",
                "DE+AT+CH",
                "FR",
                "IT",
                "ES",
                "IT+ES+PT+GR+MT",
                "SE+DK+FI+NO",
                "NL+BE+LU",
                "PL+RO+HU+SK+CZ",
                "CY+CZ+GR+HU+MT+PL+RO+SK",
                "MX",
                "AR",
                "CO",
                "MX+AR+CO+CL",
                "CR+DO+EC+GT+PE",
                "BR",
                "AU+NZ",
                "IN",
                "ID",
                "MY",
                "PH",
                "TH",
                "KR",
                "SA",
                "EG",
                "TR"
              ],
              "enumTitles": [
                "United States",
                "Canada",
                "United Kingdom",
                "United Kingdom and Ireland",
                "Germany",
                "Germany, Austria and Switzerland",
                "France",
                "Italy",
                "Spain",
                "Southern Europe",
                "Nordics",
                "Benelux",
                "Central Europe",
                "Central and Southern Europe",
                "Mexico",
                "Argentina",
                "Colombia",
                "Mexico, Argentina, Colombia and Chile",
                "Central America and Peru",
                "Brazil",
                "Australia and New Zealand",
                "India",
                "Indonesia",
                "Malaysia",
                "Philippines",
                "Thailand",
                "South Korea",
                "Saudi Arabia",
                "Egypt",
                "Turkey"
              ]
            }
          },
          "trendTypes": {
            "title": "📈 Trend lists",
            "type": "array",
            "description": "Which Pinterest Trends lists to read, for each country. Each list holds up to 100 terms. Left empty, the run reads the growing list, unless you only typed keywords.",
            "items": {
              "type": "string",
              "enum": [
                "growing",
                "monthly",
                "yearly",
                "seasonal"
              ],
              "enumTitles": [
                "Growing trends (fastest risers)",
                "Top monthly searches",
                "Top yearly searches",
                "Seasonal trends (back every year)"
              ]
            }
          },
          "maxItems": {
            "title": "🔢 Max trends and keywords",
            "minimum": 1,
            "type": "integer",
            "description": "How many trend and keyword rows the run returns, shared evenly between your countries and lists. Top pins come on top of this number.",
            "default": 100
          },
          "categories": {
            "title": "🗂️ Categories",
            "type": "array",
            "description": "Keep only trends from these Pinterest categories, e.g. Home decor or Beauty. Leave empty for all categories.",
            "items": {
              "type": "string",
              "enum": [
                "925056443165",
                "918105274631",
                "961238559656",
                "935541271955",
                "934876475639",
                "902065567321",
                "922134410098",
                "960887632144",
                "953061268473",
                "941870572865",
                "948967005229",
                "913207199297",
                "918530398158",
                "909983286710",
                "898620064290",
                "935249274030",
                "920236059316",
                "948192800438",
                "919812032692",
                "908182459161",
                "918093243960",
                "903260720461"
              ],
              "enumTitles": [
                "Animals",
                "Architecture",
                "Art",
                "Beauty",
                "DIY and crafts",
                "Design",
                "Education",
                "Electronics",
                "Entertainment",
                "Event planning",
                "Fashion",
                "Finance",
                "Food and drinks",
                "Gardening",
                "Health",
                "Home decor",
                "Parenting",
                "Quotes",
                "Sport",
                "Travel",
                "Vehicles",
                "Wedding"
              ]
            }
          },
          "keywordsToInclude": {
            "title": "Only terms containing",
            "type": "array",
            "description": "Keep only trending terms that contain one of these words, e.g. <code>christmas</code> or <code>wedding</code>.",
            "items": {
              "type": "string"
            }
          },
          "keywordsToExclude": {
            "title": "Leave out terms containing",
            "type": "array",
            "description": "Leave out trending terms that contain one of these words, e.g. <code>wallpaper</code>.",
            "items": {
              "type": "string"
            }
          },
          "historyDays": {
            "title": "📅 History length (days)",
            "minimum": 90,
            "maximum": 730,
            "type": "integer",
            "description": "Weekly interest history on every row: 90, 180, 365 or 730 days. Another number is rounded to the nearest of these.",
            "default": 365
          },
          "endDate": {
            "title": "📆 Trends as of",
            "type": "string",
            "description": "Read the lists and the history as of a past day, up to about a year back, for reports and before/after comparisons. Leave empty for Pinterest's latest figures. Pinterest serves its nearest published day; each row says which in dataAsOf."
          },
          "topPinsPerTrend": {
            "title": "📌 Top pins per trend",
            "minimum": 0,
            "maximum": 10,
            "type": "integer",
            "description": "Also return the most saved pins Pinterest shows for each term, with saves, the pin link, its website and its creator. Each pin is one more row, so 20 trends with 3 pins give 60 more rows. 0 turns pins off.",
            "default": 0
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}