---
title: "Public Projects Search"
method: POST
path: "/projects/search"
tags: ["projects"]
---

# Public Projects Search

`POST /projects/search`

Returns a list of public articles

## Headers

- `X-Cursor` string

## Request body

- ProjectsSearch
  - `search_for` string — Search term
  - `page` integer — Page number. Used for pagination with page_size
  - `page_size` integer — The number of results included on a page. Used for pagination with page
  - `limit` integer — Number of results included on a page. Used for pagination with query
  - `offset` integer — Where to start the listing (the offset of the first result). Used for pagination with limit
  - `order_direction` 'asc' | 'desc' — Direction of ordering
  - `institution` integer — only return collections from this institution
  - `published_since` string — Filter by article publishing date. Will only return articles published after the date. date(ISO 8601) YYYY-MM-DD or date-time(ISO 8601) YYYY-MM-DDTHH:mm:ssZ
  - `modified_since` string — Filter by article modified date. Will only return articles modified after the date. date(ISO 8601) YYYY-MM-DD or date-time(ISO 8601) YYYY-MM-DDTHH:mm:ssZ
  - `group` integer — only return collections from this group

## Response `200`

OK. An array of projects

- Project[]
  - `url` string, required — Api endpoint
  - `id` integer, required — Project id
  - `title` string, required — Project title
  - `created_date` string, required — Date when project was created
  - `modified_date` string, required — Date when project was last modified
  - `published_date` string — Date when project was first published, null if not published

## Other responses

- `400` — Bad Request
- `422` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/figshare/apis/figshare-api.md) · [All operations](https://skmtc.net/figshare/apis/figshare-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/figshare/figshare-api/versions/9dfb419f4430/schema)