Pinterest Image Search API

The Pinterest Image Search API allows users to search for images on Pinterest based on a query and retrieve a specified number of images.

Base URL

"https://openapi-idk8.onrender.com"

Endpoint

GET `/pinterest`

Searches for images on Pinterest based on a query.

Parameters

• search (required): The search query for images.
• count (optional): The number of images to retrieve (default: 10, max: 40).

Sample Request

"https://openapi-idk8.onrender.com/pinterest?search=cat&count=10"

Sample Response

{
  "api_name": "Pinterest Image Search",
  "author": "OpenAPI",
  "api_type": "General",
  "searchQuery": "cat",
  "count": 10,
  "images": [
    "https://i.pinimg.com/736x/cf/c2/5b/cfc25b552003ba8881db6e678bda0b1b.jpg",
    "https://i.pinimg.com/736x/79/1b/3a/791b3a33b2ce3320ca1817310ad9ae58.jpg",
    "https://i.pinimg.com/736x/8b/7d/0c/8b7d0c88227abf5a237870b047677b4b.jpg",
    "https://i.pinimg.com/736x/dc/92/1e/dc921ec2e07f9437dc51f2a10694578d.jpg",
    "https://i.pinimg.com/736x/02/ec/00/02ec00bc786e0db0e11f7a5ff0c3cd5a.jpg",
    "https://i.pinimg.com/736x/92/fa/8a/92fa8af50f56937e067481289b9d8af1.jpg",
    "https://i.pinimg.com/736x/35/91/02/359102065bcbcc5cfac4db0f8135b94e.jpg",
    "https://i.pinimg.com/736x/4a/58/c8/4a58c821206a4b7534de8b3d4ed6ac85.jpg",
    "https://i.pinimg.com/736x/6f/0c/7d/6f0c7dd736a49fef3d2c7ad9def7f87c.jpg",
    "https://i.pinimg.com/736x/7f/67/dc/7f67dcbefbe49a531c47bf3ee6e279e2.jpg"
  ]
}
    

Error Handling

400 Bad Request: Returned when the "search" parameter is missing or empty.

{ "error": "Search parameter is required." }

500 Internal Server Error: Returned for internal server errors during image retrieval.

{ "error": "Internal server error." }

Notes

• The API fetches images from Pinterest based on the provided search query.
• The maximum number of images that can be retrieved per request is 40.