# Yardi — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access Yardi's latest news, press releases, and company content by searching across all articles, filtering and browsing posts by category, or retrieving detailed information about individual stories. Quickly find relevant Yardi company updates and announcements through powerful search and category browsing capabilities.

**Category:** News & Media | **Website:** [www.yardi.com/](https://www.yardi.com/) | **Docs:** [parse.bot/marketplace/7ddae870-da20-4631-ade6-01984c187700/yardi-com-api](https://parse.bot/marketplace/7ddae870-da20-4631-ade6-01984c187700/yardi-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/yardi/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get categories

List available post categories with their IDs, names, and post counts. Use category IDs to filter posts in the get_posts endpoint. Returns all categories when per_page is large enough.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `per_page` | integer | No | Number of categories per page, between 1 and 100. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/yardi/get-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","per_page":"<integer>"}'
```

### Get post

Get the full details of a single post by its numeric ID, including full content as plain text. Post IDs can be obtained from the search or get_posts endpoints. Returns 422 if the post does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `post_id` | string | Yes | Numeric post ID (e.g. '405699'). Obtained from search or get_posts results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/yardi/get-post \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"post_id":"<string>"}'
```

### Get posts

Get news posts and press releases from Yardi, with optional search and category filtering. Returns paginated results ordered by date descending. Each post includes title, excerpt, publication date, categories, and media references. Use category IDs from get_categories to filter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `categories` | string | No | Comma-separated category IDs to filter by (e.g. '9849' for Press Releases, '9834' for News). Category IDs can be obtained from the get_categories endpoint. |
| `page` | integer | No | Page number for pagination. |
| `per_page` | integer | No | Number of posts per page, between 1 and 100. |
| `search` | string | No | Filter posts by search term. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/yardi/get-posts \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"categories":"<string>","page":"<integer>","per_page":"<integer>","search":"<string>"}'
```

### Search

Search across all Yardi content types including posts, pages, resources, client stories, solutions, and files. Returns paginated results with title, URL, and content type information. Paginates via integer page number; total and total_pages indicate result depth. The subtype filter restricts to one content kind when set.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `per_page` | integer | No | Number of results per page, between 1 and 100. |
| `query` | string | Yes | Search query string. |
| `subtype` | string | No | Filter by content subtype. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/yardi/search \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","per_page":"<integer>","query":"<string>","subtype":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.