auctioneers.org APIauctioneers.org ↗
Search and retrieve professional auctioneer profiles from the National Auction Association directory. Filter by location, specialty, and NAA designation.
curl -X GET 'https://api.parse.bot/scraper/9907bc4c-92fb-4f0f-b852-de27eef0b10e/search_auctioneers?page=0&limit=3&query=antiques&state=TX' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for auctioneers in the NAA directory with optional filters for location, specialty category, and designation. Returns paginated results.
| 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 (e.g. 'cai', 'bas', 'aare'). |
| 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"
},
"sample": {
"data": {
"page": 0,
"limit": 3,
"total": 141,
"members": [
{
"id": 3824795,
"name": "John Doe",
"slug": "kate-phillips",
"email": "[email protected]",
"phone": "+1 (555) 012-3456",
"title": "",
"social": {
"twitter": null,
"facebook": "https://facebook.com/kpauctiongroup",
"linkedin": null,
"instagram": "Auctionkate"
},
"company": "KP Auction Group",
"website": "https://kpauctiongroup.com/",
"location": {
"zip": "62704",
"city": "Springfield",
"state": "IL",
"address": "123 Main St",
"country": "United States"
},
"member_type": "Regular Member",
"profile_url": "https://www.auctioneers.org/find-an-auctioneer/kate-phillips"
}
]
},
"status": "success"
}
}About the auctioneers.org API
This API exposes 4 endpoints for querying the National Auction Association (NAA) member directory, returning contact details, bios, specialty categories, and professional designations for licensed auctioneers across the US and Canada. The search_auctioneers endpoint supports filtering by state, zip code, city, keyword, specialty category, and NAA designation, with paginated results including name, company, email, phone, website, and social profile links per member.
Search and Filter NAA Members
The search_auctioneers endpoint accepts up to eight optional parameters — zip, city, state, query, category, designation, page, and limit — and returns a paginated list of matching auctioneer objects. Each result includes id, name, company, title, email, phone, website, location, social, member_type, and profile_url. Pagination is 0-indexed via the page parameter. To identify which category or designation slug values are valid inputs, call list_auctioneer_categories and list_naa_designations first.
Category and Designation Reference Endpoints
list_auctioneer_categories returns an array of specialty categories — such as antiques-and-collectibles or real-estate-land — each with a Name (display label) and URL (the slug to pass as category in search). list_naa_designations returns NAA credentials like CAI, BAS, and AARE with a name and value field, where value is the slug for the designation filter. These two reference endpoints take no inputs and should be used to populate filter UI or validate query parameters before searching.
Individual Auctioneer Profiles
get_auctioneer_profile accepts a slug from search results and returns the full profile: bio text, name, title, company, details (address, phone, email, website), social (Facebook, Twitter, LinkedIn, Instagram URLs where available), dates (member_since and original_join_date), and profile_url. This endpoint is useful when you need contact information and background detail beyond what the search listing provides.
- Build a geographic auctioneer finder using the
stateandzipfilters insearch_auctioneers - Generate a curated list of estate or real-estate auctioneers by passing the appropriate
categoryslug - Filter for credentialed members only by supplying a
designationvalue such ascaiorbas - Populate a CRM or lead list with auctioneer email, phone, and website fields from search results
- Display detailed auctioneer bios and membership tenure using
get_auctioneer_profiledates and bio fields - Build a specialty directory filtered by auction category using slugs from
list_auctioneer_categories - Cross-reference NAA designation holders across states for compliance or partnership research
| 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 | 250 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 that `search_auctioneers` does not?+
get_auctioneer_profile adds a bio narrative, a dates object with member_since and original_join_date, and a structured details block with address, phone, email, and website. Search results include the same contact fields at a summary level but omit biography text and join-date history.How do I know which values are valid for the `category` and `designation` filters?+
list_auctioneer_categories to get current category slugs (e.g. antiques-and-collectibles) and list_naa_designations to get valid designation slugs (e.g. cai, bas, aare). Pass the URL field value as category and the value field as designation in search_auctioneers.Does the API return auction listings or upcoming auction events?+
Is there a limit to how many results `search_auctioneers` can return at once?+
page and limit parameters. The total field in the response indicates the full result count for a given query, allowing you to iterate through pages. Very broad searches with no filters may return large total counts, so using limit to control page size is recommended.