Skip to main content
POST
/
v1
/
tasks
Add Tasks
curl --request POST \
  --url https://api.lobstr.io/v1/tasks \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>'

Documentation Index

Fetch the complete documentation index at: https://docs.lobstr.io/llms.txt

Use this file to discover all available pages before exploring further.

Add Vinted catalog search URLs to scrape product listings from the marketplace. The scraper extracts product details, pricing, and seller information. Use Vinted’s catalog URL with search filters applied. You can filter by category, brand, size, price range, and sort order directly in the URL.

​
Headers

​
Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY
​
Content-Type
string
required
Request body format. Value: application/json

​
Request Body

FieldTypeRequiredDescription
squidstringYesHash of your squid configured with the Vinted Products Scraper crawler
tasksarrayYesArray of task objects, each containing a url field

​
Task Object

FieldTypeRequiredDescription
urlstringYesVinted catalog URL (e.g., https://www.vinted.fr/catalog?search_text=nike&order=newest_first)
Apply filters on Vinted first, then copy the URL. All filter parameters will be preserved in the URL.
Vinted operates country-specific sites (vinted.fr, vinted.de, vinted.es, etc.). Use the appropriate domain for your target market.

​
Code Examples

curl -X POST "https://api.lobstr.io/v1/tasks" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "squid": "YOUR_SQUID_HASH",
    "tasks": [
      {
        "url": "https://www.vinted.fr/catalog?search_text=nike&order=newest_first"
      }
    ]
  }'

​
Response

200
{
  "duplicated_count": 0,
  "tasks": [
    {
      "id": "82367f24d9450b2222080eed91662968",
      "created_at": "2025-07-17T09:06:47.287893",
      "is_active": true,
      "params": {
        "url": "https://www.vinted.fr/catalog?search_text=nike&order=newest_first"
      },
      "module": 115,
      "object": "task"
    }
  ]
}