from py3pin.Pinterest import Pinterest

pinterest = Pinterest(
    email='you@email.com',
    password='your_password',
    username='your_username',
    cred_root='cred_root'       # cookies stored here, created automatically
)

# Login once — cookies are saved and reused automatically (~15 days)
pinterest.login()

# Pin an image
pinterest.pin(
    board_id='123456789',
    image_url='https://example.com/image.jpg',
    title='My Pin',
    description='Pinned with py3-pinterest'
)

pinterest.upload_pin(
    board_id='123456789',
    image_file='photo.jpg',
    title='My Pin',
    description='Uploaded with py3-pinterest',
    link='https://example.com'
)

pinterest.upload_video_pin(
    board_id='123456789',
    video_file='video.mov',
    title='My Video Pin',
    description='Video uploaded with py3-pinterest',
    link='https://example.com'
)

pinterest.pin(
    board_id='123456789',
    image_url='https://example.com/image.jpg',
    title='Pin Title',
    description='Pin description'
)

pinterest.repin(board_id='board_id', pin_id='pin_id')

pinterest.load_pin(pin_id='pin_id')         # Get full pin data
pinterest.delete_pin(pin_id='pin_id')        # Delete a pin
pinterest.get_pinnable_images(url='...')      # Get pinnable images from any website

# List boards
boards = pinterest.boards(username='someone')          # One page
boards = pinterest.boards_all(username='someone')       # All boards

# Create & delete
pinterest.create_board(name='My Board', description='A new board')
pinterest.delete_board(board_id='board_id')

# Board feed — all pins in a board
pins = pinterest.board_feed(board_id='board_id', reset_bookmark=True)

# Recommendations ("More ideas")
recs = pinterest.board_recommendations(board_id='board_id', reset_bookmark=True)

pinterest.create_board_section(board_id='board_id', section_name='My Section')
pinterest.delete_board_section(section_id='section_id')
pinterest.get_board_sections(board_id='board_id')       # Supports page_size up to 100
pinterest.get_section_pins(section_id='section_id')

# Pin directly to a section
pinterest.pin(board_id='board_id', section_id='section_id', image_url='...')
pinterest.upload_pin(board_id='board_id', section_id='section_id', image_file='...')

pinterest.get_user_overview(username='someone')
pinterest.get_user_pins(username='someone', reset_bookmark=True)

# Users
pinterest.follow_user(user_id='user_id')
pinterest.unfollow_user(user_id='user_id')

# Boards
pinterest.follow_board(board_id='board_id')
pinterest.unfollow_board(board_id='board_id')

# Get following & followers (batched)
following = pinterest.get_following(username='someone', reset_bookmark=True)
followers = pinterest.get_user_followers(username='someone', reset_bookmark=True)

# Get all at once
all_following = pinterest.get_following_all(username='someone')
all_followers = pinterest.get_user_followers_all(username='someone')

# Scopes: pins, buyable_pins, my_pins, videos, boards
results = pinterest.search(scope='pins', query='home decor', reset_bookmark=True)

pin_data = pinterest.load_pin(pin_id='pin_id')
results = pinterest.visual_search(pin_data, x=10, y=50, w=100, h=100)

pinterest.type_ahead(term='apple')

pinterest.comment(pin_id='pin_id', text='Nice pin!')
pinterest.delete_comment(pin_id='pin_id', comment_id='comment_id')
pinterest.get_comments(pin_id='pin_id', reset_bookmark=True)

conversations = pinterest.get_conversations()
messages = pinterest.load_conversation(conversation_id='conv_id')

# Send text, pin, or both
pinterest.send_message(conversation_id='conv_id', message='Hey!')
pinterest.send_message(conversation_id='conv_id', pin_id='pin_id')
pinterest.send_message(conversation_id='conv_id', pin_id='pin_id', message='Check this out')

pins = pinterest.home_feed(reset_bookmark=True)

all_pins = []
batch = pinterest.board_feed(board_id='board_id', reset_bookmark=True)
while batch:
    all_pins += batch
    batch = pinterest.board_feed(board_id='board_id')

print(f'Total: {len(all_pins)} pins')

proxies = {"http": "http://user:pass@proxy_ip:port"}
pinterest = Pinterest(
    email='...', password='...', username='...',
    cred_root='cred_root', proxies=proxies
)

pinterest.login(proxy='ip:port')

pinterest.login()                           # Headless Chrome
pinterest.login(headless=False)             # Visible browser (for debugging)
pinterest.login(proxy='ip:port')            # Through a proxy
pinterest.login(lang='en')                  # Set browser language
pinterest.logout()

resp = pinterest.upload_pin(board_id='...', image_file='photo.jpg', title='Test')
data = resp.json()

pin_id = data["resource_response"]["data"]["id"]
board_id = data["resource_response"]["data"]["board"]["id"]