# Attomdata — 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.

> Look up comprehensive property details including ownership information, neighborhood data, and historical transaction trends for any address. Search for points of interest and analyze sales trends to make informed real estate decisions.

**Category:** Real Estate | **Website:** [api.developer.attomdata.com/](https://api.developer.attomdata.com/) | **Docs:** [parse.bot/marketplace/d561541e-2561-4944-9fe0-d29ca4186e2c/api-developer-attomdata-com-api](https://parse.bot/marketplace/d561541e-2561-4944-9fe0-d29ca4186e2c/api-developer-attomdata-com-api)

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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/attomdata/`
**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 poi search

Returns points of interest in proximity to a location. Search by address, zip code, or geographic point.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | No | Street address to search near (e.g., '90 broad street, new york, ny 10004') |
| `categoryid` | string | No | POI category ID filter |
| `categoryname` | string | No | POI category name filter (e.g., 'PERSONAL SERVICES') |
| `industryname` | string | No | Industry name filter (e.g., 'ATTORNEYS') |
| `lineofbusinessname` | string | No | Line of business filter (e.g., 'MISC SERVICES') |
| `page` | integer | No | Page number |
| `pagesize` | integer | No | Results per page |
| `point` | string | No | Geographic point in format POINT(longitude,latitude), e.g. 'POINT(-74.019215,40.706554)' |
| `radius` | number | No | Search radius in miles |
| `recordlimit` | integer | No | Maximum number of results (default 20) |
| `searchdistance` | number | No | Search distance in miles (default 5) |
| `zipcode` | string | No | ZIP code to search near |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/attomdata/get-poi-search \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>","categoryid":"<string>","categoryname":"<string>","industryname":"<string>","lineofbusinessname":"<string>","page":"<integer>","pagesize":"<integer>","point":"<string>","radius":"<number>","recordlimit":"<integer>","searchdistance":"<number>","zipcode":"<string>"}'
```

### Get property address

Returns properties within a specified area or matching address criteria.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address1` | string | No | Street address line 1 |
| `address2` | string | No | City, state, zip |
| `latitude` | number | No | Latitude for radius search |
| `longitude` | number | No | Longitude for radius search |
| `page` | integer | No | Page number |
| `pagesize` | integer | No | Results per page |
| `postalcode` | string | No | Postal/ZIP code to search |
| `propertytype` | string | No | Property type filter |
| `radius` | number | No | Search radius in miles |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/attomdata/get-property-address \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"address1":"<string>","address2":"<string>","latitude":"<number>","longitude":"<number>","page":"<integer>","pagesize":"<integer>","postalcode":"<string>","propertytype":"<string>","radius":"<number>"}'
```

### Get property detail

Returns rich property details for a specific property.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address1` | string | No | Street address line 1 |
| `address2` | string | No | City, state, zip |
| `attomid` | string | No | ATTOM property ID |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/attomdata/get-property-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"address1":"<string>","address2":"<string>","attomid":"<string>"}'
```

### Get property detail owner

Returns detailed property data including current owner information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `attomid` | string | Yes | ATTOM property ID |

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

### Get transaction sales trend

Returns sales trends for a given geography. The geoIdV4 must be a 32-character hex hash obtained from the geoIdV4 field in property responses (e.g., from get_property_detail). Common prefixes: ZI=zip code, CO=county, PL=place, CS=census, DB=district.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `endyear` | integer | Yes | End year for trend data |
| `geoidv4` | string | Yes | Geography ID v4 hash (32-char hex, e.g. 'de85b56260373aeb01f40ebcce4e7a30') |
| `interval` | string | No | Trend interval: 'yearly' or 'monthly' |
| `page` | integer | No | Page number |
| `pagesize` | integer | No | Results per page |
| `propertytype` | string | No | Property type filter |
| `startyear` | integer | Yes | Start year for trend data |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/attomdata/get-transaction-sales-trend \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"endyear":"<integer>","geoidv4":"<string>","interval":"<string>","page":"<integer>","pagesize":"<integer>","propertytype":"<string>","startyear":"<integer>"}'
```

## Next steps

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