Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Bikroy API page →
docs / bikroy

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.

base /bikroy/v19 endpoints
post/bikroy/v1/listing2 credits

One 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.

ParameterAllowed / rangeDescription
listing_idrequired—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 = trueoptional—Fetch the seller's published phone number(s) as well (one extra upstream call). On by default.
Try in playground →
post/bikroy/v1/seller_listings2 credits

Every 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.

ParameterAllowed / rangeDescription
user_idrequired—The seller's numeric account id — `seller.user_id` on any of their ads.
queryoptional—Free-text search, e.g. 'toyota camry', 'iphone 15', '3 bedroom flat'. Combine with `category` to search inside one vertical.
categoryoptional—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.
regionoptional—A state / city / district by slug, id or name — `lagos`, `nairobi`, `greater-accra`, `dhaka`, 119. The free `regions` action lists every one.
sort = relevanceoptionalrelevance · newest · price_asc · price_descResult 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 = 1optional1–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 = 24optional1–96How 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.
Try in playground →
post/bikroy/v1/similar2 credits

bikroy.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.

ParameterAllowed / rangeDescription
advert_idrequired—The ad's NUMERIC id (`advert_id` in a search row). A `listing_id` guid is also accepted and costs one extra lookup.
page = 1optional1–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.
Try in playground →
post/bikroy/v1/price_history1 credit

Every 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.

ParameterAllowed / rangeDescription
advert_idrequired—The ad's NUMERIC id (`advert_id` in a search row). A `listing_id` guid is also accepted and costs one extra lookup.
Try in playground →
post/bikroy/v1/suggest1 credit

bikroy.com's keyword autocomplete — what real buyers type, each suggestion with the category it belongs to and a ready-made bikroy.com search URL.

ParameterAllowed / rangeDescription
queryrequired—The partial phrase to complete.
categoryoptional—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.
Try in playground →
post/bikroy/v1/categories1 credit

bikroy.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 →
post/bikroy/v1/regions1 credit

Every 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 →
post/bikroy/v1/filters1 credit

Every 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).

ParameterAllowed / rangeDescription
categoryoptional—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.
regionoptional—A state / city / district by slug, id or name — `lagos`, `nairobi`, `greater-accra`, `dhaka`, 119. The free `regions` action lists every one.
filtersoptional—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.
Try in playground →
Built for volume
5M+ requests a day

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.

Missing a source?
We build it

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.

Support
2 minute median reply

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.

One key, one balance
Every API included

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.