AmbitionBox APIambitionbox.com ↗
Retrieve paginated employee reviews from AmbitionBox. Access ratings, pros/cons text, job profiles, locations, and category-level breakdowns per company.
What is the AmbitionBox API?
The AmbitionBox API exposes 1 endpoint — get_reviews — that returns up to 20 employee reviews per page for any company on AmbitionBox, India's leading employer review platform. Each response includes up to 9 fields covering aggregate totals, pagination metadata, and per-review detail such as star ratings, pros/cons text, job profile, location, and category-level rating breakdowns.
curl -X GET 'https://api.parse.bot/scraper/002231a5-6579-4d5d-abbb-06346dc8878c/get_reviews?page=1&company_slug=zepto' \ -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 ambitionbox-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: AmbitionBox SDK — bounded, re-runnable; every call capped."""
from parse_apis.ambitionbox_com_api import AmbitionBox, CompanyNotFound
client = AmbitionBox()
# Iterate recent reviews for a company, capped at 3.
zepto = client.company("zepto")
for review in zepto.list_reviews(limit=3):
print(review.review_title, review.overall_rating, review.job_profile)
# Grab a single review for inspection.
first = zepto.list_reviews(limit=1).first()
if first:
print(first.likes)
print(first.dislikes)
for cat in first.rating_distribution:
print(cat.name, cat.rating)
# Typed error handling for a non-existent company.
try:
gone = client.company("nonexistent-xyz-company-99999")
for r in gone.list_reviews(limit=1):
print(r.review_title)
except CompanyNotFound as e:
print("not found:", e.company_slug)
print("exercised: company.list_reviews")
Retrieve paginated employee reviews for a company on AmbitionBox. Each page returns up to ~20 reviews with ratings, pros/cons text, job profile, location, and category-level rating breakdowns. The first page may include pinned/featured reviews. Results are ordered by recency (newest first).
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-based). |
| company_slugrequired | string | URL slug of the company on AmbitionBox (e.g. 'zepto', 'tata-consultancy-services'). This is the segment before '-reviews' in the AmbitionBox reviews URL. |
{
"type": "object",
"fields": {
"reviews": "Array of review objects with rating, text, and metadata",
"total_pages": "Total number of pages available",
"company_name": "Name of the company",
"current_page": "Current page number",
"total_reviews": "Total number of reviews available"
},
"sample": {
"data": {
"reviews": [
{
"id": 79246132,
"likes": "I loved Zepto, last 2021 on words working under zepto...",
"created": "2026-04-16 10:36:01",
"dislikes": "Need to change some thing ground ops",
"verified": null,
"current_job": null,
"is_featured": true,
"job_profile": "Team Lead",
"work_policy": "WFO",
"job_location": "Hyderabad",
"review_title": "rated by a Team Lead in Hyderabad",
"helpful_count": 1,
"overall_rating": 5,
"employment_type": "permanent",
"work_description": null,
"not_helpful_count": null,
"rating_distribution": [
{
"name": "Salary",
"rating": 4
},
{
"name": "Skill development",
"rating": 5
}
],
"reviewer_experience": null
}
],
"total_pages": 158,
"company_name": "Zepto",
"current_page": 1,
"total_reviews": 3152
},
"status": "success"
}
}About the AmbitionBox API
What the API Returns
The get_reviews endpoint returns structured employee review data for a given company on AmbitionBox. The response contains top-level fields — company_name, total_reviews, total_pages, and current_page — alongside a reviews array where each object carries the review text (pros and cons), the reviewer's job profile, their location, an overall star rating, and granular sub-ratings across categories like work-life balance, salary, management, and culture.
Pagination and Input Parameters
The endpoint accepts two parameters: company_slug (required) and page (optional, 1-based integer). The company_slug maps directly to the URL path segment used on AmbitionBox — for example, zepto for Zepto or tata-consultancy-services for TCS. Use total_pages from the first response to determine how many pages to iterate. Reviews are ordered by recency, with newer reviews appearing first. The first page may also include pinned or featured reviews that appear ahead of the recency-ordered set.
Coverage Notes
AmbitionBox covers primarily Indian companies and Indian-market employers. Review volume varies significantly by company size and prominence — large IT services firms often have tens of thousands of reviews, while smaller companies may have fewer than a hundred. The total_reviews field reflects the count at the time of the request.
The AmbitionBox API is a managed, monitored endpoint for ambitionbox.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ambitionbox.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 ambitionbox.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?+
- Track sentiment trends for a target company by aggregating
ratingand pros/cons text across all pages over time. - Build an employer benchmarking tool comparing category-level rating breakdowns across competing companies.
- Feed employee review data into an HR analytics pipeline using
job_profileandlocationfields to segment feedback. - Monitor new reviews for a specific company by checking
total_reviewsand fetching the first page on a schedule. - Aggregate pros/cons text per
job_profileto surface role-specific workplace sentiment for recruiters. - Compile AmbitionBox review data for due diligence reports on Indian companies before partnerships or acquisitions.
| 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 AmbitionBox have an official developer API?+
What does each review object in the `reviews` array actually contain?+
Does the API cover company-level aggregate ratings, interview reviews, or salary data from AmbitionBox?+
get_reviews, including per-review ratings and pros/cons text. Company-level aggregate scores, interview experiences, and salary submissions are not exposed by this endpoint. You can fork it on Parse and revise to add endpoints covering those data types.Are there any quirks with the first page of results?+
Can I retrieve reviews for any company on AmbitionBox, or only major ones?+
company_slug parameter works for any company that has a profile page on AmbitionBox. However, smaller or lesser-known companies may have very few reviews. total_reviews will reflect the actual count — if it returns zero or a very small number, that company simply has limited review coverage on the platform.