Actions87
- Users Actions
- Shopping & Catalogs Actions
- Advertising & Campaigns Actions
- Advanced Analytics Actions
- Engagement Features Actions
- Business Tools Actions
- Search & Discovery Actions
- Pins Actions
- Boards Actions
Overview
The node operation Get Board Sections under the Boards resource retrieves the sections of a specified Pinterest board. This is useful when you want to programmatically access the subdivisions or categories within a board, for example, to display them in an app, analyze their content, or automate management tasks.
Typical use cases include:
- Fetching all sections of a board to list them in a user interface.
- Automating content organization by analyzing or updating board sections.
- Integrating Pinterest board structure into marketing or analytics workflows.
Example: You have a Pinterest board for "Travel Destinations" and want to get all its sections like "Europe", "Asia", "America" to show on your website or process further.
Properties
| Name | Meaning |
|---|---|
| Board ID | The unique identifier of the Pinterest board whose sections you want to retrieve. |
| Page Size | Number of sections to return per page (pagination). Default is 25, max 250. |
| Cursor | Pagination cursor to fetch the next set of results if there are more than one page. |
| Include Private Metrics | Boolean flag to include private metrics data (requires elevated access). |
| Custom Fields | Comma-separated list of custom fields to include in the response. |
Output
The output is a JSON array where each item corresponds to a board section retrieved from the specified board. Each section object typically includes details such as the section's ID, name, and possibly other metadata depending on requested fields.
If pagination is used, the response may also include a cursor for fetching subsequent pages.
No binary data is output by this operation.
Dependencies
- Requires an active subscription and valid API key credential for the external N8N Tools API service that acts as a proxy to Pinterest API v5.
- Requires OAuth2 authentication credentials for Pinterest API access.
- The node internally uses helper classes to interact with Pinterest endpoints via the N8N Tools API.
Troubleshooting
- Invalid Subscription or API Key: If the node throws errors about invalid subscription or API key, verify that the API key credential is correctly configured and active.
- Permission Errors: Including private metrics requires elevated access; without it, the request may fail or omit those fields.
- Pagination Issues: If many sections exist, ensure correct handling of the
cursorproperty to paginate through all results. - Missing Board ID: The Board ID is required; omitting it will cause the node to error out.
Links and References
- Pinterest API v5 Documentation
- N8N Documentation - Creating Custom Nodes
- Pinterest Boards API Reference (official Pinterest docs for board sections)
This summary is based solely on static analysis of the provided source code and property definitions.