Pinterest Search API
Search Pinterest pins by keyword: title, description, image, dominant colour, the destination link and the pinner. Cursor-paginated. Costs 1 credit per request.
POST/api/v1/pinterest/search
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsonquerystringrequiredSearch terms.
Example: home decor ideas
cursorstringOpaque pagination cursor from a previous response. Omit for the first page; when the response's cursor is null the feed is exhausted.
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
result = client.pinterest.search("home decor ideas")
print(result)Response
"query": "home decor ideas",
"count": 18,
"cursor": "Y2JVSG81V2sxcmNHRlpWM1J5VFVad1ZsWlVWbFJXTVVreVZXMTRRMVV4U2xkV2FsWlhVbTFTTTFZeWMzaGphekZaVW14d2JHSkdjRkJYYkdONFlUQXdlRlZZWkZaaGVsWnpWV3hvVTJWV1pISlhhM1JYVm10V05sVldVbE5YUjBwVlVtdG9XbFpGV25wWk1WcHlaVzFPU0ZKdGFHbFdhM0F6Vm1wSmVHUXlSWGxUYkdScFUwWktWbFpyV2t0aFJscHhVbTVrYWsxWFVscFpNRlpo..."
},
"response_time": 4875
}