gigsalad.com APIwww.gigsalad.com ↗
Search GigSalad entertainers by category and location. Get profiles, ratings, pricing, reviews, and booking badges via a structured JSON API.
curl -X GET 'https://api.parse.bot/scraper/cab995ff-bfb4-4fa8-92ba-b99eb4bd617a/search_entertainers?page=1&category=comedian&location=Chicago%2C+IL' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for entertainers by category (DJ, comedian, magician, band, etc.) and location (city, state). Returns a paginated list of entertainers with ratings, pricing, and profile links. Page 1 returns approximately 32 results; each additional page loads more via Livewire pagination.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. Page 1 returns ~32 results, each additional page adds ~16 more via Livewire load-more. |
| category | string | Type of entertainer to search for. Use keywords like 'dj', 'comedian', 'magician', 'band', 'singer', 'dancer', 'clown', 'face painter', etc. Or use slug format like 'Disc-Jockeys-DJs/Event-DJ'. |
| locationrequired | string | Location to search in. Format: 'City, ST' (e.g., 'New York City, NY', 'Chicago, IL', 'Los Angeles, CA'). Must include a US state code or state name. |
{
"type": "object",
"fields": {
"query": "object containing category, parent_category_slug, subcategory_slug, state, city, page",
"entertainers": "array of entertainer objects with name, profile_url, profile_slug, featured, rating, review_count, top_performer, verified_bookings, location, service_type, price_range, review_snippet, image_url",
"total_results": "integer total number of matching entertainers",
"results_returned": "integer number of entertainers returned on this page"
},
"sample": {
"data": {
"query": {
"city": "Los Angeles",
"page": 1,
"state": "CA",
"category": "dj",
"subcategory_slug": "Event-DJ",
"parent_category_slug": "Disc-Jockeys-DJs"
},
"entertainers": [
{
"name": "Dj Rich Intempo",
"rating": 4.96,
"featured": true,
"location": "Los Angeles, CA",
"image_url": "https://www.gigsalad.com/cdn-cgi/image/dpr=2,fit=cover,format=auto,gravity=face,height=540,width=540/s3/d/dj_rich_intempo_beverly_hills/686adcde94459_fullsize",
"price_range": "$300- $4000",
"profile_url": "https://www.gigsalad.com/dj_rich_intempo_los_angeles",
"profile_slug": "dj_rich_intempo_los_angeles",
"review_count": 33,
"service_type": "DJ",
"top_performer": true,
"review_snippet": "Roxanne G. said\"DJ was good, kept up with the different moods and vibes from the guests \"",
"verified_bookings": 87
}
],
"total_results": 299,
"results_returned": 32
},
"status": "success"
}
}About the gigsalad.com API
The GigSalad API exposes 3 endpoints for searching and retrieving entertainer listings from GigSalad.com, covering DJs, comedians, magicians, bands, singers, and dozens of other categories. The search_entertainers endpoint returns up to 32 results per page including name, rating, review count, price range, and badges like top_performer and verified_booking. The get_entertainer_profile endpoint adds full bio text, travel range, and categorization for any individual listing.
Searching Entertainers by Category and Location
The search_entertainers endpoint accepts a required location parameter formatted as 'City, ST' (e.g., 'Chicago, IL') and an optional category string such as 'dj', 'magician', or 'comedian'. Results include an entertainers array where each object carries name, profile_url, profile_slug, rating, review_count, and boolean flags for featured, top_performer, and verified_booking. The total_results field tells you how many matches exist in the location; results_returned reflects the current page count. Page 1 returns approximately 32 results; subsequent pages add roughly 16 more each.
Retrieving Individual Profiles
Pass any profile_slug from a search result to get_entertainer_profile to fetch the full listing. This returns description (the entertainer's bio), price_range, location, categories (an array of specialties), image_url, and the aggregated rating alongside a reviews array with individual author and rating fields. This endpoint is the primary way to compare performers before contacting them.
Discovering Available Categories
The list_categories endpoint takes no inputs and returns a categories array. Each entry includes a parent_category_slug, a keywords list, and a subcategories array — each subcategory having its own slug and keywords. A usage_note field in the response explains exactly how to wire these values into the category parameter of search_entertainers, making it straightforward to enumerate what the directory covers before building a query.
- Build an event-planning tool that queries
search_entertainersby city and category to surface available DJs or bands with ratings and price ranges. - Aggregate
review_countandratingacross multiple locations to identify top-performing entertainers in a region. - Filter search results by
top_performerandverified_bookingbadges to present only credentialed talent to end users. - Use
get_entertainer_profileto pull full bios andprice_rangedata for side-by-side performer comparison pages. - Build a category browser using
list_categoriesto let users drill from parent categories down to subcategory slugs before running a search. - Track entertainer availability across cities by paginating
search_entertainersand recordingtotal_resultsper location. - Populate a venue or event-management platform with GigSalad profile data including
image_urlandcategoriesfor each act.
| 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 GigSalad offer an official developer API?+
What does the `search_entertainers` endpoint return beyond a name and rating?+
entertainers array includes profile_url, profile_slug, review_count, and three boolean badge fields: featured, top_performer, and verified_booking. The total_results and results_returned integers are returned at the top level so you can manage pagination without an extra request.Does pagination load all results at once, or are there limits per page?+
search_entertainers returns approximately 32 results. Each subsequent page adds roughly 16 more. For high-volume searches you will need to increment the page parameter and stop when results_returned is 0 or total_results is exhausted.Does the API return contact details or booking request data for entertainers?+
profile_url, price_range, rating, and description, but direct contact details such as phone numbers or email addresses are not included in any endpoint response. You can fork this API on Parse and revise it to add an endpoint targeting any additional profile fields that become accessible.Can I search by ZIP code or country outside the United States?+
location parameter expects a 'City, ST' format oriented toward US cities and state abbreviations. Non-US locations and ZIP-based searches are not currently supported. You can fork this API on Parse and revise the location-handling logic to add alternative formats if the underlying data supports them.