PinBridge icon

PinBridge

Publish, schedule, and manage Pinterest workflows through the PinBridge API

Pin → List Imports

AI-generated

Summary

List bulk import jobs for pins, optionally filtering by import status and source type, and control the number of records returned.

Inputs

  • Return All — Whether to return all import job records or limit the number returned.
  • Limit — Maximum number of import job records to return when Return All is disabled (1-1000).
  • Import Status — Filter import jobs by processing status such as queued, processing, completed, completed with errors, or failed.
  • Import Source — Filter import jobs by source type, either JSON or CSV.

Output shape

a list of bulk import job objects, each containing details about the import job and its row-by-row results

If Return All is true, all import jobs matching the optional filters are returned; otherwise, up to Limit import jobs are returned. Errors are returned in the execution result if continueOnFail is enabled.

Examples

Example 1: Retrieve all pin import jobs with any status and source

Return All = true, Import Status = Any, Import Source = Any

Example 2: Retrieve up to 50 completed CSV import jobs

Return All = false, Limit = 50, Import Status = Completed, Import Source = CSV

Links

Discussion