> ## Documentation Index
> Fetch the complete documentation index at: https://docs.liquid.tf/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Listings

> Create one or more marketplace listings

## Overview

Creates marketplace listings for your items. You can create up to 100 listings in a single request.

## Authentication

<ParamField header="X-API-Key" type="string" required>
  Your site API key
</ParamField>

## Rate Limit

**5 requests per minute**

## Request Body

<ParamField body="items" type="array" required>
  Array of items to list (max 100 items)

  <Expandable title="Item Object">
    <ParamField body="asset_id" type="string" required>
      Steam asset ID of the item
    </ParamField>

    <ParamField body="price" type="integer" required>
      Listing price in cents
    </ParamField>

    <ParamField body="promoted" type="integer" required>
      Promotion status: `0` = not promoted, `1` = promoted
    </ParamField>

    <ParamField body="game" type="string" required>
      Game app ID (use `"440"` for Team Fortress 2)
    </ParamField>

    <ParamField body="user_note" type="string">
      Custom note to display on the listing (max 180 characters). Visible to buyers.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="multiaccount_proxy" type="string">
  Steam ID of a linked account to associate with these listings. When set, the listing's automation status will be determined by that linked account's user agent instead of the main account's.
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Returns `true` if listings were successfully created
</ResponseField>

<ResponseField name="created_listings" type="array">
  Array of created listing objects

  <Expandable title="Listing Object">
    <ResponseField name="listing_id" type="string">
      MongoDB ObjectId of the created listing
    </ResponseField>

    <ResponseField name="sku" type="string">
      Item SKU (e.g., `"5021;6"`)
    </ResponseField>

    <ResponseField name="asset_id" type="string">
      Steam asset ID
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.liquid.tf/api/dev/create_listing" \
    -H "Content-Type: application/json" \
    -H "X-API-Key: YOUR_SITE_API_KEY" \
    -d '{
      "items": [{
        "asset_id": "12321312414",
        "price": 16500,
        "promoted": 0,
        "game": "440",
        "user_note": "Great condition! Fast delivery"
      }]
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.liquid.tf/api/dev/create_listing', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': 'YOUR_SITE_API_KEY'
    },
    body: JSON.stringify({
      items: [{
        asset_id: '12321312414',
        price: 16500,
        promoted: 0,
        game: '440',
        user_note: 'Great condition!'
      }]
    })
  });

  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      'https://api.liquid.tf/api/dev/create_listing',
      headers={'X-API-Key': 'YOUR_SITE_API_KEY'},
      json={
          'items': [{
              'asset_id': '12321312414',
              'price': 16500,
              'promoted': 0,
              'game': '440',
              'user_note': 'Great condition!'
          }]
      }
  )

  data = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "created_listings": [
      {
        "listing_id": "66f2b3f4c4a1f7b9a8a4f123",
        "sku": "5021;6",
        "asset_id": "12321312414"
      }
    ]
  }
  ```
</ResponseExample>

## Batch Limit

<Card title="Max 100 items per request" icon="layer-group">
  To create more than 100 listings, make multiple API calls.
</Card>

## Notes

<AccordionGroup>
  <Accordion title="Pricing">
    All prices are in **cents**. For example, \$1.65 = 16500 cents.
  </Accordion>

  <Accordion title="Promotion">
    Set `promoted: 1` to feature your listing. Promoted listings appear first in search results.
  </Accordion>

  <Accordion title="User Notes">
    User notes are visible to all buyers and can help provide additional context about your item (e.g., "Craft #42", "Clean history").
  </Accordion>

  <Accordion title="Linked Accounts">
    Use `multiaccount_proxy` to manage listings across multiple Steam accounts from one API key.
  </Accordion>
</AccordionGroup>