This website requires JavaScript and Cloudflare Turnstile to function properly.

API Documentation

Access our comprehensive API to integrate Pricempire's data into your applications

Authentication

To use our API, you need to authenticate your requests using your API key. Follow these steps:

  1. Create an account at Pricempire

    Login

  2. Subscribe to an API plan

    Choose a plan that fits your needs. Free tier available for testing.

  3. Get your API key

There are two ways to include your API key in your requests:

Method 1: Using Authorization Header (Recommended)

Add this header to your request: 

Authorization: Bearer your_api_key

Example using curl: 

curl -H "Authorization: Bearer your_api_key" https://api.pricempire.com/v4/paid/items/prices

Method 2: Using Query Parameter

Add this parameter to your request URL: 

?api_key=your_api_key

Example using curl: 

curl "https://api.pricempire.com/v4/paid/items/prices?api_key=your_api_key"

Important Notes

  • Replace your_api_key with your actual API key
  • Keep your API key secret and never share it publicly
  • If you're using the sandbox environment, use sandbox-api.pricempire.com instead
  • Need help? Join our Discord community

Query Builder

Select Endpoint

Item Prices

get
https://api.pricempire.com/v4/paid/items/prices

Quick Start 

GET https://api.pricempire.com/v4/paid/items/prices?app_id=730&sources=buff163,buff163_buy&currency=USD&avg=false&inflation_threshold=-1&metas=
Authorization: Bearer your_api_key
curl -X get "https://api.pricempire.com/v4/paid/items/prices?app_id=730&sources=buff163,buff163_buy&currency=USD&avg=false&inflation_threshold=-1&metas=" -H "Authorization: Bearer your_api_key"
const response = await fetch("GET https://api.pricempire.com/v4/paid/items/prices?app_id=730&sources=buff163,buff163_buy&currency=USD&avg=false&inflation_threshold=-1&metas=", {
    headers: {
        "Authorization": "Bearer your_api_key"
    }
});
const data = await response.json();
import requests

response = requests.get(
    "GET https://api.pricempire.com/v4/paid/items/prices?app_id=730&sources=buff163,buff163_buy&currency=USD&avg=false&inflation_threshold=-1&metas=",
    headers={"Authorization": "Bearer your_api_key"}
)
data = response.json()
const fetch = require('node-fetch');

async function fetchData() {
    const response = await fetch('GET https://api.pricempire.com/v4/paid/items/prices?app_id=730&sources=buff163,buff163_buy&currency=USD&avg=false&inflation_threshold=-1&metas=', {
        headers: {
            'Authorization': 'Bearer your_api_key'
        }
    });
    const data = await response.json();
    return data;
}

fetchData().then(data => {
    console.log(data);
}).catch(error => {
    console.error('Error:', error);
});
<?php

