pinterest-research

Pinterest research

Look up public Pinterest profiles, boards, and pins, browse the "Ideas" category taxonomy, and run keyword search — all as normalized JSON from the Crawlora API, no Pinterest scraping or unofficial client libraries.

When to use this skill

"What's 's Pinterest profile / follower count / boards?"
"Pull the pins from this board / this user's own pins."
"What's in this pin?" (title, description, image, save count).
"Search Pinterest for pins about ."
"What are Pinterest's Ideas categories, and what's trending in ?"
Competitor board audits, content-idea research, or trend scouting on Pinterest.

Setup (one-time)

Get a free Crawlora API key (2,000 credits/mo, no card) at https://crawlora.net.
Set CRAWLORA_API_KEY in the environment before running the helper.
The helper reads CRAWLORA_API_KEY from the environment and sends requests to https://api.crawlora.net/api/v1. Missing/invalid key → 401.

How it works

Search — /pinterest/search?query= for pins matching a text query (title, description, image, board, pinner per result).
Pin detail — /pinterest/pin/{id} for one pin's full detail: title, description, image, board, pinner, comment count, save count, creation time.
Board detail — /pinterest/board/{username}/{slug} for a board's metadata (name, description, cover image, pin/follower counts, owner) plus a page of its pins.
User profile — /pinterest/user/{username} for a user's public profile: display name, bio, website, avatar, follower/following/pin/board counts.
User's boards / pins — /pinterest/user/{username}/boards and /pinterest/user/{username}/pins for a page of a user's own boards or own pins.
Ideas categories — /pinterest/categories for the top-level "Ideas" taxonomy (e.g. "Animals", "Home Decor", "Food And Drink"); each entry's id feeds /pinterest/ideas/{id} for that category's metadata plus a page of pins from its feed.

Full endpoint list, methods, and params: reference/endpoints.md.

Calling the API

# Profile + boards + pins:
scripts/crawlora.sh /pinterest/user/marthastewart | jq '.'
scripts/crawlora.sh /pinterest/user/marthastewart/boards | jq '.'
scripts/crawlora.sh /pinterest/user/marthastewart/pins | jq '.'

# Search + pin detail:
scripts/crawlora.sh /pinterest/search query="minimalist home office" | jq '.'
scripts/crawlora.sh /pinterest/pin/123456789 | jq '.'

# Ideas categories + a category feed:
scripts/crawlora.sh /pinterest/categories | jq '.'
scripts/crawlora.sh /pinterest/ideas/home-decor | jq '.'

Use scripts/crawlora.sh for all requests; it keeps the API key out of command-line arguments.

Endpoint reference

See reference/endpoints.md for every Pinterest endpoint this skill uses.

Examples

Competitor board audit: pull a competitor's profile plus /pinterest/user/{username}/boards, compare board topics, pin counts, and follower counts to spot content gaps.
Content-idea research: /pinterest/categories to find the relevant "Ideas" category, then /pinterest/ideas/{id} to see what's currently surfacing in that category's feed before planning new pins.
Brand-mention / keyword sweep: /pinterest/search for a brand or product name, then /pinterest/pin/{id} on the top results to check save counts and pinner details.

Notes & limits

Credits / pay-on-success: billed only on 2xx; free tier 2,000 credits/mo. Key at https://crawlora.net.
Public data only — public profiles/boards/pins; no login, no private boards. Respect Pinterest's terms.
Security: key lives in CRAWLORA_API_KEY only — never hardcode, query-param, or commit it.
Board lookups need both username and slug — get the slug from the board's own /{username}/{slug}/ URL; there's no board-search-by-name endpoint.
/pinterest/ideas/{id} requires a category id from /pinterest/categories first — ids aren't guessable from a category's display name.
List endpoints (search, board, user/{username}/boards, user/{username}/pins, ideas/{id}) return a page of results — check the response for a cursor/offset to walk beyond the first page.