Skip to main content
POST
/grailed/users/items

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
user
string
required
Minimum string length: 1
count
integer
required
Required range: x >= 1
timeout
integer
default:300
Required range: 20 <= x <= 1500
sort
enum<string>
default:most_relevant
Available options:
most_relevant,
latest_activity,
newly_listed,
trending,
price_low_to_high,
price_high_to_low
department
enum<string>[] | null
Available options:
menswear,
womenswear
category_path
enum<string>[] | null
Available options:
tops.short_sleeve_shirts,
tops.long_sleeve_shirts,
tops.polos,
tops.button_ups,
tops.sweaters_knitwear,
tops.sweatshirts_hoodies,
tops.sleeveless,
tops.jerseys,
bottoms.casual_pants,
bottoms.cropped_pants,
bottoms.denim,
bottoms.leggings,
bottoms.jumpsuits,
bottoms.shorts,
bottoms.sweatpants_joggers,
bottoms.swimwear,
outerwear.bombers,
outerwear.cloaks_capes,
outerwear.denim_jackets,
outerwear.heavy_coats,
outerwear.leather_jackets,
outerwear.light_jackets,
outerwear.parkas,
outerwear.raincoats,
outerwear.vests,
footwear.boots,
footwear.leather,
footwear.formal_shoes,
footwear.hitop_sneakers,
footwear.lowtop_sneakers,
footwear.sandals,
footwear.slip_ons,
tailoring.blazers,
tailoring.formal_shirting,
tailoring.formal_trousers,
tailoring.suits,
tailoring.tuxedos,
tailoring.vests,
accessories.bags_luggage,
accessories.belts,
accessories.glasses,
accessories.gloves_scarves,
accessories.hats,
accessories.jewelry_watches,
accessories.wallets,
accessories.misc,
accessories.periodicals,
accessories.socks_underwear,
accessories.sunglasses,
womens_tops.blouses,
womens_tops.bodysuits,
womens_tops.button_ups,
womens_tops.crop_tops,
womens_tops.hoodies,
womens_tops.long_sleeve_shirts,
womens_tops.polos,
womens_tops.short_sleeve_shirts,
womens_tops.sweaters,
womens_tops.sweatshirts,
womens_tops.tank_tops,
womens_bottoms.jeans,
womens_bottoms.joggers,
womens_bottoms.jumpsuits,
womens_bottoms.leggings,
womens_bottoms.maxi_skirts,
womens_bottoms.midi_skirts,
womens_bottoms.mini_skirts,
womens_bottoms.pants,
womens_bottoms.shorts,
womens_bottoms.sweatpants,
womens_dresses.mini,
womens_dresses.midi,
womens_dresses.maxi,
womens_dresses.gowns,
womens_outerwear.blazers,
womens_outerwear.bombers,
womens_outerwear.coats,
womens_outerwear.denim_jackets,
womens_outerwear.down_jackets,
womens_outerwear.fur_faux_fur,
womens_outerwear.jackets,
womens_outerwear.leather_jackets,
womens_outerwear.rain_jackets,
womens_outerwear.vests,
womens_footwear.boots,
womens_footwear.heels,
womens_footwear.platforms,
womens_footwear.mules,
womens_footwear.flats,
womens_footwear.hitop_sneakers,
womens_footwear.lowtop_sneakers,
womens_footwear.sandals,
womens_footwear.slip_ons,
womens_accessories.belts,
womens_accessories.glasses,
womens_accessories.gloves,
womens_accessories.hats,
womens_accessories.miscellaneous,
womens_accessories.scarves,
womens_accessories.socks_intimates,
womens_accessories.sunglasses,
womens_accessories.wallets,
womens_bags_luggage.backpacks,
womens_bags_luggage.belt_bags,
womens_bags_luggage.clutches,
womens_bags_luggage.crossbody_bags,
womens_bags_luggage.handle_bags,
womens_bags_luggage.luggage_travel,
womens_bags_luggage.mini_bags,
womens_bags_luggage.shoulder_bags,
womens_bags_luggage.tote_bags,
womens_bags_luggage.other,
womens_jewelry.body_jewelry,
womens_jewelry.bracelets,
womens_jewelry.earrings,
womens_jewelry.necklaces,
womens_jewelry.rings
size
string[] | null
color
enum<string>[] | null
Available options:
black,
blue,
multi,
white,
gray,
brown,
green,
beige,
red,
pink,
purple,
yellow,
silver,
orange,
gold
condition
enum<string>[] | null
Available options:
is_new,
is_gently_used,
is_used,
is_worn,
is_not_specified
designer
string[] | null
location
enum<string>[] | null
Available options:
United States,
Canada,
Europe,
United Kingdom,
Asia,
Australia/NZ,
Other
strata
enum<string>[] | null
Available options:
basic,
grailed,
hype,
sartorial
badges
enum<string>[] | null
Available options:
staff_pick,
by_grailed
price_min
number | null
Required range: x >= 0
price_max
number | null
Required range: x >= 0
sold
boolean
default:false

Response

Successful Response

id
integer
required
listing_title
string
required
@type
string
default:GrailedListingHit
url
string | null
price
number | null
price_drops
number[]
dropped
boolean
default:false
size
string | null
category
string | null
category_path
string | null
department
string | null
color
string | null
condition
string | null
country_of_origin
string | null
strata
string | null
styles
string[]
badges
string[]
designer_names
string | null
designers
object[]
image
string | null
photo_count
integer
default:0
measurement_count
integer
default:0
location
string | null
follower_count
integer
default:0
buy_now
boolean
default:false
make_offer
boolean
default:false
sold
boolean
default:false
sold_price
number | null
sold_shipping_price
number | null
sold_price_includes_shipping
boolean | null
sold_at
integer | null
shipping
object[]
seller
object | null
created_at
integer | null