Data API / Pinterest / User
User Boards
Lists a user's public boards by username, with a cursor to page. Each board carries id, name, url, description, pin_count, follower_count, section_count, collaborator_count, privacy, owner, created_at, cover_pin and cover_images. The handle is the bare username as it appears in a profile URL (agkelsey, not a full URL). Feed each board's url to get_pinterest_board to read its pins; to search across all of Pinterest use get_pinterest_search.
Parameters
query
handlestringRequiredThe username of the user to get boards for. (e.g. broadstbullycom from https://www.pinterest.com/broadstbullycom/)
trimbooleanOptionalSet to true for a trimmed down version of the response
Example request
curl -G "https://openapi.felo.ai/v1/beta/pinterest/user/boards" \
--data-urlencode "handle=<string>" \
-H "Authorization: Bearer $FELO_API_KEY"Response
Example response
{
"success": true,
"boards": [
{
"id": "549580029467577434",
"url": "https://www.pinterest.com/sharat24k/turkey-recipes/",
"description": "",
"follower_count": 292,
"pin_count": 545,
"name": "Turkey Recipes",
"image_cover_hd_url": "https://i.pinimg.com/474x/45/00/df/4500dfc5bc8bbc15137ff9d9abf04cc1.jpg",
"created_at": "Mon, 17 Feb 2025 02:19:26 +0000"
}
],
"cursor": "LT41NDk1ODAwMjk0Njc1Njc1O...."
}Response fields
successbooleanOptionalcredits_remainingintegerOptionalboardsobject[]OptionalcursorOptional