Skip to content
Scrappa Get API key
ZipRecruiter API 1 credit/request

ZipRecruiter Company Profile API Documentation

GET https://scrappa.co/api/ziprecruiter/company

ZipRecruiter Company Profile returns the public company profile: headquarters, size, industries, founded year, website, social links and similar companies. It adds the Breakroom rating from 0 to 10 with the number of answers, the category score, highlights and findings (for example paid breaks or sick pay), the public reviews and the first page of open jobs with the total. Send the company slug from the search endpoint exactly as it is. Slugs can hold letters, digits and . _ - , & ' ( ) +. Employers with open jobs but no Breakroom page return their jobs with an empty profile and rating: null. A slug that matches no employer returns not found and is not charged. Company profiles cover US-hosted employers. Employers that list jobs only in Canada may return not found, and search results for Canada carry no company slug. The currency of each job comes from the job location. Open jobs are capped at the first 20 and open_jobs_total holds the full count.

A company without a page returns 404 (not charged). A request costs 1 credit. A failed request is not charged.

ZipRecruiter Company Profile API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/ziprecruiter/company
Auth header
x-api-key
Cost
1 credit/request
company = example
Response preview
200 OK
{
    "data": {
        "name": "One Medical",
        "slug": "One-Medical",
        "rating": {
            "score": 8.21,
            "category": "healthcare provider",
            "findings": [
                {
                    "id": "paid_breaks",
                    "title": "Do workers at One Medical get paid breaks?",
                    "detail": "48% of people say they don\u2019t get paid breaks.",
                    "summary": "Sometimes. Only some people get paid breaks.",
                    "response_count": 23
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

company string Required

Company slug exactly as a US search result returns it, for example One-Medical or Baylor-Scott-&-White-Health. Letters, digits and . _ - , & ' ( ) + are allowed.

Example value example

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "data": {
        "name": "One Medical",
        "slug": "One-Medical",
        "rating": {
            "score": 8.21,
            "category": "healthcare provider",
            "findings": [
                {
                    "id": "paid_breaks",
                    "title": "Do workers at One Medical get paid breaks?",
                    "detail": "48% of people say they don\u2019t get paid breaks.",
                    "summary": "Sometimes. Only some people get paid breaks.",
                    "response_count": 23
                },
                {
                    "id": "sick_pay",
                    "title": "Does One Medical pay people when they\u2019re sick?",
                    "detail": "67% of people say they would get paid if they were sick but scheduled to work.",
                    "summary": "Yes. Most people get paid when they\u2019re sick.",
                    "response_count": 24
                }
            ],
            "scale_max": 10,
            "highlights": [
                {
                    "id": "people_enjoy_their_job",
                    "label": "People enjoy working here"
                },
                {
                    "id": "well_rated_employer",
                    "label": "Good employer"
                },
                {
                    "id": "recommended_by_parents",
                    "label": "Recommended by parents"
                },
                {
                    "id": "managers_treat_people_with_respect",
                    "label": "Respectful managers"
                },
                {
                    "id": "people_get_proper_training",
                    "label": "Good training"
                },
                {
                    "id": "proper_breaks",
                    "label": "Uninterrupted breaks"
                }
            ],
            "category_score": 6.88,
            "response_count": 25
        },
        "profile": {
            "name": "One Medical",
            "size": "1001 - 5000 Employees",
            "about": null,
            "social": {
                "twitter": "https://www.twitter.com/onemedical",
                "facebook": "https://www.facebook.com/onemedical"
            },
            "website": "onemedical.com",
            "logo_url": "https://www.ziprecruiter.com/svc/fotomat/public-nosensitive-ziprecruiter-logos/company/a0e2553b.png",
            "industries": [
                "Health Care and Social Assistance"
            ],
            "founded_year": "2007",
            "headquarters": "San Francisco, CA, US",
            "similar_companies": [
                {
                    "name": "Hinge Health",
                    "headquarters": "San Francisco, CA"
                },
                {
                    "name": "Omada Health",
                    "headquarters": "San Francisco, CA"
                }
            ]
        },
        "reviews": [
            {
                "best": "Flexible hours",
                "worst": "Long shifts",
                "rating": 4,
                "jobTitle": "Nurse"
            }
        ],
        "website": "https://www.onemedical.com/",
        "open_jobs": [
            {
                "id": "cGUyIRrMOnh8SEnsRU4LIg",
                "pay": {
                    "max": 19.25,
                    "min": 15.75,
                    "text": "$15.75 - $19.25/hr",
                    "currency": "USD",
                    "interval": "hour",
                    "max_annual": 38500,
                    "min_annual": 31500,
                    "is_estimated": true
                },
                "url": "https://www.ziprecruiter.com/c/One-Medical/Job/Medical-Receptionist-Phlebotomist/-in-Miami,FL?jid=ef7774e8327ac8dd",
                "title": "Medical Receptionist/Phlebotomist",
                "is_new": true,
                "job_id": "ef7774e8327ac8dd",
                "company": {
                    "url": "https://www.ziprecruiter.com/co/One-Medical/Jobs",
                    "name": "One Medical",
                    "slug": "One-Medical",
                    "logo_url": "https://www.ziprecruiter.com/svc/fotomat/public-nosensitive-ziprecruiter-logos/company/a0e2553b.png"
                },
                "benefits": [
                    "Medical",
                    "Dental",
                    "Vision",
                    "Life",
                    "Retirement",
                    "PTO"
                ],
                "location": {
                    "city": "Miami",
                    "state": "Florida",
                    "county": "Miami-Dade",
                    "country": "United States",
                    "display": "Miami, FL",
                    "state_code": "FL",
                    "postal_code": null,
                    "country_code": "US"
                },
                "apply_url": null,
                "posted_at": "2026-10-30T22:26:39Z",
                "highlights": [
                    {
                        "id": "people_enjoy_their_job",
                        "label": "People enjoy working here"
                    },
                    {
                        "id": "well_rated_employer",
                        "label": "Good employer"
                    },
                    {
                        "id": "recommended_by_parents",
                        "label": "Recommended by parents"
                    },
                    {
                        "id": "managers_treat_people_with_respect",
                        "label": "Respectful managers"
                    },
                    {
                        "id": "people_get_proper_training",
                        "label": "Good training"
                    },
                    {
                        "id": "proper_breaks",
                        "label": "Uninterrupted breaks"
                    }
                ],
                "description": "About Us <b>One Medical</b> is a primary care solution challenging the industry status quo by making quality care more affordable, accessible and enjoyable. But...",
                "posted_label": "yesterday",
                "location_types": [],
                "description_html": null,
                "employment_types": [
                    "Full-time"
                ],
                "description_is_full": false
            }
        ],
        "description": "One Medical is a healthcare network operated by Amazon.",
        "open_jobs_total": 61
    },
    "meta": {
        "billable": true,
        "endpoint_family": "company"
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

404

Not Found

ZipRecruiter has no page for this company. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": false,
        "endpoint_family": "company"
    },
    "error": {
        "code": "NOT_FOUND",
        "message": "The requested job, salary page or company was not found. It may have expired."
    },
    "success": false
}
422

Invalid Request

A parameter is missing or has the wrong format. This response is not billable.

{
    "errors": {
        "company": [
            "The company field is required."
        ]
    },
    "message": "The request validation failed"
}
503

Upstream Unavailable

ZipRecruiter could not be reached, or the page did not match the request. This response is not billable and is retryable.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "company"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "ZipRecruiter could not be reached. Please retry shortly."
    },
    "success": false
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.