# Poshmark Scraper (`getdataforme/my-poshmark-actor`)

A Poshmark scraper is a tool that automatically extracts product data (prices, descriptions, photos, seller info) from Poshmark's website. It helps track prices, monitor competitors, and gather market insights for resellers and businesses selling on the platform.

- **URL**: https://beta-securitybyobscurity.apify.com/getdataforme/my-poshmark-actor.md
- **Developed by:** [GetDataForMe](https://beta-securitybyobscurity.apify.com/getdataforme) (community)
- **Categories:** E-commerce
- **Stats:** 23 total users, 4 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

$15.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.
You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

# README

## Poshmark Scraper Documentation

### Overview

The **Poshmark Scraper** is an Apify actor designed to extract detailed product information from Poshmark.com. By providing a list of product URLs as input, the scraper retrieves essential details, including the product name, price, image URL, and description.

***

### Input Configuration

The input for the Poshmark Scraper should be a JSON object containing a single key, `urls`, which is an array of Poshmark product URLs.

#### Input Example

```json
{
    "urls": [
        "https://poshmark.com/listing/UGG-Metallic-Silver-Stars-Slip-On-Sneaker-Shoes-Spot-on-Side-669d65f3dcd5a5f34227f42a"
    ]
}
```

***

### Output

The scraper returns a JSON array where each object contains the following fields:

- `product_name`: The name of the product.
- `product_price`: The price of the product, including currency.
- `product_image`: The URL of the product image.
- `product_url`: The original product URL provided in the input.
- `description`: The detailed description of the product.
- `sku`: The unique identifier for the product.

#### Output Example

```json
[
    {
        "product_name": "✴️ |•UGG•| Metallic Silver Stars Slip On Sneaker Shoes *Spot on Side*",
        "product_price": "27.0 USD",
        "product_image": "https://di2ponv0v5otw.cloudfront.net/posts/2024/07/21/669d65f3dcd5a5f34227f42a/m_669d6d44c38372094f2fa21c.jpeg",
        "product_url": "https://poshmark.com/listing/UGG-Metallic-Silver-Stars-Slip-On-Sneaker-Shoes-Spot-on-Side-669d65f3dcd5a5f34227f42a",
        "description": "They are so PRETTY!!! I bought them perfect, then had to store them briefly and apparently the vintage pink Adidas, sneaked a little color on them.  So, they are perfecto, but for that. So priced accordingly. Size 10. Metallic silver with white stars, soft cushy insole, padded ankle. Please, always be sure to look closely at all my pretty photos for details and condition. Pricing reflects the many hours, miles, dollars &amp; energy, I put in to hunting &amp; caring for hand picked items. Reminder, Posh takes 20%. Bundle any 3 or more items for an automatic 10% discount (&#x27;add to bundle&#x27; is under &#x27;pay with apple pay&#x27;). Any shipping discount via offer is paid out by me. Shop with confidence: 5⭐️ &#x27;Top Seller.&#x27; 5000+ Sales. Thousands of &#x27;Love Notes.&#x27; Average ship time 1.1 Days. You&#x27;ll be supporting a (non-smoking) small business gal battling chronic illness, along with her rescue pet family. 🥰",
        "sku": "669d65f3dcd5a5f34227f42a"
    }
]
```

***

### Usage Instructions

1. **Input Preparation**: Create a JSON file containing the `urls` array with the product URLs you want to scrape.
2. **Actor Execution**: Run the Poshmark Scraper actor on the Apify platform, providing the input JSON file.
3. **Retrieve Results**: After the execution, download the output JSON containing the scraped data.

***

### Support

For custom outputs, simplified formats, or to report any issues, please contact:

- **Email**: <support@getdataforme.com>
- **Contact Form**: <https://getdataforme.com/contact/>

When reaching out, please include a clear subject line and detailed description of your request or issue.

***

Thank you for using the Poshmark Scraper!

# Actor input Schema

## `urls` (type: `array`):

A list of URLs of the web pages you want to scrape data from.

## Actor input object example

```json
{
  "urls": [
    "https://poshmark.com/listing/Gray-Canvas-Sling-Bag-Backpack-Small-Crossbody-Shoulder-Bag-Mens-Womens-Teen-67d74bbbdc327d978e5cafd4"
  ]
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://poshmark.com/listing/Gray-Canvas-Sling-Bag-Backpack-Small-Crossbody-Shoulder-Bag-Mens-Womens-Teen-67d74bbbdc327d978e5cafd4"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("getdataforme/my-poshmark-actor").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "urls": ["https://poshmark.com/listing/Gray-Canvas-Sling-Bag-Backpack-Small-Crossbody-Shoulder-Bag-Mens-Womens-Teen-67d74bbbdc327d978e5cafd4"] }

# Run the Actor and wait for it to finish
run = client.actor("getdataforme/my-poshmark-actor").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://poshmark.com/listing/Gray-Canvas-Sling-Bag-Backpack-Small-Crossbody-Shoulder-Bag-Mens-Womens-Teen-67d74bbbdc327d978e5cafd4"
  ]
}' |
apify call getdataforme/my-poshmark-actor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=getdataforme/my-poshmark-actor",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Poshmark Scraper",
        "description": "A Poshmark scraper is a tool that automatically extracts product data (prices, descriptions, photos, seller info) from Poshmark's website. It helps track prices, monitor competitors, and gather market insights for resellers and businesses selling on the platform.",
        "version": "0.0",
        "x-build-id": "ZkzVW3ef13HAaacrZ"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/getdataforme~my-poshmark-actor/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-getdataforme-my-poshmark-actor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/getdataforme~my-poshmark-actor/runs": {
            "post": {
                "operationId": "runs-sync-getdataforme-my-poshmark-actor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/getdataforme~my-poshmark-actor/run-sync": {
            "post": {
                "operationId": "run-sync-getdataforme-my-poshmark-actor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "urls"
                ],
                "properties": {
                    "urls": {
                        "title": "List of URLs of the Poshmark pages",
                        "type": "array",
                        "description": "A list of URLs of the web pages you want to scrape data from.",
                        "items": {
                            "type": "string"
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
