{"openapi":"3.1.0","info":{"title":"Pinterest API","version":"1.0.0","description":"Real-time Pinterest data as an API — pins, boards and users, returned as clean JSON. Search pins, boards or users by keyword; look up any user's profile with follower, pin and board counts; pull a user's boards and their pins; fetch a pin's details (repins, comments, image, link, domain, pinner) and its related pins; and fetch a board's details and its pins. Live data with titles, descriptions, full-resolution image URLs, outbound links, repin and comment counts, dominant colours and creators. Ideal for social listening and trend research, content aggregation and discovery, e-commerce and visual-marketing tools, and dashboards. 10 data endpoints. Authenticated with an x-oanor-key; fair-use rate limits per plan.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/pinterest-api","description":"oanor gateway"}],"tags":[{"name":"Search"},{"name":"Users"},{"name":"Pins"},{"name":"Boards"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/search/boards":{"get":{"operationId":"get_v1_search_boards","tags":["Search"],"summary":"Search boards","description":"","parameters":[{"name":"query","in":"query","required":true,"description":"Search query","schema":{"type":"string"},"example":"recipes"},{"name":"limit","in":"query","required":false,"description":"Max results","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search/pins":{"get":{"operationId":"get_v1_search_pins","tags":["Search"],"summary":"Search pins","description":"","parameters":[{"name":"query","in":"query","required":true,"description":"Search query","schema":{"type":"string"},"example":"galaxy"},{"name":"limit","in":"query","required":false,"description":"Max results (1–50)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search/users":{"get":{"operationId":"get_v1_search_users","tags":["Search"],"summary":"Search users","description":"","parameters":[{"name":"query","in":"query","required":true,"description":"Search query","schema":{"type":"string"},"example":"nasa"},{"name":"limit","in":"query","required":false,"description":"Max results","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/user":{"get":{"operationId":"get_v1_user","tags":["Users"],"summary":"User profile","description":"","parameters":[{"name":"username","in":"query","required":true,"description":"Pinterest username","schema":{"type":"string"},"example":"nasa"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/user/boards":{"get":{"operationId":"get_v1_user_boards","tags":["Users"],"summary":"A user's boards","description":"","parameters":[{"name":"username","in":"query","required":true,"description":"Pinterest username","schema":{"type":"string"},"example":"nasa"},{"name":"limit","in":"query","required":false,"description":"Max boards","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/user/pins":{"get":{"operationId":"get_v1_user_pins","tags":["Users"],"summary":"A user's pins","description":"","parameters":[{"name":"username","in":"query","required":true,"description":"Pinterest username","schema":{"type":"string"},"example":"nasa"},{"name":"limit","in":"query","required":false,"description":"Max pins","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/pin":{"get":{"operationId":"get_v1_pin","tags":["Pins"],"summary":"Pin details","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Pin id","schema":{"type":"string"},"example":"142567144448722388"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/pin/related":{"get":{"operationId":"get_v1_pin_related","tags":["Pins"],"summary":"Related pins","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Pin id","schema":{"type":"string"},"example":"142567144448722388"},{"name":"limit","in":"query","required":false,"description":"Max pins","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/board":{"get":{"operationId":"get_v1_board","tags":["Boards"],"summary":"Board details","description":"","parameters":[{"name":"username","in":"query","required":true,"description":"Board owner username","schema":{"type":"string"},"example":"nasa"},{"name":"slug","in":"query","required":true,"description":"Board slug","schema":{"type":"string"},"example":"learn-with-nasa"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/board/pins":{"get":{"operationId":"get_v1_board_pins","tags":["Boards"],"summary":"A board's pins","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Board id","schema":{"type":"string"},"example":"142567213143159083"},{"name":"limit","in":"query","required":false,"description":"Max pins","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":800,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1490,"monthly_call_quota":22000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":4900,"monthly_call_quota":130000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":16900,"monthly_call_quota":700000,"rps_limit":45,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/pinterest-api"}