{
  "openapi": "3.0.1",
  "info": {
    "title": "Pinterest Scraper - Search, Pins, Boards & Profiles, No Login",
    "description": "Pinterest scraper, $1 per 1,000 rows. Search pins, videos, boards or profiles by keyword, or paste pin, board and profile links. Saves, comments, outbound links, full-size images, MP4 video, followers and monthly views. Fast, no login, new-only mode for schedules.",
    "version": "0.1",
    "x-build-id": "Xr1J4Ivtnjtfz2VoH"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/locaihost~pinterest-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-locaihost-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/locaihost~pinterest-scraper/runs": {
      "post": {
        "operationId": "runs-sync-locaihost-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/locaihost~pinterest-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-locaihost-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": "Search Pinterest the way its search box does. Each keyword returns the pins (or videos, boards or profiles, see Search for) Pinterest shows for it.",
            "items": {
              "type": "string"
            }
          },
          "searchType": {
            "title": "Search for",
            "enum": [
              "pins",
              "videos",
              "boards",
              "profiles"
            ],
            "type": "string",
            "description": "What each keyword search returns: pins, video pins, boards, or profiles (accounts).",
            "default": "pins"
          },
          "searchRefinements": {
            "title": "Also search Pinterest's refinements",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "Pinterest shows refinement chips under each search (for minimalist kitchen: Modern, Counter decor ideas, Cabinets...). Also search the first this many of them. Each chip adds about 25 results, so 4 turns one keyword into about 125. 0 searches only your keywords.",
            "default": 0
          },
          "startUrls": {
            "title": "Pinterest links",
            "type": "array",
            "description": "Paste pin, board, profile or search links. Any country site works (pinterest.co.uk, de.pinterest.com...) and so do pin.it short links. A pin link returns that pin with full details; a board link returns the board and its pins; a profile link returns the profile, its boards and (see Pins from profiles) its pins.",
            "items": {
              "type": "string"
            }
          },
          "usernames": {
            "title": "Profiles (usernames)",
            "type": "array",
            "description": "Pinterest usernames as they appear in the profile link, like bhg for https://www.pinterest.com/bhg/. Each returns a profile row: display name, bio, website, followers, following, monthly views, pin and board counts.",
            "items": {
              "type": "string"
            }
          },
          "maxItemsPerSource": {
            "title": "Max results per search, board or profile",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "Pinterest shows a signed-out visitor about 25 results per search, board or profile, then asks them to log in. This Actor reads what a signed-out visitor sees, so 25 is the practical most. For more per topic, add keywords or turn on refinements.",
            "default": 25
          },
          "profileBoards": {
            "title": "Boards of each profile",
            "type": "boolean",
            "description": "For each username or profile link, also return its public boards (name, description, pin and follower counts, cover image).",
            "default": true
          },
          "maxBoardsPerProfile": {
            "title": "Max boards per profile",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "Up to about 25, the boards a signed-out visitor is shown.",
            "default": 25
          },
          "profilePins": {
            "title": "Pins from profiles",
            "enum": [
              "none",
              "created",
              "saved"
            ],
            "type": "string",
            "description": "For each username or profile link, also return pins: the ones it created (its Created tab) or its latest saves. Off by default.",
            "default": "none"
          },
          "relatedPins": {
            "title": "Related pins per pin link",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "For each pin link, also return the related pins Pinterest shows under it (\"More to explore\", usually 10 to 25). 0 turns this off.",
            "default": 0
          },
          "fullDetails": {
            "title": "Full details for every pin",
            "type": "boolean",
            "description": "Open each pin found in a search, board or profile on its own page for saves, comment count, outbound link, created date and video file. Profiles found by search get their full profile too. Pins from keyword search, video search and related pins always carry what the list showed: Pinterest opens their pages only for logged-in visitors. Turn off for a faster, lighter run: rows then carry what the list showed (details: listing).",
            "default": true
          },
          "onlyNew": {
            "title": "Only new since the last run",
            "type": "boolean",
            "description": "Skip pins and boards an earlier run with the same lookups already returned, and charge only for new ones. Profile rows are always returned fresh, because their counts change. Made for scheduled runs.",
            "default": false
          },
          "maxResults": {
            "title": "Max rows in total",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many charged rows. 0 means no limit.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}