GigSalad APIgigsalad.com ↗
Search GigSalad entertainers by category and location. Get profiles, ratings, pricing, reviews, and booking badges via a structured JSON API.
What is the GigSalad 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.
curl -X GET 'https://api.parse.bot/scraper/cab995ff-bfb4-4fa8-92ba-b99eb4bd617a/search_entertainers?page=1&category=dj&location=Los+Angeles%2C+CA' \ -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 gigsalad-com-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.
from parse_apis.gigsalad_entertainer_search_api import GigSalad, EntertainerSummary, Entertainer, Category
gigsalad = GigSalad()
# List available entertainer categories
for category in gigsalad.categories.list():
print(category.parent_category_slug, [s.slug for s in category.subcategories])
# Search for DJs in Los Angeles
for summary in gigsalad.entertainersummaries.search(location="Los Angeles, CA", category="dj"):
print(summary.name, summary.rating, summary.review_count, summary.price_range)
# Get full profile details for the first result
profile = summary.details()
print(profile.name, profile.description, profile.location, profile.top_performer)
break
Search for entertainers by category and location. 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. Use keywords like 'dj', 'comedian', 'magician', 'band' for the category, or slug format like 'Disc-Jockeys-DJs/Event-DJ'.
| 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 summary 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": "Parallel Attractions",
"rating": 5,
"featured": true,
"location": "Los Angeles, CA",
"price_range": "$300 - $5000",
"profile_url": "https://www.gigsalad.com/parallel_attractions_los_angeles",
"profile_slug": "parallel_attractions_los_angeles",
"review_count": 18,
"service_type": "DJ",
"top_performer": true,
"review_snippet": "Artur G. said We hired the second time and are happy with the music and service.",
"verified_bookings": 38
}
],
"total_results": 299,
"results_returned": 32
},
"status": "success"
}
}About the GigSalad API
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.
The GigSalad API is a managed, monitored endpoint for gigsalad.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when gigsalad.com 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 gigsalad.com 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 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 | 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 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.