Slickdeals

Search Slickdeals with real pagination, counts, and facets

Searches Slickdeals' modern search surface -- a richer alternative to GET /slickdeals/search's keyword-only search. Returns real pagination (page/total_pages/per_page/result_count), integer vote/comment/view counts (not parsed from free text), a fuller per-deal record (store id, discount percent, status flags), and facets -- Categories, Stores, and Brands available for the current query, each option carrying a value usable as category_id/brand_id/store_id. Facet values and counts are scoped to the current query, not a site-wide enumeration -- category_id/brand_id/store_id are passthrough filters (obtain a value from a prior response's own facets), not validated against a closed enum. sort defaults to relevance; other values are passed through unvalidated.

get/slickdeals/search/advanced

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/slickdeals/search/advanced
  • Auth: API key in header x-api-key

Query parameters

qstring required

Free-text keyword query

pageinteger

1-based result page, default 1

sortstring

Sort order, default relevance

category_idinteger

Category facet id, from a prior response's own facets

brand_idinteger

Brand facet id, from a prior response's own facets

store_idinteger

Store facet id, from a prior response's own facets

Headers

x-api-keystring required

API key required

Response

OK

codeinteger

Code is the HTTP status code or a custom code used to indicate the result of the request @example 200

msgunknown

Example response

{
  "data": {
    "facets": [
      {
        "label": "Categories",
        "options": [
          {
            "count": 27,
            "label": "Laptops",
            "value": "34"
          }
        ]
      }
    ],
    "page": 1,
    "per_page": 40,
    "query": "laptop",
    "result_count": 915,
    "results": [
      {
        "comment_count": 4,
        "discount": 26,
        "final_price": "$66",
        "forum_id": 9,
        "found_by": "htp182",
        "is_frontpage": true,
        "is_popular": true,
        "list_price": "$90",
        "store": "Newegg",
        "store_id": 701,
        "thread_id": 19618338,
        "title": "Anker 4-Port up to 140W USB-C Laptop Charger w/ 5' Cable",
        "views_count": 3274,
        "vote_score": 20
      }
    ],
    "total_pages": 23
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.