Search & Facets API — free mock REST API for testing

A compact search engine lab with category facets, score sorting, highlights and cursor pagination.

The Search & Facets API is a query surface rather than a CRUD one: full-text search with facet counts, highlighted snippets and cursor pagination. Two endpoints, but the response is the most structurally complex in the catalog — the right target for a contract test that has to survive a nested, variable-shaped payload.

Base URL: https://funapi.dev/api/search/v1 · 2 endpoints · OpenAPI 3.1 spec and Postman collection available. New here? Read the getting started guide.

Example request and response

GET https://funapi.dev/api/search/v1/items — Search items with facets and cursor. No token, no signup:

curl -i https://funapi.dev/api/search/v1/items

answers 200 OK with:

{
  "total": 4,
  "data": [
    {
      "id": 1,
      "title": "Moon Pizza",
      "category": "food",
      "tags": [
        "space",
        "cheese"
      ],
      "score": 9.1,
      "highlight": "Moon Pizza"
    },
    {
      "id": 2,
      "title": "Dragon Debugger",
      "category": "tools",
      "tags": [
        "fantasy",
        "code"
      ],
      "score": 8.7,
      "highlight": "Dragon Debugger"
    },
    {
      "id": 3,
      "title": "Pocket Monster Manual",
      "category": "books",
      "tags": [
        "creatures",
        "training"
      ],
      "score": 8.3,
      "highlight": "Pocket Monster Manual"
    },
    {
      "id": 4,
      "title": "Wizard Wireless",
      "category": "tools",
      "tags": [
        "magic",
        "network"
      ],
      "score": 7.9,
      "highlight": "Wizard Wireless"
    }
  ],
  "facets": {
    "category": [
      {
        "value": "food",
        "count": 1
      },
      {
        "value": "tools",
        "count": 2
      },
      {
        "value": "books",
        "count": 1
      }
    ]
  },

(truncated — the full response comes back when you run it)

Open and run this endpoint

What you can practise here

• Run a query and assert on facet counts as well as hits, since the two can disagree when filters are applied.
• Page through results by cursor and confirm nothing is duplicated or skipped between pages.
• Send a malformed query expression and read the 400.
• Search for a term with no matches and confirm the empty result is a 200.

search

query and discover

• GET /search/v1/items — Search items with facets and cursor · Responds with 200 400 Link to this endpoint
• GET /search/v1/suggest — Autocomplete suggestions · Responds with 200 Link to this endpoint

Related APIs

• Auth Playground API — OAuth 2.0 flows — client credentials, auth code, refresh & expiry.
• Webhooks API — Register callbacks, trigger events, inspect & replay deliveries.
• Protocol Lab API — Async jobs, redirects, 503/504, JSON Patch & content negotiation.
• Object Storage API — Objects, checksums, ranges & resumable uploads.

All 39 mock REST APIs

Last updated 6 September 2026