In this example, we’ll demonstrate how to use our Job Board API to extract job details from a job search platform.

Requirements

  • MrScraper console account.
  • MrScraper API token that you can get by following the steps here.

Job Board Example

Follow the steps below to use our Job Board API:

  1. Use the request body below:
curl --location 'https://app.mrscraper.com/api/job-board-scrape' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer API_TOKEN' \
--data '{
    "urls": [
        "<job_board_platform_url>"
    ],
    "min": 100,
    "max": 200,
    "timeout": 180,
    "schema": {
        "type": "array",
        "description": "List of jobs",
        "items": {
            "type": "object",
            "description": "job information",
            "properties": {
                "job_title": {
                    "type": "string",
                    "description": "job name"
                },
                "job_url": {
                    "type": "string",
                    "description": "job valid url"
                },
                "job_location": {
                    "type": "string",
                    "description": "location for the job"
                },
                "job_salary": {
                    "type": "string",
                    "description": "salary"
                },
                "job_type": {
                    "type": "string",
                    "description": "job type"
                },
                "job_currency": {
                    "type": "string",
                    "description": "the currency of the salary"
                }
            },
            "required": [
                "job_title",
                "job_url",
                "job_location",
                "job_salary",
                "job_type",
                "job_currency"
            ]
        },
        "required": [
            "jobs"
        ]
    }
}'
  1. Replace Authorization with your API token.
  2. The above request body will return a JSON response based on the schema.
To use this endpoint for your use case, please refer to this section.

Use Cases

You can use our job board API to scrape a job data from the following job search platform:

In this example, we’ll retrieve job data from Indeed, returning results based on the defined schema.

Follow the steps below to use our Job Board API:

  1. Use the request body below:
curl --location 'https://app.mrscraper.com/api/job-board-scrape' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer API_TOKEN' \
--data '{
    "urls": [
        "https://www.indeed.com/jobs?q=USA&from=mobRdr&utm_source=%2Fm%2F&utm_medium=redir&utm_campaign=dt&vjk=9eb40bc48ab72d86"
    ],
    "min": 100,
    "max": 200,
    "timeout": 180,
    "schema": {
        "type": "array",
        "description": "List of jobs",
        "items": {
            "type": "object",
            "description": "job information",
            "properties": {
                "job_title": {
                    "type": "string",
                    "description": "job name"
                },
                "job_url": {
                    "type": "string",
                    "description": "job valid url"
                },
                "job_location": {
                    "type": "string",
                    "description": "location for the job"
                },
                "job_salary": {
                    "type": "number",
                    "description": "salary"
                },
                "job_type": {
                    "type": "string",
                    "description": "job type"
                },
                "job_currency": {
                    "type": "string",
                    "description": "the currency of the salary"
                }
            },
            "required": [
                "job_title",
                "job_url",
                "job_location",
                "job_salary",
                "job_type",
                "job_currency"
            ]
        },
        "required": [
            "jobs"
        ]
    }
}'
  1. Replace Authorization with your API token.
  2. The above request body will return the following JSON response:
{
    "result": [
        {
            "job_title": "Veterinarian",
            "job_url": "https://www.indeed.com/pagead/clk?mo=r&ad=-6NYlbfkN0C8RG5OWeBEaBuhruGitfqnFK-3RuxCKlhDTDMn81bJ9Hf8MqhvEsnmM0GmB9jbxyL5iWAkkX5660eFOJl0_ZTH_MoRzoTP8FjGDIcVyaG0v7z-tgnWmBlHGuNhOLHR1QQ9JVd-SamEb46AA9dX8CsatS1qJKSKt2YuGdPtx7nnHwEKZlI0ERq6s5JpcfTkAzWLgMd3arfIXaI3zVFmNATKxOYFhB9lnjqz4U7751uVdrW-ea0P1ZJDY8wXy6JnLqupxO8AFwexC8Qa-lhOngm0iLs4a0ZWvL80m1XbaRpfUS09KZOGoXX06W2EexsN7DPWwV8CrsV7H5GGzVHdypwgDygxw-fWLIsOhSeRpxkfVE0-0jTYZ2jBXGW4AvMAzMM6PF8AN-QaPr_B9XqhcLs-pkKI8Rl8QiDzaUgPJ4gJd0S8v8LyyvGkWqA4GYTzNgfuZ2iJeXdrJ2vjQHJTmSte7aWWcaXaTRp2MBRy_gHDNllW37A753dxMLBT596WYhtJ9huqeLSTQJ8Mc9ZY7rTqTkxyPNas0nyGjJDbNPjyhiac24F-K4DlFaw4wixMWjUHncDZhJ3Zgjv-hAVxpSer7AaQQZ1kbZICe5ZqVGtPMmlci6b3UrFoP4oRHth-jrSTX-8kh2HqxN8vfhoUFDba&xkcb=SoCr6_M37bWPgUXzRB0KbzkdCdPP&camk=H-lBaXMUocLCanXDNQG3_w==&p=0&fvj=1&vjs=3",
            "job_location": "Westfield, NJ",
            "job_salary": 199000,
            "job_type": "Full-time",
            "job_currency": "USD"
        },
        {
            "job_title": "Brooklyn Bubble Tea: Shift Lead / Full Time (#N4)",
            "job_url": "https://www.indeed.com/rc/clk?jk=6e8cd57a6a47eaa1&bb=wyvVdOtBLbYJXIGqV_AG28QueOH_qDAvdpPkhoYL5RjOF6smQYcC4xQ7mptm79JXUVMXuQd2XqkxlR7gMIVhCjYhV42fjTiVQCEqe8PXJfBs2F60wHJBaWWjZUpl0F6i&xkcb=SoAC67M37bWPgUXzRB0EbzkdCdPP&fccid=e996533275df72c8&cmp=TGS-Holding&ti=Shift+Leader&vjs=3",
            "job_location": "Brooklyn, NY",
            "job_salary": 50000,
            "job_type": "Full-time",
            "job_currency": "USD"
        }
    ],
    "tokenUsage": 8,
    "totalDone": 1
}