# RolesAPI, free, GET /v1/roles/{job_key}: Job posting details API

> Fetch a full role by its 16-character Indeed job key.

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-get-v1-roles-job-key
- [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: `GET https://api.rolesapi.com/v1/roles/{job_key}`
- 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#get-v1rolesjob_key
- 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: call
- 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 a full role by its 16-character Indeed job key.

## 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 calls

## Rate limit

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

## Speed

- Answer: in the call

## The call

- You send: job_key. Optional: country, fields
- Method: GET
- Path: /v1/roles/{job_key}

## 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, GET /v1/roles/{job_key}](https://datacircle.dev/job-posting-details-apis/rolesapi/free-get-v1-roles-job-key/llms.txt): $0.00 per 1,000, 54% complete, live
- [RolesAPI, top-up from $3, Top-up, annual rate, GET /v1/roles/{job_key}](https://datacircle.dev/job-posting-details-apis/rolesapi/top-up-from-3-top-up-annual-rate-get-v1-roles-job-key/llms.txt): $3.00 per 1,000, 54% complete, live
- [RolesAPI, top-up from $4, Top-up, monthly rate, GET /v1/roles/{job_key}](https://datacircle.dev/job-posting-details-apis/rolesapi/top-up-from-4-top-up-monthly-rate-get-v1-roles-job-key/llms.txt): $4.00 per 1,000, 54% complete, live
- [RolesAPI, $5 monthly, Monthly, GET /v1/roles/{job_key}](https://datacircle.dev/job-posting-details-apis/rolesapi/5-monthly-monthly-get-v1-roles-job-key/llms.txt): $5.00 per 1,000, 54% complete, live
- [RolesAPI, $54 yearly, Annual, GET /v1/roles/{job_key}](https://datacircle.dev/job-posting-details-apis/rolesapi/54-yearly-annual-get-v1-roles-job-key/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, GET /v1/roles/{job_key}](https://datacircle.dev/job-posting-details-apis/rolesapi/free-get-v1-roles-job-key/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, GET /v1/roles/{job_key}](https://datacircle.dev/job-posting-details-apis/rolesapi/top-up-from-3-top-up-annual-rate-get-v1-roles-job-key/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