API Reference
Use Crawlora's Goldin API endpoints to extract supported public Goldin data as structured JSON. This documentation covers 5 active endpoints including List Goldin's full auction history, List Goldin's search filter enums, Get one Goldin lot's full public detail, Search Goldin's lot auction inventory, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as slug, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/goldin/search?auction_type=Auction&keyword=coffee&sort=Featured&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/goldin/auctionsapiKey2 credits/requestGoldin's complete auction event history, back to 2012 -- title, type, status, start/end window, and buyer's premium for every auction Goldin has run. Pass an auction's own id as auction_id to goldin-search to browse its lots.
Required params: None
/goldin/categoriesapiKey1 credit/requestGoldin's full filter-enum surface for goldin-search, scoped to one lot pool -- category, sub_category, certification, item_type, and the live auction list (each with its own id, name, and current lot count), plus the sort enum valid for that pool. category/sub_category/certification/item_type are read live from Goldin's own current inventory, not a fixed taxonomy, so results can shift over time. The Auction pool (default) and the Fixed Price "Private Sales" marketplace are disjoint item pools with different certification/item_type values and different sort enums -- pass the same auction_type here and to goldin-search.
Required params: None
/goldin/listingapiKey2 credits/requestOne lot's full public detail: title, description, current bid/starting price, auction window and status, grading info, images, and prev/next lot pointers within the same auction. slug is the meta_slug from a goldin-search result (or the trailing path segment of the lot's own goldin.co/item/{slug} page URL).
Required params: slug:query
/goldin/searchapiKey2 credits/requestBrowse or search Goldin's current lot inventory by free-text keyword, category, sub_category, certification, item_type, and auction_id, in a caller-selected sort order. Every filter is optional and combines with AND semantics. All enum values come from goldin-categories -- pass the matching auction_type to both. The Auction pool (default) and the Fixed Price "Private Sales" marketplace are disjoint item pools with different certification/item_type values and different sort enums.
Required params: None
/goldin/suggestapiKey1 credit/requestGoldin's own search-suggestions/autocomplete for a partial keyword, matching the site's own search box typeahead. keyword is optional -- when omitted, returns Goldin's current trending/popular searches instead of an error.
Required params: None
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| List Goldin's full auction history | /goldin/auctions | GET | 2 credits/request | None | View docs | Try endpoint |
| List Goldin's search filter enums | /goldin/categories | GET | 1 credit/request | None | View docs | Try endpoint |
| Get one Goldin lot's full public detail | /goldin/listing | GET | 2 credits/request | slug:query | View docs | Try endpoint |
| Search Goldin's lot auction inventory | /goldin/search | GET | 2 credits/request | None | View docs | Try endpoint |
| Get Goldin's search suggestions for a keyword | /goldin/suggest | GET | 1 credit/request | None | View docs | Try endpoint |