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 Ouedkniss API page →
Classifieds & Second-hand

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

4 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

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

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/ouedkniss/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "iphone 13"
  }
}
Captured response
{
  "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"
      }
    ]
  }
}
Actions

What the Ouedkniss API does

ActionDescriptionConcrete use caseKey params
searchSearch 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, ...
listingFull 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
categoriesThe 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
storesSearch 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
Code samples

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"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.ouedkniss.search with {"query":"iphone 13"}.
Use cases

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….
FAQ

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.

docs / ouedkniss

Ouedkniss

Ouedkniss

base /ouedkniss/v14 endpoints
post/ouedkniss/v1/listing1 credit

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.

ParameterAllowed / rangeDescription
listing_idoptional—Numeric ad id — the digits after `-d` in the ad URL. Give `listing_id` or `url`.
urloptional—Full ouedkniss.com ad URL; the id is taken from it. Give `listing_id` or `url`.
language = froptionalfr · ar · enLanguage of the category and specification LABELS Ouedkniss returns. Ad titles and descriptions come back exactly as the seller typed them and are never translated.
Try in playground →
post/ouedkniss/v1/categories1 credit

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.

ParameterAllowed / rangeDescription
categoryoptional—Category slug to open, e.g. `telephones`, `automobiles-voitures`. Omit to list the top-level categories.
language = froptionalfr · ar · enLanguage of the category and specification LABELS Ouedkniss returns. Ad titles and descriptions come back exactly as the seller typed them and are never translated.
Try in playground →
post/ouedkniss/v1/stores1 credit

Search the professional stores (boutiques) on Ouedkniss by name or keyword, with their location, follower count and how many ads they run.

ParameterAllowed / rangeDescription
queryrequired—Store name or keyword.
page = 1optional1–100001-based page number.
page_size = 24optional1–48Stores per page, 1-48.
language = froptionalfr · ar · enLanguage of the category and specification LABELS Ouedkniss returns. Ad titles and descriptions come back exactly as the seller typed them and are never translated.
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.