{
  "openapi": "3.0.1",
  "info": {
    "title": "Pinterest Search Scraper — Pins, Boards & Users",
    "description": "Search Pinterest by keyword or Pinterest search URL and get pins, boards and users as one structured JSON dataset with images, links, hashtags, video flags and counts when Pinterest provides them. No login needed; works with Apify MCP and the API.",
    "version": "1.0",
    "x-build-id": "OLxxxMOP06xKPBHh5"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~pinterest-search-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-pinterest-search-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/khadinakbar~pinterest-search-scraper/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-pinterest-search-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/khadinakbar~pinterest-search-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-pinterest-search-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": "Keywords, topics or niches to search on Pinterest, for example 'minimalist kitchen' or 'sourdough'. Each keyword is searched on its own. Use plain words, not URLs. Required unless you add search URLs below.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Pinterest search URLs (optional)",
            "type": "array",
            "description": "Optional Pinterest search-result URLs, for example https://www.pinterest.com/search/pins/?q=minimalist%20kitchen or .../search/boards/?q=wedding. The keyword and result type are read from each URL. Pin, board and profile page URLs are skipped.",
            "items": {
              "type": "string"
            }
          },
          "resultTypes": {
            "title": "📂 Result types",
            "uniqueItems": true,
            "type": "array",
            "description": "What to return: 'pins' (images and videos), 'boards' (collections with pin and follower counts) or 'users' (creator profiles). Pick any mix. Each type is a separate search and is charged per result.",
            "items": {
              "type": "string",
              "enum": [
                "pins",
                "boards",
                "users"
              ],
              "enumTitles": [
                "Pins",
                "Boards",
                "Users / Profiles"
              ]
            },
            "default": [
              "pins"
            ]
          },
          "maxResults": {
            "title": "📊 Max results per keyword and type",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "How many results to collect for each keyword and result type (not a total). Example: 2 keywords x pins + boards x 100 = up to 400 results. Pinterest itself stops listing around 800 pins per keyword, so higher values need more keywords. Range 1 to 5000. Free-plan runs stop at 100 results in total.",
            "default": 50
          },
          "onlyVideos": {
            "title": "🎬 Only video pins",
            "type": "boolean",
            "description": "Keep only pins that are videos. Applies to pins only. Filtered-out pins are not charged.",
            "default": false
          },
          "onlyWithOutboundLink": {
            "title": "🔗 Only pins with a website link",
            "type": "boolean",
            "description": "Keep only pins that link out to a website (useful for finding products, blogs and shops).",
            "default": false
          },
          "excludePromoted": {
            "title": "🚫 Exclude promoted pins (ads)",
            "type": "boolean",
            "description": "Skip pins that Pinterest marks as promoted. Each pin has an is_promoted field either way.",
            "default": false
          },
          "domainContains": {
            "title": "🌐 Link domain contains",
            "type": "string",
            "description": "Keep only pins whose website link domain contains this text, for example 'etsy' or 'amazon'. Leave empty for no filter."
          },
          "minSaves": {
            "title": "📌 Minimum saves",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only pins with at least this many saves. Pinterest search often hides save counts, so pins without a count are dropped when this is set. 0 means no filter.",
            "default": 0
          },
          "minCreatorFollowers": {
            "title": "👥 Minimum creator followers",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only pins whose creator has at least this many followers. Pins with no follower count are dropped when this is set. 0 means no filter.",
            "default": 0
          },
          "bookmarks": {
            "title": "↩️ Resume bookmarks (advanced)",
            "type": "object",
            "description": "Continue an earlier search where it stopped. Paste the 'nextBookmarks' object from the previous run's OUTPUT record, for example {\"pins:home office setup\": \"...\"}. Leave empty for a fresh search."
          },
          "maxConcurrency": {
            "title": "Parallel searches (advanced)",
            "minimum": 1,
            "maximum": 32,
            "type": "integer",
            "description": "How many keyword searches run at the same time. Leave empty to size it from the run memory. Lower it if you see blocked searches."
          },
          "proxy": {
            "title": "🌐 Proxy",
            "type": "object",
            "description": "Default: Apify datacenter proxy first, switching to residential automatically if Pinterest blocks it. Choose the Residential group to start on residential, or set a country for geo-specific results.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}