BookingAgentInfo APIbookingagentinfo.com ↗
Access celebrity profiles, endorsement deals, social media follower counts, representative contacts, and brand data from bookingagentinfo.com via 7 endpoints.
What is the BookingAgentInfo API?
The BookingAgentInfo API exposes 7 endpoints covering celebrity profiles, endorsement deals, social media insights, representatives, and brands indexed on bookingagentinfo.com. Use search_celebrities to find talent by keyword with pagination support, get_celebrity_endorsements to pull brand deal history including category and deal type, and get_celebrity_social_insights to retrieve platform-level follower counts and social handles — all returning structured JSON.
curl -X GET 'https://api.parse.bot/scraper/c5196d3c-5e32-4ecb-91c4-198507e33df3/search_celebrities?page=1&limit=5&query=taylor' \ -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 bookingagentinfo-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.
"""Walkthrough: BookingAgentInfo SDK — search celebrities, browse directory, drill into endorsements and social insights."""
from parse_apis.Booking_Agent_Info_API import BookingAgentInfo, Letter, CelebrityNotFound
client = BookingAgentInfo()
# Search celebrities by keyword, capped at 5 results
for celeb in client.celebrities.search(query="taylor", limit=5):
print(celeb.name, celeb.slug, celeb.category)
# Browse the directory by letter using the Letter enum
for celeb in client.celebrities.browse_by_letter(letter=Letter.S, limit=3):
print(celeb.name, celeb.permalink)
# Drill into a celebrity's endorsements via constructible sub-resource
taylor = client.celebrity(slug="taylor-swift")
endorsement_info = taylor.endorsements.get()
print(endorsement_info.total_endorsements, endorsement_info.summary)
for deal in endorsement_info.endorsements[:3]:
print(deal.brand, deal.category, deal.date)
# Get social insights for the same celebrity
insights = taylor.social_insights.get()
print(insights.slug, insights.metrics)
# Search representatives with typed-error handling
try:
for rep in client.representatives.search(query="agent", limit=3):
print(rep.name, rep.slug, rep.category)
except CelebrityNotFound as exc:
print(f"not found: {exc.slug}")
# Search brands
for brand in client.brands.search(query="nike", limit=5):
print(brand.name, brand.slug, brand.permalink)
print("exercised: celebrities.search / browse_by_letter / endorsements.get / social_insights.get / representatives.search / brands.search")
Full-text search over the celebrity database via the Typesense index. Returns paginated results with name, slug, categories, nicknames, image, permalink, and bio preview. Use query='*' to browse all celebrities.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| limit | integer | Number of results per page. |
| query | string | Search keyword. Use * for all celebrities. |
{
"type": "object",
"fields": {
"page": "integer current page number",
"items": "array of celebrity objects with name, slug, category, nicknames, image, permalink, bio_preview",
"total": "integer total number of matching celebrities",
"total_pages": "integer total number of pages"
},
"sample": {
"data": {
"page": 1,
"items": [
{
"name": "Taylor Selfridge",
"slug": "taylor-selfridge",
"image": "",
"category": [
"Film and TV",
"TV Personality"
],
"nicknames": [],
"permalink": "https://bookingagentinfo.com/celebrity/taylor-selfridge/",
"bio_preview": ""
}
],
"total": 313,
"total_pages": 63
},
"status": "success"
}
}About the BookingAgentInfo API
Celebrity Search and Directory
The search_celebrities endpoint accepts a query string (use * to list all) and returns paginated results with each celebrity's name, slug, category, nicknames, bio_preview, and permalink. The browse_celebrity_directory endpoint offers an alternative entry point filtered by the first letter of the celebrity's name — including # for number-prefixed names — with the same paginated shape. Both endpoints produce slugs that serve as the required input for the detail endpoints.
Endorsements and Brand Deals
get_celebrity_endorsements takes a celebrity slug and returns an array of endorsement objects, each with brand, brand_url, category, date, and type. The response also includes an AI-generated summary field that describes all deals on record and a total_endorsements integer indicating full deal count. Note that the endpoint surfaces up to 3 individual endorsement records in the endorsements array; the summary covers the broader set.
Social Insights and Representatives
get_celebrity_social_insights returns a metrics object with platforms (follower counts keyed by platform name) and social_accounts (an array of handle/platform pairs). An optional engagement field may appear depending on data availability. To find the agents, managers, or publicists associated with a celebrity or agency, use search_representatives, which queries the representative index by keyword and returns name, slug, category, and permalink per result.
Brands and Industry News
search_brands queries the brand index — brands that appear in celebrity endorsement deals — returning name, slug, image, and permalink per result. get_industry_news_feed requires no inputs and returns a news array of current deals and industry updates pulled from the site's dashboard feed.
The BookingAgentInfo API is a managed, monitored endpoint for bookingagentinfo.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when bookingagentinfo.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 bookingagentinfo.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?+
- Look up which brands a specific celebrity has endorsed, filtered by category and deal date, using
get_celebrity_endorsements. - Build a talent discovery tool that autocompletes celebrity names and slugs via
search_celebritieswith keyword queries. - Aggregate follower counts across platforms for a roster of talent using
get_celebrity_social_insights. - Find agents or managers associated with a name by querying
search_representativesand following permalink references. - Identify which celebrities endorse a given brand by cross-referencing
search_brandsresults with endorsement detail lookups. - Monitor the entertainment industry news feed via
get_industry_news_feedto track new deal announcements. - Paginate through the full celebrity roster alphabetically using
browse_celebrity_directorywith letter filters for data ingestion.
| 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 bookingagentinfo.com offer an official developer API?+
How many endorsement records does `get_celebrity_endorsements` return, and what fields are included?+
endorsements array, each with brand, brand_url, category, date, and type fields. A total_endorsements integer reflects the full count on record, and a summary string provides an AI-generated overview of all deals regardless of the array limit.Does the API return direct contact details such as phone numbers or email addresses for celebrities or their representatives?+
search_representatives, along with celebrity profile data. Direct contact details such as phone numbers or email addresses are not included in the current response schema. You can fork this API on Parse and revise it to add an endpoint that retrieves deeper representative contact fields if that data becomes accessible.Does `get_celebrity_social_insights` include engagement rate or post-level data?+
platforms object and an array of social handles via social_accounts. An optional engagement field may appear in the metrics object but is not guaranteed. Per-post metrics or historical follower trend data are not part of the current response. You can fork this API on Parse and revise it to add post-level or historical social data if a suitable endpoint is identified.Can I retrieve all celebrities in a given category (e.g., musicians, athletes) directly?+
search_celebrities endpoint returns a category field per result, but there is no dedicated category-filter parameter — filtering by category currently requires querying by keyword or browsing by letter and inspecting the category field in results. You can fork this API on Parse and revise it to add a category-filter parameter to the search endpoint.