# Rics — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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.

> Search the RICS-regulated surveying firm directory by location, firm name, keyword, and service category, and retrieve suggested places/locations to power autocomplete.

**Category:** Business Directories | **Website:** [rics.org/](https://rics.org/) | **Docs:** [parse.bot/marketplace/df6c8f1a-0ff3-497f-b3e8-c62d2d05ba5f/rics-org-api](https://parse.bot/marketplace/df6c8f1a-0ff3-497f-b3e8-c62d2d05ba5f/rics-org-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-rics-org-api-df6c8f1a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_places

Get available locations/places for use in search_firms location parameter. Returns matching places with their IDs and parent regions. Use the place name in the location parameter of search_firms.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country code filter. |
| `query` | string | No | Filter query to match place names (e.g. 'London', 'Manchester'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rics-org-api-df6c8f1a/get_places \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","query":"<string>"}'
```

### search_firms

Search for RICS regulated surveying firms by location, firm name, or keyword. Returns paginated results with firm contact details, service areas, and available service filter facets. At least one of location, firm_name, or keyword should be provided for meaningful results. Pagination advances via the page parameter; service_facets in the response enumerate available service filters with their counts for the current query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `firm_name` | string | No | Firm name to search for. |
| `keyword` | string | No | Keyword search (e.g. 'party wall', 'valuation', 'building survey'). |
| `location` | string | No | Location name to search within (e.g. 'London', 'Manchester', 'Birmingham'). |
| `page` | integer | No | Page number for pagination. |
| `page_size` | integer | No | Results per page. |
| `service_id` | string | No | Service type ID for filtering results. IDs available from the service_facets field in search results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-rics-org-api-df6c8f1a/search_firms \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"firm_name":"<string>","keyword":"<string>","location":"<string>","page":"<integer>","page_size":"<integer>","service_id":"<string>"}'
```