$url = 'GET https://api.pricempire.com/v4/paid/items/prices?app_id=730&sources=buff163,buff163_buy&currency=USD&avg=false&inflation_threshold=-1&metas=';
$headers = [
    'Authorization: Bearer your_api_key',
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

print_r($data);

Parameters

6 parameters
Name Type Required Default Description
app_idnumber (enum)No730The app_id of the game
sourcesarray Nobuff163, buff163_buyThe sources to get the prices from
currencystring (enum)NoUSDThe currency to get the prices in
avgboolean NofalseWhether to get the average prices or not
inflation_thresholdnumber No-1The inflation threshold to use (in percentage)
metasarray No[]The metas to get

Example Response

Status: 200Content-Type: application/json
[
  {
    "market_hash_name": "Sticker | FURIA | Rio 2022",
    "image": "/panorama/images/econ/stickers/rio2022/furi_png.png",
    "liquidity": 34,
    "count": 246,
    "rank": 19826,
    "prices": [
      {
        "price": 0,
        "count": 1461,
        "updated_at": "2024-10-11T10:26:43.128Z",
        "provider_key": "buff163",
        "meta": {
          "original_price": 38,
          "original_currency": "CNY",
          "rate": 0.1232323
        }
      },
      {
        "price": null,
        "count": null,
        "updated_at": null,
        "provider_key": "lootfarm"
      },
      {
        "price": 3,
        "count": 4340,
        "updated_at": "2024-10-12T13:16:06.929Z",
        "provider_key": "dmarket"
      }
    ]
  },
  {
    "market_hash_name": "SG 553 | Danger Close (Factory New)",
    "image": "/panorama/images/econ/default_generated/weapon_sg556_gs_sg553_over_heated_light_png.png",
    "liquidity": 98,
    "count": 67690,
    "rank": 9698,
    "prices": [
      {
        "price": 38,
        "count": 169,
        "updated_at": "2024-10-11T10:25:59.360Z",
        "provider_key": "buff163",
        "meta": {
          "original_price": 38,
          "original_currency": "CNY",
          "rate": 0.1232323
        }
      },
      {
        "price": 34,
        "count": 0,
        "updated_at": "2024-10-26T10:34:05.943Z",
        "provider_key": "lootfarm",
        "meta": null
      },
      {
        "price": 32,
        "count": 11,
        "updated_at": "2024-10-12T13:15:31.150Z",
        "provider_key": "dmarket"
      }
    ]
  }
]

Item Images

get
https://api.pricempire.com/v4/paid/items/images

Quick Start 

GET https://api.pricempire.com/v4/paid/items/images?app_id=123
Authorization: Bearer your_api_key
curl -X get "https://api.pricempire.com/v4/paid/items/images?app_id=123" -H "Authorization: Bearer your_api_key"
const response = await fetch("GET https://api.pricempire.com/v4/paid/items/images?app_id=123", {
    headers: {
        "Authorization": "Bearer your_api_key"
    }
});
const data = await response.json();
import requests

response = requests.get(
    "GET https://api.pricempire.com/v4/paid/items/images?app_id=123",
    headers={"Authorization": "Bearer your_api_key"}
)
data = response.json()
const fetch = require('node-fetch');

async function fetchData() {
    const response = await fetch('GET https://api.pricempire.com/v4/paid/items/images?app_id=123', {
        headers: {
            'Authorization': 'Bearer your_api_key'
        }
    });
    const data = await response.json();
    return data;
}

fetchData().then(data => {
    console.log(data);
}).catch(error => {
    console.error('Error:', error);
});
<?php

$url = 'GET https://api.pricempire.com/v4/paid/items/images?app_id=123';
$headers = [
    'Authorization: Bearer your_api_key',
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

print_r($data);

Parameters

1 parameters
Name Type Required Default Description
app_idnumber Yes-

Example Response

Status: 200Content-Type: application/json
{
  "cdn_sizes": [
    50,
    150,
    300,
    450
  ],
  "cdn_url": "https://cs2-cdn.pricempire.com",
  "example_resized": "https://cs2-cdn.pricempire.com/panorama/images/econ/default_generated/weapon_sg556_gs_sg553_over_heated_light_png_50.avif",
  "images": {
    "★ Karambit | Slaughter (Factory New)": {
      "steam": "/panorama/images/econ/default_generated/weapon_knife_karambit_am_zebra_light_png.png",
      "cdn": "/panorama/images/econ/default_generated/weapon_knife_karambit_am_zebra_light_png.avif"
    },
    "Sealed Graffiti | Toasted (Frog Green)": {
      "steam": "/panorama/images/econ/stickers/default/moly_01_png.png",
      "cdn": "/panorama/images/econ/stickers/default/moly_09_png.avif"
    }
  }
}

Inventory

get
https://api.pricempire.com/v4/paid/inventory

Quick Start 

GET https://api.pricempire.com/v4/paid/inventory?steam_id=value&app_id=123&force=true
Authorization: Bearer your_api_key
curl -X get "https://api.pricempire.com/v4/paid/inventory?steam_id=value&app_id=123&force=true" -H "Authorization: Bearer your_api_key"
const response = await fetch("GET https://api.pricempire.com/v4/paid/inventory?steam_id=value&app_id=123&force=true", {
    headers: {
        "Authorization": "Bearer your_api_key"
    }
});
const data = await response.json();
import requests

response = requests.get(
    "GET https://api.pricempire.com/v4/paid/inventory?steam_id=value&app_id=123&force=true",
    headers={"Authorization": "Bearer your_api_key"}
)
data = response.json()
const fetch = require('node-fetch');

async function fetchData() {
    const response = await fetch('GET https://api.pricempire.com/v4/paid/inventory?steam_id=value&app_id=123&force=true', {
        headers: {
            'Authorization': 'Bearer your_api_key'
        }
    });
    const data = await response.json();
    return data;
}

fetchData().then(data => {
    console.log(data);
}).catch(error => {
    console.error('Error:', error);
});
<?php

$url = 'GET https://api.pricempire.com/v4/paid/inventory?steam_id=value&app_id=123&force=true';
$headers = [
    'Authorization: Bearer your_api_key',
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

print_r($data);

Parameters

3 parameters
Name Type Required Default Description
steam_idstring Yes-The steam_id of the user
app_idnumber Yes-The app_id of the game
forceboolean No-Force Reload the inventory. (Allowed only once per minute)

Example Response

Status: 200Content-Type: application/json
{
  "id": "1",
  "value": 0,
  "created_at": "2024-09-14T22:05:46.475Z",
  "items": [
    {
      "asset_id": "30503045023",
      "d": "7512750226289779146",
      "low_rank": null,
      "high_rank": null,
      "float_value": 0.2859826982021332,
      "paint_seed": 81,
      "amount": 1,
      "stickers": [
        {
          "name": "100 Thieves | 2020 RMR",
          "slot": 0,
          "wear": null,
          "offset_x": null,
          "offset_y": null,
          "stickerId": 4769
        }
      ],
      "charms": null,
      "item": {
        "id": 189,
        "app_id": 730,
        "market_hash_name": "StatTrak™ P250 | Asiimov (Field-Tested)",
        "weapon_name": "P250",
        "category": "Pistol",
        "image": "-9a81dlWLwJ2UUGcVs_nsVtzdOEdtWwKGZZLQHTxDZ7I56KU0Zwwo4NUX4oFJZEHLbXH5ApeO4YmlhxYQknCRvCo04DEVlxkKgpopujwezhjxszYI2gS092lnYmGmOHLPr7Vn35cppNw2rCZ99rx3Qzmrhc_Yz2mcYORJ1A2YQ2C_FDvlOi5hZDv7pnIySB9-n51-GWPoLQ",
        "type": "StatTrak™ Classified Pistol",
        "rarity": "Classified",
        "rarity_color": "d32ce6",
        "exterior": "Field-Tested",
        "float_min": 0.1,
        "float_max": 1,
        "weapon_id": 36,
        "paint_id": 551
      }
    }
  ]
}

All Items

get
https://api.pricempire.com/v4/paid/items

Quick Start 

GET https://api.pricempire.com/v4/paid/items?language=en
Authorization: Bearer your_api_key
curl -X get "https://api.pricempire.com/v4/paid/items?language=en" -H "Authorization: Bearer your_api_key"
const response = await fetch("GET https://api.pricempire.com/v4/paid/items?language=en", {
    headers: {
        "Authorization": "Bearer your_api_key"
    }
});
const data = await response.json();
import requests

response = requests.get(
    "GET https://api.pricempire.com/v4/paid/items?language=en",
    headers={"Authorization": "Bearer your_api_key"}
)
data = response.json()
const fetch = require('node-fetch');

async function fetchData() {
    const response = await fetch('GET https://api.pricempire.com/v4/paid/items?language=en', {
        headers: {
            'Authorization': 'Bearer your_api_key'
        }
    });
    const data = await response.json();
    return data;
}

fetchData().then(data => {
    console.log(data);
}).catch(error => {
    console.error('Error:', error);
});
<?php

$url = 'GET https://api.pricempire.com/v4/paid/items?language=en';
$headers = [
    'Authorization: Bearer your_api_key',
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

print_r($data);

Parameters

1 parameters
Name Type Required Default Description
languagestring (enum)NoenThe language of the response

Example Response

Status: 200Content-Type: application/json
[
  {
    "name": "M4A4 | Polysoup (Factory New)",
    "description": "More accurate but less damaging than its AK-47 counterpart, the M4A4 is the full-auto assault rifle of choice for CTs. It has been custom painted with multicolored crystals and finished with pearlescent accents.\\n\\n<i>Don't stew on it</i>",
    "textures": [
      {
        "type": "g_tPaintRoughness",
        "file": "default_rough_tga_4b61db16.png"
      },
      {
        "type": "g_tPaintMetalness",
        "file": "default_metal_tga_a207b0ba.png"
      },
      {
        "type": "g_tPearlescenceMask",
        "file": "black_tga_7b4f0ab5.png"
      },
      {
        "type": "g_tOverlay",
        "file": "soo_polysoup_m4a4_overlay_texture_psd_70de03db.png"
      },
      {
        "type": "g_tNormal",
        "file": "custom_template_pattern_normal_tga_9bf1e72d.png"
      },
      {
        "type": "g_tPaintByNumberMasks",
        "file": "soo_polysoup_m4a4_paint_by_number_masks_psd_ccf743af.png"
      },
      {
        "type": "g_tFinalAmbientOcclusion",
        "file": "default_ao_tga_e5dd0c66.png"
      },
      {
        "type": "g_tWear",
        "file": "paint_wear_psd_19141e79.png"
      },
      {
        "type": "g_tGrunge",
        "file": "gun_grunge_psd_66b72907.png"
      }
    ],
    "style": {
      "name": "Solid Color",
      "description": "A simple yet effective finish style that applies a uniform, solid color across the surface of the weapon. This style emphasizes simplicity and consistency, ensuring that the color covers the weapon entirely without any patterns, gradients, or other embellishments."
    },
    "vcompmatFile": "/materials/weapons/paints/set_graphic_design/soo_polysoup_m4a4.vcompmat",
    "weapon": {
      "name": "M4A4",
      "object_id": 16,
      "description": null,
      "image": "/panorama/images/econ/weapons/base_weapons/weapon_m4a1_png.png",
      "sticker_count": 5
    },
    "category": "Rifles",
    "pattern": "Polysoup",
    "min_float": 0,
    "max_float": 0.64,
    "wear": "Factory New",
    "stattrak": false,
    "souvenir": false,
    "paint_index": 874,
    "rarity": {
      "name": "Restricted",
      "color": "#8847ff"
    },
    "collections": [
      {
        "name": "The Graphic Design Collection",
        "image": "/panorama/images/econ/set_icons/set_graphic_design_png.png"
      }
    ],
    "crates": [],
    "market_hash_name": "M4A4 | Polysoup (Factory New)",
    "team": "Counter-Terrorist",
    "image": "/panorama/images/econ/default_generated/weapon_m4a1_soo_polysoup_m4a4_light_png.png"
  }
]

Item Metadatas

get
https://api.pricempire.com/v4/paid/items/metas

Quick Start 

GET https://api.pricempire.com/v4/paid/items/metas
Authorization: Bearer your_api_key
curl -X get "https://api.pricempire.com/v4/paid/items/metas" -H "Authorization: Bearer your_api_key"
const response = await fetch("GET https://api.pricempire.com/v4/paid/items/metas", {
    headers: {
        "Authorization": "Bearer your_api_key"
    }
});
const data = await response.json();
import requests

response = requests.get(
    "GET https://api.pricempire.com/v4/paid/items/metas",
    headers={"Authorization": "Bearer your_api_key"}
)
data = response.json()
const fetch = require('node-fetch');

async function fetchData() {
    const response = await fetch('GET https://api.pricempire.com/v4/paid/items/metas', {
        headers: {
            'Authorization': 'Bearer your_api_key'
        }
    });
    const data = await response.json();
    return data;
}

fetchData().then(data => {
    console.log(data);
}).catch(error => {
    console.error('Error:', error);
});
<?php

$url = 'GET https://api.pricempire.com/v4/paid/items/metas';
$headers = [
    'Authorization: Bearer your_api_key',
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

print_r($data);

Example Response

Status: 200Content-Type: application/json
[
  {
    "market_hash_name": "Glock-18 | Gamma Doppler (Factory New)",
    "description": "The Glock 18 is a serviceable first-round pistol that works best against unarmored opponents and is capable of firing three-round bursts. It has been painted with black and silver metallic paints using a marbleizing medium, then candy coated.",
    "image": "/panorama/images/econ/default_generated/weapon_glock_am_gamma_doppler_phase4_glock_light_png.png",
    "trades_1d": "107",
    "trades_7d": "687",
    "trades_30d": "2096",
    "trades_90d": "4836",
    "trades_180d": "8254",
    "rank": "1292",
    "marketcap": "50527620",
    "liquidity": "100",
    "count": "9060",
    "steam_last_90d": "1699",
    "steam_last_30d": "587",
    "steam_last_7d": "34",
    "market_first_date": "1632265200000"
  }
]