Pinterest Scraper

Description

The Pinterest Scraper API allows you to extract various types of information from Pinterest, including posts and profiles. This powerful tool enables developers to integrate Pinterest data into their applications for visual content discovery, trend analysis, and more.

How to Use

To use the Pinterest Scraper API, you'll need to authenticate your requests using your API key. The API provides several endpoints for retrieving different types of information:

Endpoints

• POST https://taskagi.net/api/social-media/pinterest-scraper/posts - Retrieve post information by URL
• POST https://taskagi.net/api/social-media/pinterest-scraper/posts-by-keyword - Discover posts by keyword
• POST https://taskagi.net/api/social-media/pinterest-scraper/posts-by-profile - Retrieve posts by profile URL
• POST https://taskagi.net/api/social-media/pinterest-scraper/profiles - Retrieve profile information by URL
• POST https://taskagi.net/api/social-media/pinterest-scraper/profiles-by-keyword - Discover profiles by keyword

Authentication

Include your API key in the request headers:

Authorization: Bearer YOUR_API_KEY

Request Body

The request body should be a JSON object with the following structure, depending on the endpoint:

// For URL-based endpoints (posts, profiles)
{
    "url": "https://www.pinterest.com/pin/123456789/"
}

// For keyword-based endpoints
{
    "keyword": "home decor"
}

// For posts-by-profile endpoint
{
    "url": "https://www.pinterest.com/username/"
}

Rate Limiting

Please note that usage is subject to rate limiting. Refer to your plan details for specific limits.

Expected Response

While we don't have a specific sample response, you can generally expect the API to return data including:

• For posts: image URL, title, description, number of saves, comments, creator information
• For profiles: username, full name, bio, follower count, following count, board count
• For keyword searches: list of relevant posts or profiles with basic information

The exact structure and fields may vary based on the information available for each type of content.

import requests
import json

# Your API Key
api_key = 'YOUR_API_KEY'

# API Endpoint for post information
url = 'https://taskagi.net/api/social-media/pinterest-scraper/posts'

# Headers
headers = {
    'Authorization': f'Bearer {api_key}',
    'Content-Type': 'application/json'
}

# Request Body
data = {
    'url': 'https://www.pinterest.com/pin/123456789/'
}

# Send POST request
response = requests.post(url, headers=headers, json=data)

# Check if the request was successful
if response.status_code == 200:
    # Parse the JSON response
    post_info = response.json()
    
    # Print the post information
    print(json.dumps(post_info, indent=2))
else:
    print(f"Error: {response.status_code}")
    print(response.text)

# Example for profiles by keyword
url = 'https://taskagi.net/api/social-media/pinterest-scraper/profiles-by-keyword'

# Request Body for keyword search
data = {
    'keyword': 'home decor'
}

# Send POST request
response = requests.post(url, headers=headers, json=data)

# Check if the request was successful
if response.status_code == 200:
    # Parse the JSON response
    profiles = response.json()
    
    # Print the profiles
    print(json.dumps(profiles, indent=2))
else:
    print(f"Error: {response.status_code}")
    print(response.text)