{
  "openapi": "3.0.1",
  "info": {
    "title": "Pinterest Scraper: Pins, Boards, Profiles & Search",
    "description": "Scrape Pinterest pins, video pins, boards and profiles by keyword or link, no login: real pin links, saves, outbound links, product prices, monthly views, keyword suggestions. Free date, saves and domain filters, only-new-pins monitoring. For e-commerce, SEO and social media marketing.",
    "version": "1.0",
    "x-build-id": "jS75aUERVr5acUY3j"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/panix~pinterest-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-panix-pinterest-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/panix~pinterest-scraper/runs": {
      "post": {
        "operationId": "runs-sync-panix-pinterest-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/panix~pinterest-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-panix-pinterest-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": {
          "searchQueries": {
            "title": "Search keywords",
            "type": "array",
            "description": "One keyword or phrase per line, e.g. 'minimalist kitchen' or 'fall outfits'. Each keyword is searched on its own and every row says which keyword found it.",
            "items": {
              "type": "string"
            }
          },
          "searchType": {
            "title": "Search for",
            "enum": [
              "pins",
              "videos",
              "boards",
              "profiles"
            ],
            "type": "string",
            "description": "What a keyword search returns: pins, video pins only, boards or profiles (creators).",
            "default": "pins"
          },
          "startUrls": {
            "title": "Pinterest links",
            "type": "array",
            "description": "Pin links (pinterest.com/pin/123.../), boards (pinterest.com/user/board/), profiles (pinterest.com/user/, or @user), search pages (pinterest.com/search/pins/?q=...) and pin.it short links. Any country domain works (de.pinterest.com, pinterest.co.uk).",
            "items": {
              "type": "string"
            }
          },
          "maxItemsPerInput": {
            "title": "Results per keyword or link",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Most pins (or boards / profiles) to deliver for each keyword, board or profile. Searches go hundreds of pins deep.",
            "default": 50
          },
          "maxResults": {
            "title": "Maximum pins in total (optional)",
            "minimum": 1,
            "type": "integer",
            "description": "Stop the whole run after this many pins. Leave empty for no total limit."
          },
          "profileContent": {
            "title": "For profile links, get",
            "enum": [
              "created",
              "saved",
              "boards",
              "none"
            ],
            "type": "string",
            "description": "Created = pins the account published itself (newest first). Saved = everything it saved. Boards = its public boards. Profile only = just the profile row (followers, monthly views, website). Every profile link also returns one profile row.",
            "default": "created"
          },
          "resolvePinLinks": {
            "title": "Find real pin links and save counts",
            "type": "boolean",
            "description": "Pinterest hides the real pin ID of search and board pins from logged-out visitors, so their links don't open. With this on, the scraper looks each pin up in its board's and creator's public pin list to add the working pin link and the save count. Pins it can't find keep an empty pinUrl. Free; adds a little run time.",
            "default": true
          },
          "pinDetails": {
            "title": "Full pin details",
            "type": "boolean",
            "description": "One extra request per pin with a known ID: adds shares, exact comment and save counts, hashtags and the creator's follower count. Slower; no extra charge.",
            "default": false
          },
          "includeKeywordSuggestions": {
            "title": "Add keyword suggestions",
            "type": "boolean",
            "description": "For each search keyword, also return the related searches Pinterest suggests (autocomplete), in Pinterest's order. Handy for SEO and pin titles. Charged as keyword suggestions (cheap).",
            "default": false
          },
          "createdAfter": {
            "title": "Pinned after",
            "type": "string",
            "description": "Only pins created on or after this date: 2026-01-01, or a period like '30 days', '6 months', '1 year'."
          },
          "createdBefore": {
            "title": "Pinned before",
            "type": "string",
            "description": "Only pins created before this date or period."
          },
          "minSaves": {
            "title": "Minimum saves",
            "minimum": 0,
            "type": "integer",
            "description": "Only pins saved at least this many times. Search pins need 'Find real pin links and save counts' for a save count."
          },
          "minReactions": {
            "title": "Minimum reactions",
            "minimum": 0,
            "type": "integer",
            "description": "Only pins with at least this many reactions (likes)."
          },
          "minCreatorFollowers": {
            "title": "Minimum creator followers",
            "minimum": 0,
            "type": "integer",
            "description": "Only pins (or profiles in a profile search) whose creator has at least this many followers."
          },
          "mediaType": {
            "title": "Media type",
            "enum": [
              "all",
              "video",
              "image"
            ],
            "type": "string",
            "description": "Keep all pins, only video pins, or only image pins.",
            "default": "all"
          },
          "onlyWithLink": {
            "title": "Only pins that link to a website",
            "type": "boolean",
            "description": "Leave out pins without an outbound link.",
            "default": false
          },
          "linkDomains": {
            "title": "Only pins linking to these sites",
            "type": "array",
            "description": "Keep pins whose outbound link is on one of these domains, e.g. etsy.com, amazon.com, yourshop.com. A word without a dot (e.g. 'etsy') matches any domain containing it.",
            "items": {
              "type": "string"
            }
          },
          "onlyProducts": {
            "title": "Only product pins",
            "type": "boolean",
            "description": "Keep only shopping pins with a product or price.",
            "default": false
          },
          "excludePromoted": {
            "title": "Leave out promoted pins (ads)",
            "type": "boolean",
            "description": "Drop pins Pinterest marks as promoted.",
            "default": false
          },
          "onlyNewPins": {
            "title": "Only pins not delivered before",
            "type": "boolean",
            "description": "For scheduled runs: deliver (and charge for) only pins this keyword, board or profile did not deliver in earlier runs with the same memory name. The first run delivers everything and remembers it.",
            "default": false
          },
          "monitorName": {
            "title": "Memory name",
            "type": "string",
            "description": "Separate memories for different schedules (letters, digits, - and _).",
            "default": "default"
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Apify datacenter proxy works well for Pinterest and keeps the price low. Change only if you know you need to.",
            "default": {
              "useApifyProxy": true
            }
          },
          "maxConcurrency": {
            "title": "Max parallel requests",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many requests run at the same time. The default suits most runs.",
            "default": 8
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}