# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-api-developer-attomdata-com-api-d561541e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-api-developer-attomdata-com-api-d561541e/get_poi_search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-api-developer-attomdata-com-api-d561541e/get_property_address \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-api-developer-attomdata-com-api-d561541e/get_property_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-api-developer-attomdata-com-api-d561541e/get_property_detail_owner \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-api-developer-attomdata-com-api-d561541e/get_transaction_sales_trend \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"endyear":"<integer>","geoidv4":"<string>","interval":"<string>","page":"<integer>","pagesize":"<integer>","propertytype":"<string>","startyear":"<integer>"}'
```