OMomnisocials
Pinterest

Check a product Pin

Changed on

Check whether a Pin can be used in pinterest.product_tags before you create the post. Pass a Pin ID or a Pin link (https://www.pinterest.com/pin/<id>/; pin.it short links do not work). Returns { valid: true, pin_id, title, link, image_url } for a product Pin of the connected account, and { valid: false, reason } for a Pin that is not a product Pin, belongs to another account or does not exist. When the check cannot run (no Pinterest account, Pinterest did not answer, or Pinterest did not say if the Pin is a product Pin) it returns { valid: false, unverified: true }: the publish step is then the final check. The check does not look at the claimed-website rule; Pinterest applies that one at publish.

get/pinterest/products/validate

Request

  • Base URL
    https://api.omnisocials.com/v1
  • URL
    https://api.omnisocials.com/v1/pinterest/products/validate
  • Auth
    HTTP bearer

Query parameters

idstring required

Pin ID or Pin link of the product Pin.

Response

Check result

validboolean
pin_idstring nullable

The Pin ID read from id (null when id is not a Pin ID or link).

titlestring nullable
linkstring nullable
image_urlstring nullable
unverifiedboolean

The check could not run; the publish step will check.

reasonstring nullable

Why the Pin is not valid or could not be checked.

Changes