auctioneers APIauctioneers.org ↗
Search and retrieve professional auctioneer profiles from the National Auction Association directory. Filter by state, specialty, designation, and location.
What is the auctioneers API?
This API exposes 4 endpoints for searching and retrieving member profiles from the National Auction Association (NAA) directory. The search_auctioneers endpoint accepts filters for state, city, ZIP code, specialty category, and NAA designation, returning paginated results with contact details, company info, and profile URLs. Individual profiles are accessible via get_auctioneer_profile, which returns bio text, membership dates, social links, and structured contact fields.
curl -X GET 'https://api.parse.bot/scraper/9907bc4c-92fb-4f0f-b852-de27eef0b10e/search_auctioneers?page=0&limit=3&state=TX' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace auctioneers-org-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: NAA Auctioneer Directory — search, filter, drill into profiles."""
from parse_apis.naa_auctioneer_directory_api import NAA, DesignationCode, AuctioneerNotFound
client = NAA()
# List available specialty categories
for cat in client.categories.list(limit=5):
print(cat.name, cat.slug)
# List NAA professional designations
for desig in client.designations.list(limit=5):
print(desig.name, desig.value)
# Search auctioneers in Texas with CAI designation
for auctioneer in client.auctioneers.search(state="TX", designation=DesignationCode.CAI, limit=3):
print(auctioneer.name, auctioneer.company, auctioneer.location.city)
# Drill into a single auctioneer's full profile
auctioneer = client.auctioneers.search(state="CA", limit=1).first()
if auctioneer:
profile = auctioneer.profile.get()
print(profile.name, profile.bio, profile.dates.member_since)
# Typed error handling for a missing auctioneer
try:
detail = client.auctioneers.get(slug="nonexistent-person-xyz")
print(detail.name)
except AuctioneerNotFound as exc:
print(f"Not found: {exc.slug}")
print("exercised: categories.list / designations.list / auctioneers.search / profile.get / auctioneers.get")
Search for auctioneers in the NAA directory with optional filters for location, specialty category, and designation. Returns paginated results. Supports filtering by state, city, ZIP, specialty category slug, NAA designation slug, and state-licensed. Pagination is zero-indexed.
| Param | Type | Description |
|---|---|---|
| zip | string | Filter by zip/postal code. |
| city | string | Filter by city name. |
| page | integer | Page number (0-indexed). |
| limit | integer | Results per page. |
| query | string | Search by keyword. |
| state | string | Filter by state/province abbreviation (e.g. 'TX', 'CA'). |
| category | string | Specialty category slug from list_auctioneer_categories (e.g. 'antiques-and-collectibles', 'real-estate-land'). |
| designation | string | NAA designation slug from list_naa_designations. |
| state_licensed | string | Filter by state licensed in (slug). |
{
"type": "object",
"fields": {
"page": "integer current page number",
"limit": "integer results per page",
"total": "integer total number of matching results",
"members": "array of auctioneer objects with id, name, company, title, email, phone, website, location, social, member_type, profile_url, and slug"
}
}About the auctioneers API
What the API Covers
The API provides structured access to the NAA member directory at auctioneers.org. search_auctioneers returns paginated arrays of auctioneer objects, each containing id, name, company, title, email, phone, website, location, social, member_type, and profile_url. Pagination is zero-indexed via the page parameter, and the response always includes total so you can calculate page counts. You can combine filters — for example, searching for CAI-designated auctioneers in Texas who specialize in real estate.
Specialty and Designation Filters
Two supporting endpoints exist specifically to feed the filter parameters. list_auctioneer_categories returns all specialty slugs (e.g. antiques-and-collectibles, real-estate-land) that are valid values for the category parameter in search_auctioneers. Similarly, list_naa_designations returns all NAA professional designation objects with a name and value field, where value is the slug accepted by the designation filter. Always call these endpoints first to ensure you are passing valid filter slugs.
Individual Profile Data
get_auctioneer_profile takes a slug obtained from search results and returns a richer data set than the search listing: a bio string, a dates object with member_since and original_join_date, a structured details object containing address, phone, email, and website, and a social object with platform-specific URLs for Facebook, Twitter, LinkedIn, and Instagram where available. Fields not populated by the member return null or are omitted from the response.
The auctioneers API is a managed, monitored endpoint for auctioneers.org — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when auctioneers.org changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official auctioneers.org API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build an auctioneer finder tool filtered by state and specialty category for buyers seeking local professionals
- Aggregate NAA member contact data by designation for industry research or trade publication directories
- Verify professional membership status and original join date for due diligence on auction service providers
- Map auctioneer density by ZIP code using location data from search results
- Populate a CRM with structured contact details and social profiles for NAA-credentialed auctioneers
- Monitor new NAA members by comparing member_since dates across periodic queries
- Build a niche directory of estate or real-estate auctioneers using the specialty category filter
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does the National Auction Association offer an official developer API?+
What does `get_auctioneer_profile` return beyond what `search_auctioneers` includes?+
bio string, a dates object with member_since and original_join_date, and a structured details object with full address, phone, email, and website. The social object also appears here with individual platform URLs. Search results include a profile_url and basic contact fields, but bio and membership date data require a separate profile call.How should I use `list_auctioneer_categories` and `list_naa_designations` in practice?+
category and designation filters in search_auctioneers. The category URL field and the designation value field are the filter-ready slugs. Passing an unrecognized slug will likely return zero results rather than an error, so pulling these lists before constructing filter queries is the reliable approach.Does the API return auction listings or upcoming auction events associated with a member?+
Is there a limitation on how granular the location filtering can be?+
search_auctioneers endpoint supports filtering by state, city, and zip individually or in combination, but it does not support radius-based or coordinate-based geo queries. If a member's profile has incomplete location data, they may not surface in city or ZIP filters. The state abbreviation filter (e.g. TX, CA) is the most consistently populated location field.