# RolesAPI, free, POST /v1/roles/batch: Job posting details API

> Fetch up to 500 roles in one request. Batch always runs as an async job.

RolesAPI's Free plan for the job posting details API costs $0.00 per 1,000 jobs. We check each provider's docs for 13 fields. RolesAPI's docs list 7: Description, Location, Remote, Salary, Terms, Company, Posted.
We haven't run RolesAPI through [our job posting details API benchmark](https://datacircle.dev/best-job-posting-details-api.txt) yet.
This plan is free. We rank 372 plans for job posting details APIs by price. Half the plans cost $1.125 or less per 1,000 jobs. [140 job posting details API plans on our price sheet are free.](https://datacircle.dev/best-job-posting-details-api.txt) [Arbetsförmedlingen's free plan](https://datacircle.dev/job-posting-details-apis/arbetsformedlingen/free-open-data-get-ad-id-jobsearch-load-a-job-ad-by-id/llms.txt) scores highest of the free plans in our benchmark, at 92.0 out of 100.
[freehire's $99 monthly plan](https://datacircle.dev/job-posting-details-apis/freehire/99-monthly/llms.txt) is the cheapest paid plan per 1,000 jobs, with no charge per call. You get as many jobs as freehire's rate limit allows. [Zapi's Rp49,000 monthly plan](https://datacircle.dev/job-posting-details-apis/zapi/rp49000-monthly/llms.txt) costs the least for 10,000 jobs a month: about $2.72.
[Jobo's top-up from $5](https://datacircle.dev/job-posting-details-apis/jobo/top-up-from-5/llms.txt) covers any number of jobs, and costs less up front than freehire's $99 monthly plan.
[Arbetsförmedlingen](https://datacircle.dev/job-posting-details-apis/arbetsformedlingen/free-open-data-get-ad-id-jobsearch-load-a-job-ad-by-id/llms.txt), [Nav](https://datacircle.dev/job-posting-details-apis/nav/free-private-token/llms.txt) and [Greenhouse](https://datacircle.dev/job-posting-details-apis/greenhouse/free/llms.txt) are the best job posting details API providers in the Datacircle benchmark.

- This page: https://datacircle.dev/job-posting-details-apis/rolesapi/free-post-v1-roles-batch
- [Job posting details API in 2026: the best of 30+ compared](https://datacircle.dev/best-job-posting-details-api.txt)
- Get it: https://rolesapi.com/pricing/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-posting-details-api-pricing
- Request: `POST https://api.rolesapi.com/v1/roles/batch`
- API key: with the plan, on https://rolesapi.com/pricing/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-posting-details-api-pricing
- Its API docs: https://rolesapi.com/api/roles/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-posting-details-api-pricing#post-v1rolesbatch
- Sold by: RolesAPI (https://rolesapi.com?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-posting-details-api-pricing)
- Checked: 2026-11-12

## In the answer

- Completeness: 54%
- Description: ✓
- Location: ✓
- Remote: ✓
- Salary: ✓
- Terms: ✓
- Company: ✓
- Posted: ✓

## Price

- $ per 1,000 jobs: $0.00
- Per: result
- Billing: free

## Aggregators

- Aggregators: none

## Overage

- Units cap: hard

## Not found

- $ per 1,000 calls that find nothing: $0.00

## In their words

- Their pitch: Fetch up to 500 roles in one request. Batch always runs as an async job.

## Data

- Freshness: live
- History: open only
- Keep data: no API terms
- Use data: no API terms

## Plan

- Pay: $0
- You get: 100 credits
- Enough for: 100 results

## Rate limit

- Per second: 0.33 (20 a minute)
- Batch: 500

## Speed

- Answer: by polling or webhook

## The call

- You send: at least one of job_keys or urls. Optional: country
- Method: POST
- Path: /v1/roles/batch

## About the plan

- Plan: Free
- Who can get it: anyone

## The 17 fields the plan's answer can hold

job key, title, company, company rating, company URL, job location, remote, employment type, base salary, salary currency, salary period, salary source, benefits, description, posted at, job URL, country

## RolesAPI's plans (5)

- [RolesAPI, free, POST /v1/roles/batch](https://datacircle.dev/job-posting-details-apis/rolesapi/free-post-v1-roles-batch/llms.txt): $0.00 per 1,000, 54% complete, live
- [RolesAPI, top-up from $3, Top-up, annual rate, POST /v1/roles/batch](https://datacircle.dev/job-posting-details-apis/rolesapi/top-up-from-3-top-up-annual-rate-post-v1-roles-batch/llms.txt): $3.00 per 1,000, 54% complete, live
- [RolesAPI, top-up from $4, Top-up, monthly rate, POST /v1/roles/batch](https://datacircle.dev/job-posting-details-apis/rolesapi/top-up-from-4-top-up-monthly-rate-post-v1-roles-batch/llms.txt): $4.00 per 1,000, 54% complete, live
- [RolesAPI, $5 monthly, Monthly, POST /v1/roles/batch](https://datacircle.dev/job-posting-details-apis/rolesapi/5-monthly-monthly-post-v1-roles-batch/llms.txt): $5.00 per 1,000, 54% complete, live
- [RolesAPI, $54 yearly, Annual, POST /v1/roles/batch](https://datacircle.dev/job-posting-details-apis/rolesapi/54-yearly-annual-post-v1-roles-batch/llms.txt): $4.50 per 1,000, 54% complete, live

## RolesAPI's calls for this API (3)

- `POST /v1/roles/batch`: [RolesAPI, free, POST /v1/roles/batch](https://datacircle.dev/job-posting-details-apis/rolesapi/free-post-v1-roles-batch/llms.txt)
- `GET /v1/roles/by-url`: [RolesAPI, free, GET /v1/roles/by-url](https://datacircle.dev/job-posting-details-apis/rolesapi/free-get-v1-roles-by-url/llms.txt)
- `GET /v1/roles/{job_key}`: [RolesAPI, free, GET /v1/roles/{job_key}](https://datacircle.dev/job-posting-details-apis/rolesapi/free-get-v1-roles-job-key/llms.txt)

## RolesAPI's APIs (2)

- [RolesAPI Job posting details API pricing, 5 plans, POST /v1/roles/batch](https://datacircle.dev/job-posting-details-apis/rolesapi/free-post-v1-roles-batch/llms.txt)
- [RolesAPI Job postings API pricing, 5 plans, GET /v1/listings](https://datacircle.dev/job-posting-apis/rolesapi/free-get-v1-listings/llms.txt)
- [RolesAPI Job postings API pricing, 5 plans, POST /v1/listings/posted-this-week](https://datacircle.dev/job-posting-apis/rolesapi/free-post-v1-listings-posted-this-week/llms.txt)
- [RolesAPI Job postings API pricing, 5 plans, POST /v1/listings/posted-today](https://datacircle.dev/job-posting-apis/rolesapi/free-post-v1-listings-posted-today/llms.txt)
- [RolesAPI Job postings API pricing, 5 plans, POST /v1/listings/remote](https://datacircle.dev/job-posting-apis/rolesapi/free-post-v1-listings-remote/llms.txt)
- [RolesAPI Job postings API pricing, 5 plans, POST /v1/search/with-details](https://datacircle.dev/job-posting-apis/rolesapi/free-post-v1-search-with-details/llms.txt)
- [RolesAPI Job postings API pricing, 5 plans, POST /v1/search](https://datacircle.dev/job-posting-apis/rolesapi/free-post-v1-search/llms.txt)

## RolesAPI: job posting details API alternatives

[RolesAPI alternatives: other job posting details API providers by price](https://datacircle.dev/rolesapi-alternatives.txt)

We list RolesAPI's cheapest paid plan first. Next we list other providers' plans closest to RolesAPI in price per 1,000 jobs. Each plan in the list gives live data.

- [RolesAPI, top-up from $3, Top-up, annual rate, POST /v1/roles/batch](https://datacircle.dev/job-posting-details-apis/rolesapi/top-up-from-3-top-up-annual-rate-post-v1-roles-batch/llms.txt): $3.00 per 1,000, 54% complete, live
- [OpenWeb Ninja, $25 monthly](https://datacircle.dev/job-posting-details-apis/openweb-ninja/25-monthly/llms.txt): $2.50 per 1,000, 77% complete, live
- [upAPI, $29 monthly](https://datacircle.dev/job-posting-details-apis/upapi/29-monthly/llms.txt): $2.90 per 1,000, 31% complete, live
- [HasData, $59 monthly, Startup, GET /scrape/indeed/job](https://datacircle.dev/job-posting-details-apis/hasdata/59-monthly-startup-get-scrape-indeed-job/llms.txt): $2.95 per 1,000, 15% complete, live
- [Scavio, $948 yearly](https://datacircle.dev/job-posting-details-apis/scavio/948-yearly/llms.txt): $3.16 per 1,000, 77% complete, live

## Sources

From each provider's own pricing page and docs, and from what providers tell us. We read this row from these pages on 2026-11-12.

- https://rolesapi.com/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-posting-details-api-pricing
- https://rolesapi.com/about/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-posting-details-api-pricing
- https://rolesapi.com/api/roles/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-posting-details-api-pricing
- https://rolesapi.com/legal/trademark-and-affiliation/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-posting-details-api-pricing
- https://rolesapi.com/openapi.json?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-posting-details-api-pricing
- https://rolesapi.com/pricing/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-posting-details-api-pricing
- https://rolesapi.com/rate-limits/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-posting-details-api-pricing