Jiji listing search
Search classified listings on one Jiji country site (cars, property, phones, electronics, fashion, jobs, services and every other category) with every filter the site's search accepts: keyword, category, region, price range, any category attribute (make, model, condition, transmission, bedrooms...), numeric ranges (year, mileage, size...), posting period and sort. Each listing comes with title, price, category, region, key attributes, a description snippet, main image, image count, labels (verified ID, years on Jiji), promotion and the seller's id. Pass next_cursor back as cursor for the next page; 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 |
|---|---|---|
query | string | Keyword (e.g. iphone 13). Give a query or a category. Example: toyota camry |
category | string | A category slug from /jiji/v1/categories (e.g. cars, mobile-phones, houses-apartments-for-rent). |
country | ng | ke | gh | ug | tz | et | Country site: ng (Nigeria, default), ke (Kenya), gh (Ghana), ug (Uganda), tz (Tanzania) or et (Ethiopia). |
region | string | A region slug from /jiji/v1/regions (e.g. lagos, ikeja). |
filters | string | Category attributes as key:value|value;key2:value, keys and values from /jiji/v1/filters (e.g. filter_attr_1_make:Toyota|Honda;filter_attr_100_condition:Foreign Used). |
ranges | string | Numeric ranges as key:min-max, keys from /jiji/v1/filters with type range (e.g. filter_attr_119_year_of_manufacture:2015-2020). |
price_min | string | Minimum price in the country's currency. |
price_max | string | Maximum price in the country's currency. |
period | hour | day | week | month | Only listings posted in the last hour, day, week or month. |
sort | rel | new | price | price_desc | rel (recommended, default), new (newest), price (lowest first) or price_desc (highest first). |
page | integer | Page number for the first request (later pages: use cursor). |
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/search?query=toyota+camry" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/jiji/v1/search",
params={"query": "toyota camry"},
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/search");
url.searchParams.set("query", "toyota camry");
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": 18033,"count": 20,"next_cursor": "query=toyota+camry&page=2&crsr=eyJjcCI6NiwiciI6MTR9&lsmid=1793956662236","listings": [{"id": 55286401,"guid": "eV7n6SToTOYqnCz2x0l0tal3","title": "Toyota Camry XSE 4dr Sedan (2.5L 4cyl 6A) 2015 Silver","url": "https://jiji.ng/ikeja/cars/toyota-camry-xse-4dr-sedan-2-5l-4cyl-6a-2015-silver-eV7n6SToTOYqnCz2x0l0tal3.html","price": 15800000,"price_label": "₦ 15,800,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": "Foreign Used","unit": null},{"name": "Transmission","value": "Automatic","unit": null},"… 1 more"],"description_snippet": "Fullest Option 2015/2016 toyota camry XSE Xtra Sport Edition in Silver on leather mix with sport...","image": "https://pictures-nigeria.jijistatic.net/207137743_MzAwLTIyNS04Njg2YzlhNjgw.jpg","image_count": 13,"labels": ["Verified ID","8+ years on Jiji","… 1 more"],"promoted": "ENTERPRISE","is_top": false,"is_inspected": false,"seller_id": 546236},{"id": 55450894,"guid": "wuY369WidsTX0Ndxb6YGcM5r","title": "Toyota Camry SE V6 4dr Sedan (3.5L 6cyl 6A) 2012 Red","url": "https://jiji.ng/ogba/cars/toyota-camry-se-v6-4dr-sedan-3-5l-6cyl-6a-2012-red-wuY369WidsTX0Ndxb6YGcM5r.html","price": 13250000,"price_label": "₦ 13,250,000","price_type": null,"price_period": null,"category": "Cars","category_slug": "cars","category_id": 29,"region": "Ogba","region_parent": "Lagos State","region_slug": "ogba","region_id": 1237,"attributes": [{"name": "Condition","value": "Foreign Used","unit": null},{"name": "Transmission","value": "Automatic","unit": null}],"description_snippet": "V6 engine with keyless entry,all systems working properly,fabric with matted leather seats,Lagos...","image": "https://pictures-nigeria.jijistatic.net/207883087_MzAwLTQwMC0wYTY2NzJhNDM2.jpg","image_count": 0,"labels": ["Verified ID","5+ years on Jiji","… 1 more"],"promoted": "ENTERPRISE","is_top": false,"is_inspected": false,"seller_id": 1415074},"… 18 more"],"sort_options": [{"key": "rel","name": "Recommended"},{"key": "new","name": "Newest"},"… 2 more"],"applied_filters": {"country": "ng","query": "toyota camry","page": 1,"site": {"sort": "rel","period": null,"query": "toyota camry"}},"cached": false,"credits_used": 1}