---
title: "Search the resources library"
method: GET
path: "/v1/resources"
---

# Search the resources library

`GET /v1/resources`

## Request

- Base URL: `https://shipshapedata.com/api`
- URL: `https://shipshapedata.com/api/v1/resources`
- Auth: none declared

Full-text search across 169 practical guides on data and AI, with opaque cursor pagination: follow nextCursor from each page until it is null. Each result lists the questions the guide answers; every page also serves a markdown twin at its URL plus index.md.

## Query parameters

- `q` string
- `category` string
- `limit` integer
- `cursor` string

## Response `200`

One page of matching guides

- ResourceSearchPage
  - `query` string, required
  - `count` integer, required: Results on this page
  - `nextCursor` string, nullable: Opaque token for the next page; null when this is the last page
  - `results` Resource[], required
    - `title` string, required
    - `slug` string, required
    - `url` string, uri, required
    - `category` string, required
    - `description` string, required
    - `answers` string[]: The questions this guide answers
    - `relevance` integer: Present on keyword searches: how many query terms matched

## Other responses

- `400`: Invalid input

---

[API](https://skmtc.dev/shipshapedata/apis/shipshape-data-api.md) · [All operations](https://skmtc.dev/shipshapedata/apis/shipshape-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/shipshapedata/apis/shipshape-data-api/revisions/2d494a3e5dbc?raw)