# Harvard.edu Faculty Profiles API

> Faculty profiles on harvard.edu, with image and title fields, plus search and filter inputs.

- Page: https://cleanedweb.com/catalog/harvard-edu-faculty-profiles-api/
- Contract (JSON): https://cleanedweb.com/catalog/harvard-edu-faculty-profiles-api/contract.json
- Source: hks.harvard.edu (https://www.hks.harvard.edu/)
- Category: Social & communities
- Updated: 2026-11-19

A run reads until the source ends or your `max_items`, `timeout_seconds` or budget stops it.

## Key fields

| Field | Type | Sample value |
| --- | --- | --- |
| `title` | string | `Khalil Abdur-Rashid` |
| `url` | string | `https://www.hks.harvard.edu/faculty/khalil-abdur-rashid` |
| `image_url` | string | `https://www.hks.harvard.edu/sites/default/files/styles/employee_grayscale/public/bio_images/18281-1783463434.jpg?itok=EtWOtaGL` |
| `alt` | string | `Khalil Abdur-Rashid Photo` |
| `appointment` | string | `Lecturer on Muslim Studies, HDS` |
| `field_label` | string | `Appointment` |
| `hover` | boolean | `true` |
| `course` | string | `DPI-398` |

Sample values come from one saved record, not a live run. Every field with its type, and the schemas, are in https://cleanedweb.com/catalog/harvard-edu-faculty-profiles-api/contract.json. Some fields the source returns are not published, so a record can carry fields the schema does not list.

## Inputs

- `search` (string \| array of string): Optional. Text for the site's search box. Leave it out to read everything.
- `f_0` (string): Optional. Filters by the site's f 0 control. Options: Advocacy & Social Movements (14) (policy_topics:211), Business & Regulation (28) (policy_topics:141), Cities & Communities (27) (policy_topics:146), Decision Making & Negotiation (27) (policy_topics:151), Democracy & Governance (44) (policy_topics:156), Development & Economic Growth (26) (policy_topics:161), Education, Training & Labor (25) (policy_topics:171), Environment & Energy (24) (policy_topics:176), and 26 more in https://cleanedweb.com/catalog/harvard-edu-faculty-profiles-api/contract.json.
- `f_1` (string): Optional. Filters by the site's f 1 control. Options: Fairness & Justice (5) (policy_topics:18176), Politics (4) (policy_topics:221), Science, Technology & Data (1) (policy_topics:236), Social Innovation & Philanthropy (3) (policy_topics:241), Social Policy (4) (policy_topics:231).

`enrich_records` is on by default and adds the fields that only appear on each record's detail page. Send `false` to read list fields only. See https://cleanedweb.com/docs/run-api/

## Request

`POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_f5b15ff09b0757fabf187be5/endpoints/generated_f5b15ff09b0757fabf187be5_search/run`

```bash
curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_f5b15ff09b0757fabf187be5/endpoints/generated_f5b15ff09b0757fabf187be5_search/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: UNIQUE_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "f_0": "policy_topics:211"
  },
  "version": 1,
  "max_items": 25
}'
```

Send an `Idempotency-Key` header with every run and save it before you send. Reuse it only to retry the same request. If the run does not end within `wait_seconds`, read the result with the same API key and key:

`GET https://api.cleanedweb.com/v1/catalog/public/apis/generated_f5b15ff09b0757fabf187be5/endpoints/generated_f5b15ff09b0757fabf187be5_search/result`

## Versions

Current: `1.0`. Pin a major with "version": N in the run body (an integer). Leave it out and the call runs on the latest major. A sunset major runs on the latest major and the response says rerouted. An unknown major answers 404 catalog_version_not_found and lists the available majors.

- v1: current, newest minor `1.0`

### Changelog

- `1.0` (major) 2026-11-18

The same changelog, as data, is in https://cleanedweb.com/catalog/harvard-edu-faculty-profiles-api/contract.json

## Use it from an AI agent

MCP server: https://api.cleanedweb.com/mcp?profile=catalog (Streamable HTTP). Sign in with a CleanedWeb account when the client asks (OAuth), or send an API key with the `read` and `run` scopes as `Authorization: Bearer`. Call `get_api` with `api_id` `generated_f5b15ff09b0757fabf187be5`, then `run_api` with the `run_with` arguments it returns. See https://cleanedweb.com/docs/mcp/

## Run it

Reading the catalog needs no credential. Running needs a CleanedWeb account and an API key with the `run` scope; the first 5,000 records are free, then $1 per 1,000 records. See https://cleanedweb.com/docs/run-catalog-api/

CleanedWeb is not affiliated with Harvard.
