Docs menu

Pinterest API endpoint

Pinterest user boards API

Returns a page of a Pinterest user's own boards: name, description, cover image, and pin/follower counts for each. Public data sourced from Pinterest's own profile pages.

GETapiKey3 credits/requestPinterestpinterest.userBoardsResponseDoc/pinterest/user/{username}/boards

Endpoint facts

Method: GET
API path: /pinterest/user/{username}/boards
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Pinterest
Response schema: #/definitions/pinterest.userBoardsResponseDoc

Pinterest Scraper API Try Pinterest user boards API in Playground Pinterest API documentation

How this endpoint behaves

Path parameters:

username (required) — a Pinterest username.

Notable response behavior:

owner_username on each board always matches the requested username.
Each board's url is usable directly as the username/slug path parameters to /pinterest/board/{username}/{slug}.
A missing username returns 400 before any upstream request is made.

Live monitoring

Monitored request: GET /pinterest/user/patrontequila/boards
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.40 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /pinterest/user/patrontequila/boards
Items in boards: 10
Fields filled in every checked item: 8
Fields empty in some or all items: 1

Field	Filled in, of 10 checked	Values in the sample
id	10
url	10
name	10
description	3	median 173 characters
cover_image_url	10	i.pinimg.com
pin_count	10	2 to 13, median 5
follower_count	10	10,368
privacy	10
owner_username	10

Request parameters

Parameter	Type	Required	Default	Description	Example
username (path)	string	Yes		Pinterest username	patrontequila
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/pinterest/user/patrontequila/boards" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "username": "patrontequila",
    "boards": [
      {
        "id": "52847064316842828",
        "url": "/patrontequila/summer-cocktails/",
        "name": "Summer Cocktails",
        "cover_image_url": "https://i.pinimg.com/200x150/d0/8f/99/d08f99da806e4096a7dc9355d7fbd706.jpg",
        "pin_count": 2,
        "follower_count": 10372,
        "privacy": "public",
        "owner_username": "patrontequila"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/pinterest.userBoardsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	pinterest.UserBoardsResponse	No
data.boards	array	No
data.boards[].cover_image_url	string	No
data.boards[].description	string	No
data.boards[].follower_count	integer	No
data.boards[].id	string	No
data.boards[].name	string	No
data.boards[].owner_username	string	No
data.boards[].pin_count	integer	No
data.boards[].privacy	string	No
data.boards[].url	string	No
data.username	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/pinterest/user/patrontequila/boards" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Pinterest endpoint docs Pinterest Scraper API Pinterest board API documentation Pinterest categories API documentation Pinterest idea API documentation Pinterest pin API documentation Pinterest search API documentation Pinterest user API documentation

Open in Playground Back to group

Docs menu

Pinterest API endpoint

Pinterest user boards API

Returns a page of a Pinterest user's own boards: name, description, cover image, and pin/follower counts for each. Public data sourced from Pinterest's own profile pages.

GETapiKey3 credits/requestPinterestpinterest.userBoardsResponseDoc/pinterest/user/{username}/boards

Endpoint facts

Method: GET
API path: /pinterest/user/{username}/boards
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Pinterest
Response schema: #/definitions/pinterest.userBoardsResponseDoc

Pinterest Scraper API Try Pinterest user boards API in Playground Pinterest API documentation

How this endpoint behaves

Path parameters:

username (required) — a Pinterest username.

Notable response behavior:

owner_username on each board always matches the requested username.
Each board's url is usable directly as the username/slug path parameters to /pinterest/board/{username}/{slug}.
A missing username returns 400 before any upstream request is made.

Live monitoring

Monitored request: GET /pinterest/user/patrontequila/boards
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.40 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /pinterest/user/patrontequila/boards
Items in boards: 10
Fields filled in every checked item: 8
Fields empty in some or all items: 1

Field	Filled in, of 10 checked	Values in the sample
id	10
url	10
name	10
description	3	median 173 characters
cover_image_url	10	i.pinimg.com
pin_count	10	2 to 13, median 5
follower_count	10	10,368
privacy	10
owner_username	10

Request parameters

Parameter	Type	Required	Default	Description	Example
username (path)	string	Yes		Pinterest username	patrontequila
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/pinterest/user/patrontequila/boards" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "username": "patrontequila",
    "boards": [
      {
        "id": "52847064316842828",
        "url": "/patrontequila/summer-cocktails/",
        "name": "Summer Cocktails",
        "cover_image_url": "https://i.pinimg.com/200x150/d0/8f/99/d08f99da806e4096a7dc9355d7fbd706.jpg",
        "pin_count": 2,
        "follower_count": 10372,
        "privacy": "public",
        "owner_username": "patrontequila"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/pinterest.userBoardsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	pinterest.UserBoardsResponse	No
data.boards	array	No
data.boards[].cover_image_url	string	No
data.boards[].description	string	No
data.boards[].follower_count	integer	No
data.boards[].id	string	No
data.boards[].name	string	No
data.boards[].owner_username	string	No
data.boards[].pin_count	integer	No
data.boards[].privacy	string	No
data.boards[].url	string	No
data.username	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/pinterest/user/patrontequila/boards" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Pinterest user boards API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Pinterest user boards API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related