Search pins
Search public Pinterest pins or videos by keyword. Send bookmark to continue the results.
1 credit / requestBilled only on success
Authorization
ApiKeyAuth x-api-key<token>
In: header
Query Parameters
query*string
Search keywords.
Length
1 <= lengthscope?string
Search scope. 'pins' and 'videos' are verified working logged out; board/user/shopping scopes are unverified (see core/research/pinterest/04-search.md) and not exposed here yet.
Default
"pins"Value in
- "pins"
- "videos"
bookmark?string
Opaque pagination cursor from a previous response's bookmark field. Omit for the first page.
curl -X GET "https://example.com/v2/pinterest/search/pins?query=coffee" \ -H "x-api-key: YOUR_API_KEY"{ "data": { "results": [ { "id": "1136384918502158229", "title": "Coffee, Calm & Quiet Moments", "dominant_color": "#4a311b", "image_url": "https://i.pinimg.com/originals/93/dd/2b/93dd2bdddfb220ed48829dc7269d66aa.jpg" } ], "bookmark": "Y2JVSG81V2sxcmNHRlpWM1J5VFVad1ZsWlVWbFJXTVVZMldWVlZNV0pIU2toa1JFNVhVbTFvTTFWWGN6RldhemxYVm14T1YxSnNjRkJYVm1ONFlXc3hSMVZzYkdwU1ZuQlFWbXhvVTJWV1pISlhhM1JYVm10V05sVldVbE5YUjBWNFUydDRXbUpHVlhoV01GcFRaRVV4Vms5WGFHbFNia0l6Vm10a01GVXlSblJXYTFwUFZsZG9XVlpyV21GVlJsSllaVWRHYWxadFVsbFpNRlpQWVZaYWRHUjZTbGRTYkVwVVYxWmFZVkl5VGtsVmJHaFhUVEJLV0ZaSGRGWk5WMDVZVW1wYVZXRjZWbGhVVlZwWFRsWmFTR05GZEZaaVZscFhWRlpvVTFkSFNsbFZhemxYWVRKU2NWcFdXbE5YVjA1SVRsZDRVMkpyU2xwV1YzaFRWakZzV0ZKdVVsVmhiRnBXV1ZSR1MxTXhjRlpYYm1SWFZtczFNRmt3VlRGaFIwVjNWbXBPVjAxV2NIWlVhMXBTWlVaT2MxcEhSbE5TTWswMVdtdGFWMU5YU2paVmJYaFRWMGRvUmxkc1ZsZGhNV1J6VjFod2FGSkdjRmxaYTJSdVpXeHdWbFpZYUU5aVIxSldWVmR6TVdKSFJYZFdXR2hYVWtWYVZGVnRjekZXYXpGWlVtMUdiR0pGY0ZCWGJHUXdWbXN4VjFSWWJHdFNNMUpYV1d0YVMxSldhM2RWYlRsYVZtdHdTVmt6Y0VOV1YwcEhVMnRPWVZZelRqUlpNVnBMVmxaU2NrOVhhR2hOYmxGNlZtcEplR1F5VG5SV2ExcFFWbFphVjFsc1pEUlZSbXh6VjJ4a1QySkdTakZaTUZacllWWktkVkZxUWxkaVZFWXpWa2N4VjJNeVNrVlViRlpwVmtWYVZWZFdWbUZrTVZwWFYyeHNZVkpyU2xSVVZtUXpUV3hhUjFkc1RsTmhla1pYVkRGYWIxZEdaRWxSYkVKaFZqTlNSMVJWV2xOWFYwNUlVbTFzVjFaR1dqUldhMXBUVWpGU2MxZHJhR3BOTWxKV1dXdGFTMWxXVW5KWGJtUllVbXhhV2xsVldrTldSazVJWVVaR1YxWXphR2haVkVFMVVXeENWVTFVYUU1V1JUQjVWR3RTVG1Rd09WVmhNMmhRVmtWck1GUXdVazVsUlRsVVkwVm9WbFpZWkhoYWExSlRZbFp3VlZKVVRscE5hekI1Vkcxd1RrMUZNVFpoZWs1UFZqQXdkMVJ0Y0VKTk1ERlZZWHBDWVdGdFVuSlVXSEJYWWtad1JXRjZRazVTTURFMlYxaHdUMkpWTlZWU2JXeE9Va2RTY0ZSV1VtcGtNWEJWVVZoa1VGSkdSak5YVjNCWFlVWndjVmRZWkdGaGJFVXdWRmR3WVU5R1VuSldiR2h0VVZRd09XWkVSWHBPYWxGNlRVUnJOVTFVYTNsUFJHZDZUVlJyY1ZJeFJrMUxibmMxVFhwYWJFNVVUbWhPYW1oclQxUlpOVmxVVFRWTmJVWnNUVmRGTVU1SFZtaE9WRTB3V1hwbmVVNXFWbXBOVkdoclRsUk9hRnBYV20xWmFtTjNUbnBXYWxwRVRtbE9hbWQ0V21wa2JWbFhUbXhPUjFwb1prVTFSbFl6ZHowPXxVSG80Y2sxV1VtbGFTRlY2VkZoQ2NtUjZNV1pOVkdobVRGUkdPRTFVVFRKT1JFMTNUMVJyZUU5VVNUUlBSRTE0VDFOd1NGVlZkM0ZtUkU1cFRVZFNiVmx0U1hsT1JFRjVXWHByTTFwVVRtdE9NazB4VFhwUk5FMUViRzFPZW1Nd1RXcFZlVTlVYUd0TlJGWnJXa1JDYkZwVVNtbGFSMFYzV2xSWk1rMVhVWHBaYlZFelRrUlJkMDlIV210TmFsSTRWR3RXV0daQlBUMD18Tm9uZXwxMzY0MzA5OTE5Mjg4MzE5KkdRTCp8N2MwZDY1ZWJiZDBlOTNjYmYwY2M0YjAwODcxZTE5MGU4ZGRkYTAzYzg5MTc2NmI5MTE2ZmZmNzIyYzc0MTYwMHxORVd8" }}