Jiji similar listings
GET https://api.api.sh/jiji/v1/listing/similar
The listings Jiji shows as similar to one listing, 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 |
|---|---|---|
id | string | Listing code, numeric listing id or a Jiji listing link. Required unless latest=true. |
latest | true | true: use the newest listing of category (default cars). Example: true |
category | string | With latest=true: a category slug. |
country | ng | ke | gh | ug | tz | et | Country site: ng (default), ke, gh, ug, tz or et. |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/jiji/v1/listing/similar?latest=true" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/jiji/v1/listing/similar",
params={"latest": "true"},
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/listing/similar");
url.searchParams.set("latest", "true");
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)
{"listing_id": 55925375,"country": "ng","total": null,"count": 24,"next_cursor": null,"listings": [{"id": 55899663,"guid": "aFWwXZ4WCp3UPP7e7T0ILLGB","title": "Chrysler 300 300S AWD 2016 Gray","url": "https://jiji.ng/central-business-district/cars/chrysler-300-300s-awd-2016-gray-aFWwXZ4WCp3UPP7e7T0ILLGB.html","price": 15500000,"price_label": "₦ 15,500,000","price_type": null,"price_period": null,"category": "Cars","category_slug": "cars","category_id": null,"region": "Central Business District","region_parent": "Abuja (FCT)","region_slug": "central-business-district","region_id": 407,"attributes": [{"name": "Condition","value": "Foreign Used","unit": null},{"name": "Transmission","value": "Automatic","unit": null},"… 1 more"],"description_snippet": "Foreign used\nCrysler 2016 model 300 S\nJust like brand new everything smoth and perfect going for...","image": "https://pictures-nigeria.jijistatic.net/209843897_MzAwLTQwMC02MWEyOTIwZDYw.jpg","image_count": 11,"labels": ["Verified ID"],"promoted": "premium","is_top": false,"is_inspected": false,"seller_id": 16983825},{"id": 55706061,"guid": "ud0y6XnmCRXRWVmid6qKZo5N","title": "Mercedes-Benz C300 Sport 4Matic Sedan AWD (3.0L 6cyl 7A) 2012 Black","url": "https://jiji.ng/life-camp/cars/mercedes-benz-c300-sport-4matic-sedan-awd-3-0l-6cyl-7a-2012-black-ud0y6XnmCRXRWVmid6qKZo5N.html","price": 12500000,"price_label": "₦ 12,500,000","price_type": null,"price_period": null,"category": "Cars","category_slug": "cars","category_id": null,"region": "Life Camp","region_parent": "Abuja (FCT)","region_slug": "life-camp","region_id": 1435,"attributes": [{"name": "Condition","value": "Foreign Used","unit": null},{"name": "Transmission","value": "Automatic","unit": null},"… 1 more"],"description_snippet": "For sale extremely clean foreign used 2012 mercedes benz c300 4-matic with original customs duty.","image": "https://pictures-nigeria.jijistatic.net/209001070_MzAwLTQwMC1kNmRmNzZhODIy.jpg","image_count": 10,"labels": ["Verified ID","5+ years on Jiji"],"promoted": "vip_gold","is_top": false,"is_inspected": false,"seller_id": 4974621},"… 22 more"],"sort_options": [],"applied_filters": {"listing_id": 55925375,"site": null},"cached": false,"credits_used": 1}The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.