/grailed/users/items
curl --request POST \
--url https://api.anysite.io/api/grailed/users/items \
--header 'Content-Type: application/json' \
--header 'access-token: <api-key>' \
--data '
{
"user": "<string>",
"count": 2,
"timeout": 300,
"sort": "most_relevant",
"department": [],
"category_path": [],
"size": [
"<string>"
],
"color": [],
"condition": [],
"designer": [
"<string>"
],
"location": [],
"strata": [],
"badges": [],
"price_min": 1,
"price_max": 1,
"sold": false
}
'import requests
url = "https://api.anysite.io/api/grailed/users/items"
payload = {
"user": "<string>",
"count": 2,
"timeout": 300,
"sort": "most_relevant",
"department": [],
"category_path": [],
"size": ["<string>"],
"color": [],
"condition": [],
"designer": ["<string>"],
"location": [],
"strata": [],
"badges": [],
"price_min": 1,
"price_max": 1,
"sold": False
}
headers = {
"access-token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'access-token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
user: '<string>',
count: 2,
timeout: 300,
sort: 'most_relevant',
department: [],
category_path: [],
size: ['<string>'],
color: [],
condition: [],
designer: ['<string>'],
location: [],
strata: [],
badges: [],
price_min: 1,
price_max: 1,
sold: false
})
};
fetch('https://api.anysite.io/api/grailed/users/items', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.anysite.io/api/grailed/users/items",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'user' => '<string>',
'count' => 2,
'timeout' => 300,
'sort' => 'most_relevant',
'department' => [
],
'category_path' => [
],
'size' => [
'<string>'
],
'color' => [
],
'condition' => [
],
'designer' => [
'<string>'
],
'location' => [
],
'strata' => [
],
'badges' => [
],
'price_min' => 1,
'price_max' => 1,
'sold' => false
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"access-token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.anysite.io/api/grailed/users/items"
payload := strings.NewReader("{\n \"user\": \"<string>\",\n \"count\": 2,\n \"timeout\": 300,\n \"sort\": \"most_relevant\",\n \"department\": [],\n \"category_path\": [],\n \"size\": [\n \"<string>\"\n ],\n \"color\": [],\n \"condition\": [],\n \"designer\": [\n \"<string>\"\n ],\n \"location\": [],\n \"strata\": [],\n \"badges\": [],\n \"price_min\": 1,\n \"price_max\": 1,\n \"sold\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("access-token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.anysite.io/api/grailed/users/items")
.header("access-token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"user\": \"<string>\",\n \"count\": 2,\n \"timeout\": 300,\n \"sort\": \"most_relevant\",\n \"department\": [],\n \"category_path\": [],\n \"size\": [\n \"<string>\"\n ],\n \"color\": [],\n \"condition\": [],\n \"designer\": [\n \"<string>\"\n ],\n \"location\": [],\n \"strata\": [],\n \"badges\": [],\n \"price_min\": 1,\n \"price_max\": 1,\n \"sold\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.anysite.io/api/grailed/users/items")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["access-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"user\": \"<string>\",\n \"count\": 2,\n \"timeout\": 300,\n \"sort\": \"most_relevant\",\n \"department\": [],\n \"category_path\": [],\n \"size\": [\n \"<string>\"\n ],\n \"color\": [],\n \"condition\": [],\n \"designer\": [\n \"<string>\"\n ],\n \"location\": [],\n \"strata\": [],\n \"badges\": [],\n \"price_min\": 1,\n \"price_max\": 1,\n \"sold\": false\n}"
response = http.request(request)
puts response.read_body[
{
"id": 123,
"listing_title": "<string>",
"@type": "GrailedListingHit",
"url": "<string>",
"price": 123,
"price_drops": [],
"dropped": false,
"size": "<string>",
"category": "<string>",
"category_path": "<string>",
"department": "<string>",
"color": "<string>",
"condition": "<string>",
"country_of_origin": "<string>",
"strata": "<string>",
"styles": [],
"badges": [],
"designer_names": "<string>",
"designers": [],
"image": "<string>",
"photo_count": 0,
"measurement_count": 0,
"location": "<string>",
"follower_count": 0,
"buy_now": false,
"make_offer": false,
"sold": false,
"sold_price": 123,
"sold_shipping_price": 123,
"sold_price_includes_shipping": true,
"sold_at": 123,
"shipping": [],
"seller": {
"id": 123,
"@type": "GrailedHitSeller",
"alias": "<string>",
"image": "<string>",
"total_bought_and_sold": 0,
"rating_average": 123,
"rating_count": 0,
"is_trusted_seller": false
},
"created_at": 123
}
]{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}/grailed
/grailed/users/items
List a Grailed seller’s listings by username or user ID, with optional filters and sorting
Price: 5 credits per 40 results
⚠️ Common errors: 412: User not found
POST
/
api
/
grailed
/
users
/
items
/grailed/users/items
curl --request POST \
--url https://api.anysite.io/api/grailed/users/items \
--header 'Content-Type: application/json' \
--header 'access-token: <api-key>' \
--data '
{
"user": "<string>",
"count": 2,
"timeout": 300,
"sort": "most_relevant",
"department": [],
"category_path": [],
"size": [
"<string>"
],
"color": [],
"condition": [],
"designer": [
"<string>"
],
"location": [],
"strata": [],
"badges": [],
"price_min": 1,
"price_max": 1,
"sold": false
}
'import requests
url = "https://api.anysite.io/api/grailed/users/items"
payload = {
"user": "<string>",
"count": 2,
"timeout": 300,
"sort": "most_relevant",
"department": [],
"category_path": [],
"size": ["<string>"],
"color": [],
"condition": [],
"designer": ["<string>"],
"location": [],
"strata": [],
"badges": [],
"price_min": 1,
"price_max": 1,
"sold": False
}
headers = {
"access-token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'access-token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
user: '<string>',
count: 2,
timeout: 300,
sort: 'most_relevant',
department: [],
category_path: [],
size: ['<string>'],
color: [],
condition: [],
designer: ['<string>'],
location: [],
strata: [],
badges: [],
price_min: 1,
price_max: 1,
sold: false
})
};
fetch('https://api.anysite.io/api/grailed/users/items', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.anysite.io/api/grailed/users/items",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'user' => '<string>',
'count' => 2,
'timeout' => 300,
'sort' => 'most_relevant',
'department' => [
],
'category_path' => [
],
'size' => [
'<string>'
],
'color' => [
],
'condition' => [
],
'designer' => [
'<string>'
],
'location' => [
],
'strata' => [
],
'badges' => [
],
'price_min' => 1,
'price_max' => 1,
'sold' => false
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"access-token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.anysite.io/api/grailed/users/items"
payload := strings.NewReader("{\n \"user\": \"<string>\",\n \"count\": 2,\n \"timeout\": 300,\n \"sort\": \"most_relevant\",\n \"department\": [],\n \"category_path\": [],\n \"size\": [\n \"<string>\"\n ],\n \"color\": [],\n \"condition\": [],\n \"designer\": [\n \"<string>\"\n ],\n \"location\": [],\n \"strata\": [],\n \"badges\": [],\n \"price_min\": 1,\n \"price_max\": 1,\n \"sold\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("access-token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.anysite.io/api/grailed/users/items")
.header("access-token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"user\": \"<string>\",\n \"count\": 2,\n \"timeout\": 300,\n \"sort\": \"most_relevant\",\n \"department\": [],\n \"category_path\": [],\n \"size\": [\n \"<string>\"\n ],\n \"color\": [],\n \"condition\": [],\n \"designer\": [\n \"<string>\"\n ],\n \"location\": [],\n \"strata\": [],\n \"badges\": [],\n \"price_min\": 1,\n \"price_max\": 1,\n \"sold\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.anysite.io/api/grailed/users/items")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["access-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"user\": \"<string>\",\n \"count\": 2,\n \"timeout\": 300,\n \"sort\": \"most_relevant\",\n \"department\": [],\n \"category_path\": [],\n \"size\": [\n \"<string>\"\n ],\n \"color\": [],\n \"condition\": [],\n \"designer\": [\n \"<string>\"\n ],\n \"location\": [],\n \"strata\": [],\n \"badges\": [],\n \"price_min\": 1,\n \"price_max\": 1,\n \"sold\": false\n}"
response = http.request(request)
puts response.read_body[
{
"id": 123,
"listing_title": "<string>",
"@type": "GrailedListingHit",
"url": "<string>",
"price": 123,
"price_drops": [],
"dropped": false,
"size": "<string>",
"category": "<string>",
"category_path": "<string>",
"department": "<string>",
"color": "<string>",
"condition": "<string>",
"country_of_origin": "<string>",
"strata": "<string>",
"styles": [],
"badges": [],
"designer_names": "<string>",
"designers": [],
"image": "<string>",
"photo_count": 0,
"measurement_count": 0,
"location": "<string>",
"follower_count": 0,
"buy_now": false,
"make_offer": false,
"sold": false,
"sold_price": 123,
"sold_shipping_price": 123,
"sold_price_includes_shipping": true,
"sold_at": 123,
"shipping": [],
"seller": {
"id": 123,
"@type": "GrailedHitSeller",
"alias": "<string>",
"image": "<string>",
"total_bought_and_sold": 0,
"rating_average": 123,
"rating_count": 0,
"is_trusted_seller": false
},
"created_at": 123
}
]{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Authorizations
API token from the dashboard
Headers
Body
application/json
Minimum string length:
1Required range:
x >= 1Required range:
20 <= x <= 1500Available options:
most_relevant, latest_activity, newly_listed, trending, price_low_to_high, price_high_to_low Available options:
menswear, womenswear 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 Available options:
black, blue, multi, white, gray, brown, green, beige, red, pink, purple, yellow, silver, orange, gold Available options:
is_new, is_gently_used, is_used, is_worn, is_not_specified Available options:
United States, Canada, Europe, United Kingdom, Asia, Australia/NZ, Other Available options:
basic, grailed, hype, sartorial Available options:
staff_pick, by_grailed Required range:
x >= 0Required range:
x >= 0Response
Successful Response
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes