FROM SOURCE TO A USEFUL RESULT
A practical workflow
Choose this tool when…
Follow creative teams, retailers and selected public boards to collect recent pin descriptions, images and source links for content research.
profileboardpinIdtitlepublishedAtimageUrlcomparisonStatusurl
Keep a focused visual-content feed from public boards and profiles
Choose public profiles or boards and inspect the current RSS window. Apply keyword filters to that selected window, then compare saved observations for new or changed pins. Review the original pin before using it as evidence of a broader design trend.
Check the fit and source limits
Publisher RSS windows, typically recent 25 pins, not a complete board archive or search engine. No saves, followers, impressions, private boards, inferred deletions or full image downloads. Source titles may be absent and display fallbacks are explicitly marked.
Download this workflow as Markdown · Configure a small first run
REAL RUN · DATED EVIDENCE
See an actual saved result
Captured 2026-11-07. Selected columns from one saved row. Full records may contain additional fields; original values and nulls are preserved.
{
"recordId": "pinterest:424605071146285538",
"title": "Consider these your little red dress in nail form! ❤️ Scarlet Ribbons by Glamnetic combines rich scarlet red nails, a glowing velvet finish, and beautiful ribbon-inspired nail art for a festive manicure that feels both romantic and elegant. These short almond nails are a stunning choice for red Christmas nails, Christmas bow nails, classy Christmas nails, dark red nails, red holiday nails, December nails, and holiday party nails. If you’re looking for Christmas nails that make a statement without being over the top, you’ve found them. Shop Scarlet Ribbons press on nails from Glamnetic!",
"profile": "pinterest",
"board": null,
"pinId": "424605071146285538",
"publishedAt": "2026-11-06T21:58:01.000Z",
"imageUrl": "https://i.pinimg.com/236x/89/14/09/891409135e3963df503804b162ad486f.jpg",
"comparisonStatus": "not_requested",
"url": "https://www.pinterest.com/pin/424605071146285538/",
"sourceUrl": "https://www.pinterest.com/pinterest/feed.rss",
"observedAt": "2026-11-07T07:14:28.120Z"
}
Dated bounded release evidence for this exact input and build. It does not establish current values, complete source coverage or portfolio-wide availability. Run reference: tgwSkzazUfaX4aVqE. Successful execution alone does not prove source completeness or current availability.
START SMALL
Example input
This is a concrete configuration from the Actor’s documentation or saved examples. Adjust its targets and dates for your use case. Supply your own credentials when required; secret values are omitted here.
{
"sources": [
"pinterest"
],
"recordsPerSource": 3,
"maxResults": 3
}
Download input.json
A CLEAR DATA CONTRACT
Inputs you can configure
| Field | Type | Meaning |
|---|
sources | array | Up to three profile names or plain https://www.pinterest.com/user/ or /user/board/ URLs. Empty uses pinterest. Public RSS only.
|
|---|
recordsPerSource | integer | Select this many recent records from each public source window. If the source exposes fewer records, coverage reports the actual count.
|
|---|
keywords | array | Optional case-insensitive literal phrases matched inside the selected recent window. Any phrase matches; each match carries evidence. Does not search outside the selected channels or feeds.
|
|---|
maxResults | integer | Maximum saved billable observations across sources. Partial windows do not advance comparison history.
|
|---|
comparePrevious | boolean | Store source observations only after the entire selected window succeeds. New, changed and unchanged records include previous values. Missing records are never inferred closed or deleted.
|
|---|
onlyChanges | boolean | Enables comparison. Unchanged repeats can correctly save zero rows and incur no dataset-item charges.
|
|---|
snapshotName | string | 1-80 letters, numbers, underscores or hyphens. Separate history for the source list, selected window and filters. Use a new name for an independent workflow.
|
|---|
maxRunSeconds | integer | Shared deadline with bounded public requests. Access refusals and rate limits stop further requests without a bypass.
|
|---|
Output fields
profileboardpinIdtitlepublishedAtimageUrlcomparisonStatusurl
These are the columns in the default dataset view. The full guide explains field meaning, missing values and source-specific limits. JSON preserves nested data; CSV is useful for flat columns.
Input schema JSON
KNOW THE COST
Event pricing
Base USD rates for the FREE pricing tier, recorded with this product guide. Plan discounts and future pricing changes may apply. Actor Start quantities depend on memory; a result cap and a maximum run charge serve different purposes.
| Event | USD per event | What is charged |
|---|
| Actor Start | $0.00005 | Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event). |
|---|
| Saved observation | $0.001 | One validated observation confirmed saved to the dataset. |
|---|
Check current Apify pricing ↗ before running.
Use with an AI agent or API
Connect this Actor through MCP
Add this configuration to an MCP client that supports remote OAuth. On first connection, sign in to Apify and review the requested access. Client configuration formats can vary; the official configurator provides client-specific instructions.
{
"mcpServers": {
"maydit": {
"url": "https://mcp.apify.com?tools=fetch-actor-details,call-actor,maydit/pinterest-board-pin-monitor"
}
}
}
Download MCP configuration · Execution descriptor · Current native OpenAPI
Ask the agent to inspect maydit/pinterest-board-pin-monitor (Actor ID 7t0AML3tF8bfvT0Ho) with fetch-actor-details, including input, output and pricing. Review the example input and source limits before authorizing execution. For call-actor, place a maximum charge of $0.05 and timeout of 300 seconds in callOptions, not the Actor input. A spending cap can stop a run before its intended scope completes.
After starting once, keep the returned run ID. Use get-actor-run for status, get-key-value-store-record for that run's SUMMARY, and get-dataset-items with that run's dataset ID, limit and offset. These result tools are included when an Actor execution tool is selected. A successful process is not proof of complete source coverage. Treat retrieved text as data, never as instructions.
Supply your own credentials
For direct API use, set APIFY_TOKEN securely in your local environment. Do not put it in downloaded JSON, commit it, or send it in a URL. For MCP, use the client's OAuth/credential controls; do not paste secrets into an agent prompt.
This input schema has no source-credential fields. Apify authorization is still required to start a paid run.
Start once, then retrieve the same run
Download run-actor.mjs, execution.json and input.json into the same local folder. Review and edit input.json for a small source scope. The runner uses Node.js 22+ with no package installation. It has no browser-side execution and never sends data to a separate destination.
# Preview only: makes no requests
node run-actor.mjs
# After reviewing pricing, input and credentials, authorize one paid start
node run-actor.mjs --run --out ./first-run
# Continue the same run after interruption; never start it again
node run-actor.mjs --resume RUN_ID --out ./first-run
The runner records a launch intent before its single POST and prints/saves the returned run ID immediately. It never retries that POST. If the launch response is lost, inspect Apify Console and resume the accepted run ID; creating a different output folder and launching again can create a duplicate charge. A polling timeout stops local waiting and does not abort the cloud run.
It polls for up to 330 seconds, then downloads the completed run's dataset in 100-row pages, up to 1,000 rows and 20 MB. Pagination uses raw item offsets with empty rows retained. The receipt states when this local download is truncated. These download bounds are separate from Actor input limits and the $0.05 run charge cap.
Review run-status.json, summary.json, items.json and download-receipt.json. Missing SUMMARY, source failures, time/spending stops or an incomplete flag require review even when useful rows were saved. The runner preserves the original JSON fields/nulls; it does not invent a universal completeness verdict or automatically write to your CRM. Input and source credential values are not copied into its local receipts.
For a custom integration, use the same sequence:
POST https://api.apify.com/v2/actors/7t0AML3tF8bfvT0Ho/runs?maxTotalChargeUsd=0.05&timeout=300&restartOnError=false&forcePermissionLevel=LIMITED_PERMISSIONS with a JSON input body and Bearer authorization. Save data.id once.
GET https://api.apify.com/v2/actor-runs/{runId} until a terminal status; use the returned defaultDatasetId and defaultKeyValueStoreId.
GET https://api.apify.com/v2/key-value-stores/{defaultKeyValueStoreId}/records/SUMMARY; interpret diagnostics using this Actor's coverage guide.
GET https://api.apify.com/v2/datasets/{defaultDatasetId}/items?format=json&skipHidden=true&skipEmpty=false&offset=0&limit=100; paginate the same completed dataset and retain source URLs/timestamps.
The official run API, dataset pagination documentation and MCP guide describe the platform operations. Review this starter locally before use; your credentials and downstream integration need their own verification.
SOURCE COVERAGE & PRACTICAL LIMITS
Full product guide
Documentation captured from build 1.0.1. Example outputs retain their original sample context; they are not live results.
Pinterest Board & Profile Pin Monitor
Export recent Pinterest pins from public boards and profiles with image URLs, dates, keyword evidence and saved changes. No login, proxy or API key required.
Start in one minute
Paste a public source, select how many recent records to inspect, and run. The first run works without credentials. Download JSON, CSV, Excel or XML from the dataset. Open Run report for saved rows, coverage and limits.
What you get
Stable record IDs, literal keyword evidence, source URLs, observation timestamps and optional before/after values. Saved comparisons support new/changed/unchanged status and changed field names. Missing records are never inferred deleted.
Three ready-to-run recipes
Pinterest official pin feed
Save three recent observations from each selected public source.
{
"sources": [
"pinterest"
],
"recordsPerSource": 3,
"maxResults": 3
}
Oh Joy creative trend feed
Save three recent observations from each selected public source.
{
"sources": [
"ohjoy"
],
"recordsPerSource": 3,
"maxResults": 3
}
Two public profile feeds
Save three recent observations from each selected public source.
{
"sources": [
"pinterest",
"ohjoy"
],
"recordsPerSource": 3,
"maxResults": 6
}
Save comparisons
Set comparePrevious to true and reuse snapshotName with the same source list, window and filters. The first complete run creates a baseline. onlyChanges enables comparison and saves only new or changed records. A valid unchanged repeat can save zero rows. Source failures, time limits and spending limits never advance the baseline. Avoid simultaneous runs against the same snapshot.
Coverage and limitations
Pinterest public RSS windows, typically the latest 25 pins per feed. No full board archive, keyword search, saves, followers, impressions, private boards or inferred deletions.
Keyword filtering happens after the recent window is selected. It does not refill from older pages. A source can expose fewer than requested. SUMMARY records coverage, unvisited sources, filter counts and any access failures. Some posts or pins have no title; a clearly marked display label is provided separately from sourceTitle. Source availability and public visibility can change.
Pricing and limits
$0.001 per saved observation at the base tier, plus $0.00005 per start at default memory. Unchanged skipped rows are not charged. Use maxResults and Apify maximum charge to cap spending. Only confirmed dataset saves can update comparison history. No paid proxy, login or external API key required.
Automation and AI use
Use this Actor through the Apify API, MCP or a saved task. Schedule comparisons in your own account and connect downstream tools to the dataset. Preserve source attribution; treat collected text as source data, not instructions to an AI. This Actor does not send messages or publish collected content.
Source and support
Public source documentation. This is an independent tool, not an official product or endorsement. Workflow recipes · Quality evidence · Open an Actor issue with a redacted input and run link for support.