# Pinterest User Info

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/pinterest/user/info` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/pinterest-user-info |

## Description

Access Pinterest user profiles and analytics for targeted marketing and audience insights.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/pinterest/user/info' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lookup by username: amandagabriella

```json
{
  "name": "Amanda Stefenelli",
  "avatar": "https://i.pinimg.com/280x280_RS/a2/74/63/a27463b3901565bd4fc1758227c30a6f.jpg",
  "website": null,
  "pin_count": 117,
  "created_at": "2012-01-19T22:21:18.000Z",
  "board_count": 10,
  "description": null,
  "is_verified": false,
  "profile_cover": null,
  "follower_count": 84,
  "domain_verified": false
}
```

### Lookup verified creator profile

```json
{
  "name": "Jane Creator",
  "avatar": "https://i.pinimg.com/280x280_RS/example.jpg",
  "website": "https://www.example.com",
  "pin_count": 4827,
  "created_at": "2015-06-03T10:00:00.000Z",
  "board_count": 47,
  "description": "Interior design & home decor inspiration.",
  "is_verified": true,
  "profile_cover": "https://i.pinimg.com/1200x/_example_cover.jpg",
  "follower_count": 125400,
  "domain_verified": true
}
```

## Documentation

## Overview
Retrieve public profile data from any Pinterest account using a URL or username. Returns display name, avatar, bio, pin and board counts, follower count, linked website, and verification status.

## Quickstart
```
GET https://api.piloterr.com/v2/pinterest/user/info?query=amandagabriella
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Pinterest profile URL or username |

## Main use cases
- Identify and profile Pinterest creators and influencers for brand partnerships
- Enrich influencer marketing databases with Pinterest-specific metrics
- Monitor follower growth and pin activity of competitor accounts over time
- Build audience research tools aggregating cross-platform social media profiles