Ouedkniss API & Scraper
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….
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
Developers reach for it when they need to read second-hand listings, asking prices, seller inventory and country-specific listing ids without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a Ouedkniss scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, listing, categories, stores. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/ouedkniss/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "iphone 13"
}
}{
"ok": true,
"meta": {
"api": "ouedkniss",
"endpoint": "search",
"mode": "live",
"latency_ms": 684,
"record_count": 1,
"bytes": 4036,
"cache_hit": false,
"source_total": 1,
"charged_credits": 1,
"version": "1.0.0",
"request_id": "a0bb8ee1a90e4bcf",
"queue_ms": 1.2,
"fetched_at": "2026-11-03T17:32:11.273Z"
},
"data": {
"query": "iphone 13",
"language": "fr",
"page": 1,
"page_size": 24,
"sort": "refreshed",
"currency": "DZD",
"total_results": 1,
"last_page": 1,
"has_more": false,
"matched_category": {
"category_id": "46",
"name": "Pièces détachées",
"slug": "pieces_detachees",
"icon": "https://cdn.ouedkniss.com/medias/images/0Y1KV/UaZi9xF1V5SiLRrGKJ6Wv2vug1V4SMyQwQXL0hDJ.svg",
"has_delivery": true,
"delivery_type": "PRODUCT",
"is_without_exchange": false,
"price_units": [
"UNIT"
]
},
"suggested_categories": [],
"listings": [
{
"listing_id": "58469766",
"url": "https://www.ouedkniss.com/optiques-eclairage-cache-antibrouillards-audi-q5-ben-aknoun-alger-algerie-d58469766",
"title": "Cache antibrouillards audi Q5",
"slug": "optiques-eclairage-cache-antibrouillards-audi-q5-ben-aknoun-alger-algerie",
"description": "Cache anti brouillard audi",
"refreshed_at": "2026-11-03T12:59:51.000Z",
"created_at": null,
"status": "PUBLISHED",
"price_unit": "UNIT",
"price_type": "NEGOTIABLE",
"price_currency": "DZD",
"exchange_type": "NOT_EXCHANGEABLE",
"view_count": null,
"has_delivery": false,
"delivery_type": null,
"payment_method": null,
"like_count": 0,
"comments_enabled": true,
"is_from_store": false,
"category_id": "613",
"category": null,
"category_slug": "pieces_detachees-pieces_automobiles-optiques_eclairage",
"image": "https://cdn8.ouedkniss.com/400/medias/announcements/images/K32l/OblTGwrT70Ch8cRatXuZNpCL3XkJquPJlQg9HInk.jpg",
"images": [
"https://cdn8.ouedkniss.com/400/medias/announcements/images/K32l/OblTGwrT70Ch8cRatXuZNpCL3XkJquPJlQg9HInk.jpg",
"https://cdn8.ouedkniss.com/200/medias/announcements/images/K32l/OblTGwrT70Ch8cRatXuZNpCL3XkJquPJlQg9HInk.jpg",
"https://cdn7.ouedkniss.com/200/medias/announcements/images/K32l/D3b6zHbPMkaYFnjA8ntvlB1y26h0rV7N16ND4WNZ.jpg"
],
"image_count": 3,
"specs": [],
"store": null,
"seller_user_id": "68665",
"price": 11111,
"price_preview": 11111,
"price_display": "11111 DZD",
"price_preview_basis": "total",
"old_price": null,
"old_price_preview": null,
"old_price_display": null,
"city_id": "566",
"city": "Ben aknoun",
"city_slug": "ben-aknoun-566",
"region_id": "16",
"region": "Alger",
"region_slug": "alger-16"
}
]
}
}What the Ouedkniss API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Ouedkniss classifieds by keyword and/or category, filtered by wilaya (region) ids, city ids, price band, has-photo and has-price, with two sorts and paging (up to 48 ads per page). Give at least `query` or `category`. Returns the source's own `total_results`, the category Ouedkniss matched the search to, and the sibling categories it suggests. | Price-intelligence teams call search to search Ouedkniss classifieds by keyword and/or category, filtered by wilaya (region) ids, cit…. | query, category, region_ids, city_ids, price_min, ... |
| listing | Full detail of one Ouedkniss ad: title, complete description, price with its unit, wilaya and city, the store or private seller, every photo at full size and the ad's own specification table. Accepts the ad id or the ad URL. | Classifieds aggregators call listing to get full detail of one Ouedkniss ad. | listing_id, url, language |
| categories | The live Ouedkniss category tree — the resolver `search` needs, because a category slug is the strongest filter the marketplace has. With no `category` it returns the top-level categories off the site's own menu; with a `category` slug it returns that category with its children, its parent chain, its price units and its filterable specifications (each with the value list Ouedkniss allows), plus how many ads sit under it right now. | Resale and arbitrage tools call categories to get the live Ouedkniss category tree. | category, language |
| stores | Search the professional stores (boutiques) on Ouedkniss by name or keyword, with their location, follower count and how many ads they run. | Lead-generation teams call stores to search the professional stores (boutiques) on Ouedkniss by name or keyword, with their locati…. | query, page, page_size, language |
Call search from your stack
curl -X POST https://api.reefapi.com/ouedkniss/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone 13"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/ouedkniss/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "iphone 13"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/ouedkniss/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "iphone 13"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.ouedkniss.search with {"query":"iphone 13"}.Who uses this API and why
- Price-intelligence teams use Ouedkniss to search Ouedkniss classifieds by keyword and/or category, filtered by wilaya (region) ids, cit….
- Classifieds aggregators use Ouedkniss to get full detail of one Ouedkniss ad.
- Resale and arbitrage tools use Ouedkniss to get the live Ouedkniss category tree.
- Lead-generation teams use Ouedkniss to search the professional stores (boutiques) on Ouedkniss by name or keyword, with their locati….
Questions developers ask before integrating
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.