> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meetjamie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Meetings

> Semantic search across your meeting content

```
GET /v1/me/meetings.search
```

Searches across your meetings using semantic similarity matching. Returns matching text chunks with their source meeting. Only available with a **personal** API key.

Results are drawn from meetings within the last 6 months by default, returning up to 40 matches ranked by relevance.

## Parameters

| Parameter   | Type   | Description                                                         |
| ----------- | ------ | ------------------------------------------------------------------- |
| `query`     | string | **Required.** The search query                                      |
| `startDate` | string | ISO 8601 date. Only search meetings starting on or after this date  |
| `endDate`   | string | ISO 8601 date. Only search meetings starting on or before this date |

## Example Request

```bash theme={null}
curl -H "x-api-key: jk_your_personal_key" \
  'https://beta-api.meetjamie.ai/v1/me/meetings.search?input={"json":{"query":"product roadmap"}}'
```

## Example Response

```json theme={null}
{
  "result": {
    "data": {
      "json": {
        "results": [
          {
            "id": "chunk-001",
            "text": "We need to finalize the product roadmap for Q1 before the holidays...",
            "meetingId": "7893456789012345678",
            "meetingTitle": "Q4 Planning Meeting",
            "meetingDate": "2024-11-27"
          },
          {
            "id": "chunk-002",
            "text": "The roadmap priorities should focus on mobile redesign and API improvements...",
            "meetingId": "7893456789012345679",
            "meetingTitle": "Product Sync",
            "meetingDate": "2024-11-20"
          }
        ]
      }
    }
  }
}
```

## Response Fields

| Field                    | Type           | Description                                       |
| ------------------------ | -------------- | ------------------------------------------------- |
| `results`                | array          | List of matching text chunks, ranked by relevance |
| `results[].id`           | string         | Unique chunk ID                                   |
| `results[].text`         | string         | The matching text excerpt                         |
| `results[].meetingId`    | string         | ID of the source meeting                          |
| `results[].meetingTitle` | string \| null | Title of the source meeting                       |
| `results[].meetingDate`  | string         | Date of the meeting (`YYYY-MM-DD`)                |

## Common Patterns

**Search with a date range:**

```bash theme={null}
curl -H "x-api-key: jk_your_personal_key" \
  'https://beta-api.meetjamie.ai/v1/me/meetings.search?input={"json":{"query":"hiring plan","startDate":"2024-10-01T00:00:00Z","endDate":"2024-12-01T00:00:00Z"}}'
```

<Info>
  This endpoint is only available with a personal API key. It searches across your own meetings and meetings shared with you.
</Info>
