Skip to main content

Python Example

Use the RBLXValue API in Python scripts, bots, or tools.

Installation​

pip install requests

Basic Item Lookup​

import requests

API_KEY = 'rbx_your_key_here'
HEADERS = {'X-Api-Key': API_KEY}

def get_item(slug: str) -> dict | None:
    r = requests.get(
        f'https://rblxvalue.com/api/v1/items?slug={slug}',
        headers=HEADERS,
        timeout=5
    )
    data = r.json()
    return data.get('item')

item = get_item('seer')
if item:
    src_a = item.get('value_source_a', 0) or 0
    src_b = item.get('value_source_b', 0) or 0
    est   = round((src_a + src_b) / 2)
    print(f"{item['name']}: {est:,} (demand: {item['demand']}/10)")

Search Items​

def search_items(query: str, limit: int = 10) -> list:
    r = requests.get(
        'https://rblxvalue.com/api/v1/items',
        params={'search': query, 'limit': limit},
        headers=HEADERS,
        timeout=5
    )
    return r.json().get('items', [])

for item in search_items('chroma'):
    print(item['name'], item['value'])

Set Lookup​

def get_set(slug: str) -> dict | None:
    r = requests.get(
        f'https://rblxvalue.com/api/v1/sets?slug={slug}',
        headers=HEADERS,
        timeout=5
    )
    return r.json().get('set')

mm2_set = get_set('chroma-evergreen-set')
if mm2_set:
    print(f"{mm2_set['name']}: {mm2_set['total_value']:,} total")
    for item in mm2_set.get('items', []):
        print(f"  - {item['name']}: {item['value']:,}")

Profile Lookup​

def get_profile(username: str) -> dict | None:
    r = requests.get(
        f'https://rblxvalue.com/api/v1/profile?username={username}',
        headers=HEADERS,
        timeout=5
    )
    data = r.json()
    return data.get('profile')

profile = get_profile('UN6107617')
if profile:
    print(f"{profile['display_name']} — inventory: {profile['total_value']:,}")
    print(f"Badge: {profile['top_badge_label']}")

Batch Item Prices​

import time

def get_all_items() -> list:
    items = []
    offset = 0
    while True:
        r = requests.get(
            'https://rblxvalue.com/api/v1/items',
            params={'limit': 100, 'offset': offset},
            headers=HEADERS,
            timeout=10
        )
        data = r.json()
        batch = data.get('items', [])
        if not batch:
            break
        items.extend(batch)
        offset += 100
        time.sleep(0.1)  # respect rate limit
    return items

all_items = get_all_items()
print(f"Total items: {len(all_items)}")