Jiji trending listings
The listings Jiji shows as trending on a country site's home page, in the same shape as /jiji/v1/search.
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 |
|---|---|---|
country | ng | ke | gh | ug | tz | et | Country site: ng (default), ke, gh, ug, tz or et. Example: ng |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/jiji/v1/trending/listings?country=ng" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/jiji/v1/trending/listings",
params={"country": "ng"},
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/trending/listings");
url.searchParams.set("country", "ng");
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)
{"country": "ng","total": null,"count": 24,"next_cursor": null,"listings": [{"id": 55362805,"guid": "v2ZBqvFcSVf9eCfwcwY8yQtX","title": "Honda Accord 2013 White","url": "https://jiji.ng/ikeja/cars/honda-accord-2013-white-v2ZBqvFcSVf9eCfwcwY8yQtX.html","price": 7600000,"price_label": "₦ 7,600,000","price_type": null,"price_period": null,"category": "Cars","category_slug": "cars","category_id": 29,"region": "Ikeja","region_parent": "Lagos State","region_slug": "ikeja","region_id": 146,"attributes": [{"name": "Condition","value": "Local Used","unit": null},{"name": "Transmission","value": "Automatic","unit": null}],"description_snippet": "Neatly used 013 Honda Accord fullest option with bsm, thumb start, double sceeen going for 7.6m at...","image": "https://pictures-nigeria.jijistatic.net/207675817_MzAwLTQwMC1lZjI4OTkxYmQ0.webp","image_count": 20,"labels": ["Verified ID"],"promoted": "VIP","is_top": false,"is_inspected": false,"seller_id": 11288353},{"id": 55239637,"guid": "madRc28DshspuVti5T0Ol3ZY","title": "Toyota Highlander XLE 4dr SUV (3.5L 6cyl 6A) 2015 Gray","url": "https://jiji.ng/ikeja/cars/toyota-highlander-xle-4dr-suv-3-5l-6cyl-6a-2015-gray-madRc28DshspuVti5T0Ol3ZY.html","price": 17900000,"price_label": "₦ 17,900,000","price_type": null,"price_period": null,"category": "Cars","category_slug": "cars","category_id": 29,"region": "Ikeja","region_parent": "Lagos State","region_slug": "ikeja","region_id": 146,"attributes": [{"name": "Condition","value": "Local Used","unit": null},{"name": "Transmission","value": "Automatic","unit": null}],"description_snippet": "Thumbstart \nEngine perfect \nGear perfect \nBuy and drive \nAc perfect \nNothing's to fix","image": "https://pictures-nigeria.jijistatic.net/206928750_MzAwLTMzNC02NjdlNGJkMzM3.webp","image_count": 11,"labels": ["Popular"],"promoted": "ENTERPRISE","is_top": false,"is_inspected": false,"seller_id": 13089451},"… 22 more"],"sort_options": [],"applied_filters": {"site": null},"cached": false,"credits_used": 1}