Pinmetric API Documentation

Endpoint

Simple GET request with a single required query parameter.

GET

https://pinmetric.webilim.com/api/check?keyword=chicken recipes

Request

Field	Location	Required	Description
`keyword`	Query string	Yes	The exact Pinterest keyword you want to check.

Responses

200 OK Returns keyword details, related keywords, and idea history.

400 Bad Request Returned when keyword is missing.

404 Not Found Returned when the keyword does not exist in the database.

Sample Response

{
  "Keyword": "chicken recipes",
  "SearchVolume": 18100,
  "IdeaId": "949806337612",
  "RelatedKeywords": [
    {
      "Keyword": "easy chicken recipes",
      "IdeaId": "123456789012"
    },
    {
      "Keyword": "healthy chicken recipes",
      "IdeaId": "123456789013"
    }
  ],
  "IdeaHistory": [
    {
      "Date": "2026-01-01T00:00:00",
      "Volume": 16500
    },
    {
      "Date": "2026-02-01T00:00:00",
      "Volume": 17400
    },
    {
      "Date": "2026-03-01T00:00:00",
      "Volume": 18100
    }
  ]
}