Jiji seller listings
A seller's live listings in the same shape as /jiji/v1/search, with the same filters (query, category, region, price, filters, ranges, sort). Pass next_cursor back as cursor; null on the last page.
Every response includes credits_used: the credits this call cost.
Part of the Jiji API: 15 endpoints with prices, use cases and example responses.
Parameters
| name | type | description |
|---|---|---|
sellerrequired | string | Seller code, shop name or a Jiji seller page or shop link. Example: samabglobalng |
country | ng | ke | gh | ug | tz | et | Country site: ng (default), ke, gh, ug, tz or et. |
query | string | Keyword within the seller's listings. |
category | string | Category slug. |
sort | rel | new | price | price_desc | rel, new, price or price_desc. |
page | integer | Page number for the first request. |
cursor | string | next_cursor from the previous page. |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/jiji/v1/seller/listings?seller=samabglobalng" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/jiji/v1/seller/listings",
params={"seller": "samabglobalng"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/jiji/v1/seller/listings");
url.searchParams.set("seller", "samabglobalng");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).
Example response (real call, trimmed: lists cut to 2 items, long text shortened, raw left out)
{"seller_guid": "3hvpYEahkR9xnujSavXshoiv","country": "ng","total": 24,"count": 20,"next_cursor": "user_id=3hvpYEahkR9xnujSavXshoiv&page=2&lsmid=1793956716218","listings": [{"id": 53858768,"guid": "uXCpaHgvYvFEOvemeGHMwgBJ","title": "Acura MDX SUV 4dr AWD (3.7 6cyl 5A) 2008 Gray","url": "https://jiji.ng/ibadan/cars/acura-mdx-suv-4dr-awd-3-7-6cyl-5a-2008-gray-uXCpaHgvYvFEOvemeGHMwgBJ.html","price": 4500000,"price_label": "₦ 4,500,000","price_type": null,"price_period": null,"category": "Cars","category_slug": "cars","category_id": 29,"region": "Ibadan","region_parent": "Oyo State","region_slug": "ibadan","region_id": 366,"attributes": [{"name": "Condition","value": "Local Used","unit": null},{"name": "Transmission","value": "Automatic","unit": null}],"description_snippet": "Acura MDX 2008 \nEngine and gear is untouched \nAC needs gas\nPremium speakers & 7 seater leather...","image": "https://pictures-nigeria.jijistatic.net/201045198_MzAwLTQwMC00OGJlZmE3ZjYyLTI.jpg","image_count": 12,"labels": ["Verified ID","5+ years on Jiji"],"promoted": "VIP GOLD","is_top": false,"is_inspected": false,"seller_id": 7055371},{"id": 54671319,"guid": "yx0rjQl6RSKsbC9MVgTTbvfH","title": "Honda Accord Sedan EX Automatic 2010 White","url": "https://jiji.ng/ibadan/cars/honda-accord-sedan-ex-automatic-2010-white-yx0rjQl6RSKsbC9MVgTTbvfH.html","price": 4300000,"price_label": "₦ 4,300,000","price_type": null,"price_period": null,"category": "Cars","category_slug": "cars","category_id": 29,"region": "Ibadan","region_parent": "Oyo State","region_slug": "ibadan","region_id": 366,"attributes": [{"name": "Condition","value": "Local Used","unit": null},{"name": "Transmission","value": "Automatic","unit": null}],"description_snippet": "Engine and gear working perfectly | 4plugs\nAC chilling \nMint Interrior & exterior \nBase speakers,...","image": "https://pictures-nigeria.jijistatic.net/204415251_MzAwLTIyNS01NTI2ZGM0MzkwLTE.jpg","image_count": 9,"labels": ["Verified ID","5+ years on Jiji"],"promoted": "VIP GOLD","is_top": false,"is_inspected": false,"seller_id": 7055371},"… 18 more"],"sort_options": [{"key": "rel","name": "Recommended"},{"key": "new","name": "Newest"},"… 2 more"],"applied_filters": {"country": "ng","seller": "3hvpYEahkR9xnujSavXshoiv","page": 1,"site": {"sort": "rel","period": null,"query": null}},"cached": false,"credits_used": 1}