Algerian classifieds as JSON, where the printed number and the real price are never confused
Ouedkniss API returns live Ouedkniss data as clean JSON for ouedkniss The primary endpoint, search, returns query/category/filter echo, language, total_results (the source's own paginator total), page, page_size, last_page, has_more, currency, m….
4 active endpoints. Every call is 1 credit.
- POST/ouedkniss/v1/search
- POST/ouedkniss/v1/listing
- POST/ouedkniss/v1/categories
- POST/ouedkniss/v1/stores
What Ouedkniss endpoints does ReefAPI ship?
4 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Ouedkniss API
4 of 4 endpoints, ready to run
Search Ouedkniss by keyword, category, region, city, price band, seller type, delivery and exchange-accepted. Every filter is proven against an unfiltered control in the same run. Measured 2026-10-01: an unfiltered search returns 93 rows, a region takes it to 54, a city to 2, and the seller-type split (6 shops + 87 individuals) partitions the set exactly.
{ "ok": true, "data": { "query": "golf", "language": "fr", "page": 1, "page_size": 24, "sort": "refreshed", "currency": "DZD", "total_results": 12183, "last_page": 506, "has_more": true, "matched_category": { "category_id": "21", "name": "Automobiles & Véhicules", "slug": "automobiles_vehicules", "icon": "https://cdn.ouedkniss.com/medias/images/0Y1KV/SFYCmqmLmDCyFwnUcXTKP818oI2m4YrjGPwXKCLZ.svg", "has_delivery": true, "delivery_type": "SERVICE", "is_without_exchange": false, "price_units": [ "MILLION" ] }, "suggested_categories": [ { "category_id": "46", "name": "Pièces détachées", "slug": "pieces_detachees", "icon": "https://cdn.ouedkniss.com/medias/images/0Y1KV/UaZi9xF1V5SiLRrGKJ6Wv2vug1V4SMyQwQXL0hDJ.svg", "has_delivery": null, "delivery_type": null, "is_without_exchange": null, "price_units": null, "count": 1763 }, { "category_id": "62", "name": "Immobilier", "slug": "immobilier", "icon": "https://cdn.ouedkniss.com/medias/images/0Y1KV/Mjo5wEg3Dj46hVpo5z5avd2QlgnPOcxXDOnwud8I.svg", "has_delivery": null, "delivery_type": null, "is_without_exchange": null, "price_units": null, "count": 172 }, { "category_id": "459", "name": "Services", "slug": "services", "icon": "https://cdn.ouedkniss.com/medias/images/0Y1KV/ulvDC5PxAuNKGN2MFoKQ4X3qWEewhY0TYklqaPUj.svg", "has_delivery": null, "delivery_type": null, "is_without_exchange": null, "price_units": null, "count": 14 } ], "listings": [ { "listing_id": "55084822", "url": "https://www.ouedkniss.com/voitures-volkswagen-golf-8-2026-r-line-blida-algerie-d55084822", "title": "Volkswagen Golf 8 2026 R-Line", "slug": "voitures-volkswagen-golf-8-2026-r-line-blida-algerie", "description": "Véhicule neuf zéro compteur disponible sur commande pour plus d'informations contactez nous sur les numéros affichés", "refreshed_at": "2026-09-30T19:45:14.000Z", "created_at": null, "status": "PUBLISHED", "price_unit": "MILLION", "price_type": "FIXED", "price_currency": "DZD", "exchange_type": "NOT_EXCHANGEABLE", "view_count": null, "has_delivery": false, "delivery_type": null, "payment_method": null, "like_count": 5, "comments_enabled": true, "is_from_store": true, "category_id": "606", "category": null, "category_slug": "automobiles-voitures", "image": "https://cdn7.ouedkniss.com/400/medias/announcements/images/D94GzY/cxzCnz0w5w5FhSIO7LuL0mSRfctoKgmzG4Sns8NI.jpg", "images": [ "https://cdn7.ouedkniss.com/400/medias/announcements/images/D94GzY/cxzCnz0w5w5FhSIO7LuL0mSRfctoKgmzG4Sns8NI.jpg", "https://cdn7.ouedkniss.com/200/medias/announcements/images/D94GzY/cxzCnz0w5w5FhSIO7LuL0mSRfctoKgmzG4Sns8NI.jpg", "https://cdn8.ouedkniss.com/200/medias/announcements/images/D94GzY/ZCAmtzaQgNwIjSB9SkmyNR3AI3sTMXphqmokhqbU.jpg" ], "image_count": 10, "specs": [ { "codename": "car-engine", "label": null, "value": [ "1.5 TSI 160 ch" ] }, { "codename": "energie", "label": null, "value": [ "Essence" ] }, { "codename": "transmission", "label": null, "value": [ "Automatique" ] } ], "store": { "store_id": "35885", "name": "CHINA CAR GO ", "slug": "china-car-go", "url": "https://www.ouedkniss.com/store/35885/china-car-go", "image": "https://cdn.ouedkniss.com/medias/images/D94GzY/6VXcdSZ7XjDToBYLta4lYffg9DiGSnBahsIZiJ6p.jpg", "is_official": false, "is_verified": false, "follower_count": null, "announcements_count": null }, "seller_user_id": "14217817", "price": 5580000, "price_preview": 558, "price_display": "558 million centimes", "price_preview_basis": "total", "old_price": null, "old_price_preview": null, "old_price_display": null, "city_id": "290", "city": "Blida", "city_slug": "blida-290", "region_id": "9", "region": "Blida", "region_slug": "blida-9" }, { "listing_id": "56160862", "url": "https://www.ouedkniss.com/voitures-volkswagen-golf-8-2025-r-line-setif-algerie-d56160862", "title": "Volkswagen Golf 8 2025 R- Line ", "slug": "voitures-volkswagen-golf-8-2025-r-line-setif-algerie", "description": "8.5 ديازل محمولة وكالة دوبل دوسي جديدة", "refreshed_at": "2026-09-30T19:31:23.000Z", "created_at": null, "status": "PUBLISHED", "price_unit": "MILLION", "price_type": "NEGOTIABLE", "price_currency": "DZD", "exchange_type": "EXCHANGEABLE", "view_count": null, "has_delivery": false, "delivery_type": null, "payment_method": null, "like_count": 3, "comments_enabled": true, "is_from_store": true, "category_id": "606", "category": null, "category_slug": "automobiles-voitures", "image": "https://cdn9.ouedkniss.com/400/medias/announcements/images/wVjE78/cdAc9JxgvzirXtt6JULwoctfyiKXLcqdUDaRZobu.jpg", "images": [ "https://cdn9.ouedkniss.com/400/medias/announcements/images/wVjE78/cdAc9JxgvzirXtt6JULwoctfyiKXLcqdUDaRZobu.jpg", "https://cdn9.ouedkniss.com/200/medias/announcements/images/wVjE78/cdAc9JxgvzirXtt6JULwoctfyiKXLcqdUDaRZobu.jpg", "https://cdn9.ouedkniss.com/200/medias/announcements/images/wVjE78/VgDMp8Y8vWHBD5i7gsCKPYSWKe0YrimMHIHe3uZd.jpg" ], "image_count": 6, "specs": [ { "codename": "car-engine", "label": null, "value": [ "1.5 Turbo 160 ch " ] }, { "codename": "energie", "label": null, "value": [ "Diesel" ] }, { "codename": "kilometrage", "label": null, "value": [ "7000km" ] } ], "store": { "store_id": "38719", "name": "FK AUTO 19", "slug": "fk-auto-19", "url": "https://www.ouedkniss.com/store/38719/fk-auto-19", "image": "https://cdn.ouedkniss.com/medias/images/wVjE78/0Dx2c8480JS8CEIc8v4ONLTJ63pBA6sCe5PPiBnc.jpg", "is_official": false, "is_verified": false, "follower_count": null, "announcements_count": null }, "seller_user_id": "15180811", "price": null, "price_preview": null, "price_display": null, "price_preview_basis": null, "old_price": null, "old_price_preview": null, "old_price_display": null, "city_id": "734", "city": "Setif", "city_slug": "setif-734", "region_id": "19", "region": "Sétif", "region_slug": "stif-19" }, { "listing_id": "57705816", "url": "https://www.ouedkniss.com/voitures-volkswagen-golf-8-2021-gtd-belouizdad-alger-algerie-d57705816", "title": "Volkswagen Golf 8 2021 GTD", "slug": "voitures-volkswagen-golf-8-2021-gtd-belouizdad-alger-algerie", "description": "00 retouche", "refreshed_at": "2026-09-30T19:15:55.000Z", "created_at": null, "status": "PUBLISHED", "price_unit": "MILLION", "price_type": null, "price_currency": "DZD", "exchange_type": null, "view_count": null, "has_delivery": false, "delivery_type": null, "payment_method": null, "like_count": 4, "comments_enabled": true, "is_from_store": true, "category_id": "606", "category": null, "category_slug": "automobiles-voitures", "image": "https://cdn8.ouedkniss.com/400/medias/announcements/images/7LZRJ8/jOm6dzz0j4RuTocTWxJz5Pygw7YJHmDD9LXjPjSF.jpg", "images": [ "https://cdn8.ouedkniss.com/400/medias/announcements/images/7LZRJ8/jOm6dzz0j4RuTocTWxJz5Pygw7YJHmDD9LXjPjSF.jpg", "https://cdn8.ouedkniss.com/200/medias/announcements/images/7LZRJ8/jOm6dzz0j4RuTocTWxJz5Pygw7YJHmDD9LXjPjSF.jpg", "https://cdn9.ouedkniss.com/200/medias/announcements/images/7LZRJ8/HKudGj4B8jJaqRi40N9N3XAkWfPgkqBwpYfJETIV.jpg" ], "image_count": 16, "specs": [ { "codename": "car-engine", "label": null, "value": [ "2.0 TDI 200ch" ] }, { "codename": "energie", "label": null, "value": [ "Diesel" ] }, { "codename": "kilometrage", "label": null, "value": [ "143000km" ] } ], "store": { "store_id": "34426", "name": "NaNi auto", "slug": "nani-auto", "url": "https://www.ouedkniss.com/store/34426/nani-auto", "image": "https://cdn.ouedkniss.com/medias/images/7LZRJ8/EZbUWrJKUMoxnnO3T9BUKfKTogX0adcRrIiuuBCy.jpg", "is_official": false, "is_verified": false, "follower_count": null, "announcements_count": null }, "seller_user_id": "13860484", "price": null, "price_preview": null, "price_display": null, "price_preview_basis": null, "old_price": null, "old_price_preview": null, "old_price_display": null, "city_id": "565", "city": "Belouizdad", "city_slug": "belouizdad-565", "region_id": "16", "region": "Alger", "region_slug": "alger-16" } ] } }
How the Ouedkniss API works
Ouedkniss is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 321 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
The number Ouedkniss prints is scaled by its category, the price is always in dinars
This is the one thing that will bite you on this site. Ouedkniss carries two figures: a price in dinars, and a preview number rendered in whatever unit its category uses. Measured across 144 rows, that unit is 1 in some categories, MILLION in others and BILLION in others, and in property categories it is a per-square-metre rate rather than a total. Publishing the preview as the price would show a car at ten thousand times less than it costs. Both come back here, with the basis that explains them.
{"language": "fr"}The category tree with the slugs search accepts. An unknown slug otherwise reads as an empty category.
{"query": "iphone 13", "region_ids": ["16"]}Ads with both price surfaces, the wilaya and city with their ids, seller type and images.
{"listing_id": 54590864}One ad in full, in French, Arabic or English.
{"query": "phone"}Shops, when you want a dealer's whole inventory rather than one ad.
Algerian classified ads with the price in dinars, the site's own preview figure beside it with its scale, the wilaya and city ids, the seller type and the images, in French, Arabic or English.
curl -X POST https://api.reefapi.com/ouedkniss/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{}'{
"ok": true,
"data": { … },
"meta": {
"api": "ouedkniss",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}Algeria, in dinars, and one ad in five carries no price at all
Measured 2026-10-01 against the live gateway: 38 fixed cases run twice (37/38 and 38/38), 780 rows for the field counts. Three of these lines go against us.
Algeria, prices in DZD. Content is French and Arabic; the language handle was measured working, not assumed.
listing_id, url, title, city, city_id, region, region_id, refreshed_at, category_slug and status on 100% of 780 rows. image and images 98.3%.
The rest genuinely carry no price. description 85.9%, price_type 67%. Nothing is filled in where the source published nothing.
On one page, 28 of 48 cars had no price while the source still wrote a preview figure of 0. All three price fields come back null there instead, and the count is published rather than hidden.
It reported 88 while the paginator said 93, and with an explicit category it collapses to the page size. Only the paginator total is published.
A price-unit and a connected-seller parameter are both accepted by the source and change the total by nothing at all (93 to 93, 88 to 88), so neither is offered. An autocomplete action was written and then deleted because it is in the site's bundle but not in its live schema.
The exit layer resets roughly one connection in three or four before any bytes arrive. That is bounded to five retries on different exits with real backoff and typed as a timeout, never as a block.
What people build with Ouedkniss
The jobs this data is most often used for.
endpoints
credit per call
Pricing and assortment teams use Ouedkniss to search Ouedkniss classifieds by keyword and/or category, filtered by wilaya (region) ids, cit….
Brand-protection teams use Ouedkniss to get full detail of one Ouedkniss ad.
Retail analysts use Ouedkniss to get the live Ouedkniss category tree.
Catalog enrichment teams use Ouedkniss to search the professional stores (boutiques) on Ouedkniss by name or keyword, with their locati….
What Ouedkniss data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
Full pricing →- 1,000 free credits on signup, no card
- One key, all 321 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/ouedkniss/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{}'import requests
r = requests.post(
"https://api.reefapi.com/ouedkniss/v1/search",
headers={"x-api-key": REEF_KEY},
json={},
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Ouedkniss.
Get a free key →What is the Ouedkniss API?▾
Ouedkniss API is a ReefAPI endpoint group for ouedkniss It returns live JSON through POST requests under /ouedkniss/v1.
Is the Ouedkniss API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Ouedkniss calls use the same shared credit balance as every other ReefAPI engine.
Do I need an Ouedkniss login or account?▾
No login to Ouedkniss is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Ouedkniss data?▾
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Ouedkniss API use?▾
Ouedkniss actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Ouedkniss from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call ouedkniss actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Ouedkniss API an Ouedkniss scraper?▾
It is the managed alternative to a DIY Ouedkniss scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same ouedkniss back as clean JSON.
Why does my Ouedkniss scraper keep getting blocked?▾
Most Ouedkniss scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.
26 More APIs APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Ouedkniss, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 320 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-10-01.