Bikroy
bikroy.com classifieds from Bangladesh as JSON: cars, phones and property with the site's own filters, prices in BDT, the seller's published phone and an ad's price history.
/bikroy/v1/search2 creditsSearch bikroy.com (Bangladesh) across every vertical — cars and motorbikes, mobile phones, property, electronics, home, fashion, jobs, services, animals — by keyword and/or category and district, with the filters that category actually publishes. Each row carries the ad id and URL, title, price in BDT as a plain number (the site prints lakh grouping, `BDT 18,90,000` = 1890000), the category's own attributes (a car's condition, transmission and mileage, a phone's storage), the division and area, the cover photo, the seller's account id, the seller's paid Bikroy package and Bikroy's trust labels. 24 slots per page; paid TOP ads come back in a separate `promoted` list, never in `results` or `count`. A filter name the site does not publish is rejected rather than silently ignored.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | Free-text search, as bikroy.com users write it, e.g. 'iphone 13', 'toyota axio', 'flat rent dhaka'. Combine with `category` to search inside one vertical. |
| category | optional | — | A bikroy.com category by slug, numeric id or name — `cars`, `mobile-phones`, `houses-apartments-for-rent`, 29, 'Cars'. Validated against Bikroy's own tree (the `categories` action), because the site answers an unknown category with the WHOLE site instead of an error. |
| region | optional | — | A division / district / area of Bangladesh by slug, id or name — `dhaka`, `chattogram`, `uttara`, 14. The `regions` action lists all 64 districts and their 715 areas. |
| price_min | optional | 0– | Lowest price in Bangladeshi taka (BDT), as a plain number (500000, not 5,00,000). |
| price_max | optional | 0– | Highest price in Bangladeshi taka (BDT), as a plain number (2000000, not 20,00,000). |
| filters | optional | — | Category filters, as `name=value` pairs separated by ';' (or a JSON object). Names and values are the ones bikroy.com itself publishes for that category — ask the `filters` action (cars: make, condition Foreign Used / Brand New / Local Used, year_of_manufacture, mileage, registered_car, fuel, transmission, body…). Ranges take `from-to`, `from-` or `-to`. Several values for one filter are comma-separated. A name the site does not publish is REJECTED rather than silently ignored. |
| sort = relevance | optional | relevance · newest · price_asc · price_desc | Result order. `relevance` is Jiji's own Recommended order, which the site re-ranks on every request (paid ranking), so paging through it can return a few adverts twice and skip others. To walk every page of a search, use `newest`: its order is stable from page to page. |
| posted_within | optional | hour · day | Only ads posted in the last hour or the last day. |
| page = 1 | optional | 1– | Which page of results to start from (1-based). Jiji's own window ends at `total_pages`; asking past it is an error, never an empty page. |
| limit = 24 | optional | 1–96 | How many ads to return in `results`, 1-96. Jiji's page is fixed at 24 slots and cannot be widened, so anything above 24 is fetched as consecutive pages. Jiji's paid TOP ads take 1-5 of those slots and are returned in `promoted` instead, so one page usually yields 19-23 results. |
/bikroy/v1/listing2 creditsOne bikroy.com ad in full: title, the complete description, price in BDT with Bikroy's own market-price band, every photo, every attribute the category defines, when it was posted, how many people viewed and saved it, the trust labels, the breadcrumb path, and the seller — account id, display name, the phone number(s) the ad publishes, how long they have been on Bikroy, when they were last seen, their response time, and their shop page if they run one.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| listing_id | required | — | The ad's id — the `listing_id` a search row returns, or a full bikroy.com ad URL, or the ...-<id>.html tail of one. |
| include_phone = true | optional | — | Fetch the seller's published phone number(s) as well (one extra upstream call). On by default. |
/bikroy/v1/seller_listings2 creditsEvery live ad of one bikroy.com seller — a dealer, a phone shop, an agency or a private account — in the same row shape as `search`, page by page. The seller's own paid TOP ads come back in a separate `promoted` list.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| user_id | required | — | The seller's numeric account id — `seller.user_id` on any of their ads. |
| query | optional | — | Free-text search, e.g. 'toyota camry', 'iphone 15', '3 bedroom flat'. Combine with `category` to search inside one vertical. |
| category | optional | — | A category by slug, numeric id or name — `cars`, `mobile-phones`, `houses-apartments-for-rent`, `jobs`, 29, 'Cars'. Validated against Jiji's own tree (the free `categories` action), because Jiji answers an unknown category slug with the WHOLE site instead of an error. |
| region | optional | — | A state / city / district by slug, id or name — `lagos`, `nairobi`, `greater-accra`, `dhaka`, 119. The free `regions` action lists every one. |
| sort = relevance | optional | relevance · newest · price_asc · price_desc | Result order. `relevance` is Jiji's own Recommended order, which the site re-ranks on every request (paid ranking), so paging through it can return a few adverts twice and skip others. To walk every page of a search, use `newest`: its order is stable from page to page. |
| page = 1 | optional | 1– | Which page of results to start from (1-based). Jiji's own window ends at `total_pages`; asking past it is an error, never an empty page. |
| limit = 24 | optional | 1–96 | How many ads to return in `results`, 1-96. Jiji's page is fixed at 24 slots and cannot be widened, so anything above 24 is fetched as consecutive pages. Jiji's paid TOP ads take 1-5 of those slots and are returned in `promoted` instead, so one page usually yields 19-23 results. |
/bikroy/v1/similar2 creditsbikroy.com's own comparable live ads for one ad — what the same market is asking right now, in the search row shape, prices in BDT.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| advert_id | required | — | The ad's NUMERIC id (`advert_id` in a search row). A `listing_id` guid is also accepted and costs one extra lookup. |
| page = 1 | optional | 1– | Which page of results to start from (1-based). Jiji's own window ends at `total_pages`; asking past it is an error, never an empty page. |
/bikroy/v1/price_history1 creditEvery price the seller has asked for one bikroy.com ad since it was posted, with the date of each change and the total change in BDT and percent — the site's own record.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| advert_id | required | — | The ad's NUMERIC id (`advert_id` in a search row). A `listing_id` guid is also accepted and costs one extra lookup. |
/bikroy/v1/suggest1 creditbikroy.com's keyword autocomplete — what real buyers type, each suggestion with the category it belongs to and a ready-made bikroy.com search URL.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | The partial phrase to complete. |
| category | optional | — | A category by slug, numeric id or name — `cars`, `mobile-phones`, `houses-apartments-for-rent`, `jobs`, 29, 'Cars'. Validated against Jiji's own tree (the free `categories` action), because Jiji answers an unknown category slug with the WHOLE site instead of an error. |
/bikroy/v1/categories1 creditbikroy.com's whole category tree — 17 groups and their sub-categories with id, slug, name and live ad count. These are the values `search` and `filters` take.
Try in playground →/bikroy/v1/regions1 creditEvery district (64) and area (715) bikroy.com lists for Bangladesh, with ids and slugs and which ones it marks as popular (Dhaka, Chattogram). These are the values `region` takes.
Try in playground →/bikroy/v1/filters1 creditEvery filter one bikroy.com category publishes, with the allowed values, range bounds and unit — car makes and models, conditions (Foreign Used / Brand New / Local Used), registration, fuel, engine size, phone brands and storage. The authoritative input for `search`'s `filters` parameter; pass `filters` here too to see the child filters a choice unlocks (choose a make, get its models).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| category | optional | — | A category by slug, numeric id or name — `cars`, `mobile-phones`, `houses-apartments-for-rent`, `jobs`, 29, 'Cars'. Validated against Jiji's own tree (the free `categories` action), because Jiji answers an unknown category slug with the WHOLE site instead of an error. |
| region | optional | — | A state / city / district by slug, id or name — `lagos`, `nairobi`, `greater-accra`, `dhaka`, 119. The free `regions` action lists every one. |
| filters | optional | — | Category filters, as `name=value` pairs separated by ';' (or a JSON object). Names and values are the ones Jiji itself publishes for that category — ask the free `filters` action. Ranges take `from-to`, `from-` or `-to`. Several values for one filter are comma-separated. Examples: `make=Toyota;model=Camry`, `condition=Foreign Used;year_of_manufacture=2018-2021`, `colour=Black,Blue;mileage=-80000`. A name Jiji does not publish is REJECTED rather than silently ignored — see the action description. |
curl -X POST https://api.reefapi.com/bikroy/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"category":"cars","limit":24}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.