# Pinterest API: Get profile

> Gets a public Pinterest profile and its visible boards in profile order. Monthly views are null when Pinterest does not show them.

Unofficial. Not affiliated with or endorsed by Pinterest.

- Page: https://fous.com/methods/pinterest.com/get-profile
- Method: `pinterest.com/get_profile`, version 1
- Website: pinterest.com
- Returns: display name, username, bio, followers, following, monthly views, website, picture, boards
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `username` | string | yes | `"https://www.pinterest.com/pinterest/"` | Pinterest username, @username, or profile link, for example nasa or https://www.pinterest.com/nasa/. |
| `max_boards` | integer | no | `50` | Maximum number of boards to return, for example 25. Default 25. |

## Output

From a run on Oct 27, 2026, shortened. Its input:

```json
{
  "username": "https://www.pinterest.com/pinterest/",
  "max_boards": 50
}
```

Its output:

```json
{
  "bio": "Find your reason to go offline. 📌",
  "boards": [
    {
      "board_link": "https://www.pinterest.com/pinterest/the-best-advent-calendars-of-2026/",
      "board_name": "The best advent calendars of 2026",
      "number_of_pins": 51
    },
    {
      "board_link": "https://www.pinterest.com/pinterest/your-ultimate-holiday-starter-pack/",
      "board_name": "Your ultimate holiday starter pack",
      "number_of_pins": 149
    },
    {
      "board_link": "https://www.pinterest.com/pinterest/holiday-decor-ideas/",
      "board_name": "Holiday decor ideas",
      "number_of_pins": 183
    }
  ],
  "username": "pinterest",
  "followers": 6267175,
  "following": 398,
  "next_cursor": "LT40MjQ2MDUxMzk4MDgxMDcxNDd8NTB8MTY0Mzk0MDczNDE3NzA3OCpHUUwqfDM4Zjc0MjhiN2Q4NjhlNTZiNmUyNTJmZGQ5MjMwMGM1NGY5ODNlZTA3MGYxOGU3MTRiNmZjMTVkM2I1ZmFmZGR8TkVXfA==",
  "display_name": "Pinterest",
  "profile_link": "https://www.pinterest.com/pinterest/",
  "total_boards": 154,
  "website_link": "http://www.pinterest.com",
  "monthly_views": null,
  "profile_picture_link": "https://i.pinimg.com/280x280_RS/1c/b5/61/1cb561c8e7b9c709f78d110a4b5f0863.jpg"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"pinterest.com/get_profile","input":{"username":"https://www.pinterest.com/pinterest/","max_boards":50}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Can you pull up the public Pinterest profile for the username nasa and list its first 25 boards?
- I need the follower count, bio, and website for the Pinterest account @natgeo.
- Look up pinterest.com/martha-stewart and show me her display name, following count, and monthly views if visible.
- Get the top 10 boards from the Pinterest profile https://www.pinterest.com/etsy/ in profile order.
- What's on the Pinterest page for the user bonappetit? Show me the profile picture, bio, and boards.

## Input schema

```json
{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "username": {
      "type": "string",
      "description": "Pinterest username, @username, or profile link, for example nasa or https://www.pinterest.com/nasa/."
    },
    "max_boards": {
      "type": "integer",
      "default": 25,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum number of boards to return, for example 25."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "display_name",
    "username",
    "bio",
    "followers",
    "following",
    "monthly_views",
    "website_link",
    "profile_picture_link",
    "profile_link",
    "boards"
  ],
  "properties": {
    "bio": {
      "type": [
        "string",
        "null"
      ]
    },
    "boards": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "board_name",
          "number_of_pins",
          "board_link"
        ],
        "properties": {
          "board_link": {
            "type": "string"
          },
          "board_name": {
            "type": "string"
          },
          "number_of_pins": {
            "type": [
              "integer",
              "null"
            ]
          }
        }
      }
    },
    "username": {
      "type": "string"
    },
    "followers": {
      "type": [
        "integer",
        "null"
      ]
    },
    "following": {
      "type": [
        "integer",
        "null"
      ]
    },
    "display_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "profile_link": {
      "type": "string"
    },
    "website_link": {
      "type": [
        "string",
        "null"
      ]
    },
    "monthly_views": {
      "type": [
        "integer",
        "null"
      ]
    },
    "profile_picture_link": {
      "type": [
        "string",
        "null"
      ]
    }
  }
}
```

## See more

- [Pinterest API: Search pins](https://fous.com/methods/pinterest.com/search-pins.md): Finds Pinterest pins for an idea in search order, with image, creator, board, saves and linked website. Limited to the first public search page.
- [Instagram API: Get profile](https://fous.com/methods/instagram.com/get-profile.md): Gets an Instagram account's public profile from its username, @name or profile link: name, bio, exact follower, following and post counts, verified and private flags, first bio link, profile picture and account ID.
- [Threads API: Get profile](https://fous.com/methods/threads.com/get-profile.md): Gets a public Threads profile by username or profile link, with bio, followers, verification, picture and bio links. Private profiles are not returned.
- [X API: Get profile](https://fous.com/methods/x.com/get-profile.md): Gets the public X profile for a username or profile link, including counts, verification, images and account details. Does not include posts or a timeline.
- [TikTok API: Get profile](https://fous.com/methods/tiktok.com/get-profile.md): Gets a TikTok creator's public profile and totals (followers, following, likes, videos) from a username, @handle or profile link. Profiles not visible to public visitors cannot be returned.
- [Instagram API: Get engagement stats](https://fous.com/methods/instagram.com/get-engagement-stats-2.md): Gets an Instagram account's follower count plus its posting and engagement over the last 30 days: posts published, average views of its videos and reels, and average likes and comments per post, from a username or profile link.
- [Instagram API: List recent posts](https://fous.com/methods/instagram.com/list-recent-posts.md): Lists the latest publicly embeddable posts and reels from an Instagram account, newest first. Without login Instagram may show fewer posts than requested. View counts that are not available are null.
- [Reddit API: Get user](https://fous.com/methods/reddit.com/get-user.md): Gets a public Reddit user's profile (post and comment karma, account creation date) and their recent posts and comments, newest first. Suspended or nonexistent users are reported as not found.
- [All Pinterest methods](https://fous.com/methods/pinterest.com.md)