# RolesAPI, free, POST /v1/search/with-details: Job postings API

> Search, then enrich every result with the full role object in one async job.

RolesAPI's Free plan for the job postings API costs $0.00 per 1,000 jobs. We check each provider's docs for 13 fields. RolesAPI's docs list 7 of the 13. 4 are in the plan's price: Location, Remote, Company, Posted. 3 cost extra: Description, Salary, Terms.
We haven't run RolesAPI through [our job postings API benchmark](https://datacircle.dev/best-job-postings-api.txt) yet.
This plan is free. We rank 490 plans for job postings APIs by price. Half the plans cost $0.398 or less per 1,000 jobs. [240 job postings API plans on our price sheet are free.](https://datacircle.dev/best-job-postings-api.txt) [JobsByLevel's free plan](https://datacircle.dev/job-posting-apis/jobsbylevel/free/llms.txt) scores highest of the free plans in our benchmark, at 90.7 out of 100.
[JobDataAPI's $345 monthly plan](https://datacircle.dev/job-posting-apis/jobdataapi/345-monthly/llms.txt) is the cheapest paid plan per 1,000 jobs, with no charge per call. You get as many jobs as JobDataAPI's rate limit allows. [ScrapeUnblocker's pay-as-you-go plan](https://datacircle.dev/job-posting-apis/scrapeunblocker/pay-as-you-go-pay-as-you-go-post-jobs-naukri/llms.txt) costs the least for 10,000 jobs a month: about $0.01.
[Vibeworker's $19 monthly plan](https://datacircle.dev/job-posting-apis/vibeworker/19-monthly/llms.txt) covers any number of jobs, and costs less up front than JobDataAPI's $345 monthly plan.
[JobsByLevel](https://datacircle.dev/job-posting-apis/jobsbylevel/free/llms.txt), [freehire](https://datacircle.dev/job-posting-apis/freehire/29-monthly-api-get-jobs-search/llms.txt) and [OfferMagnet](https://datacircle.dev/job-posting-apis/offermagnet/free/llms.txt) are the best job postings API providers in the Datacircle benchmark.

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

## In the answer

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

## Price

- $ per 1,000 jobs: $0.00
- Per: page, size not stated
- Billing: free

## Aggregators

- Aggregators: none

## Charges

- Extra fields: company rating, company URL, employment type, base salary, salary currency, salary period, salary source, benefits, description: +$0.00
- Also pays for: from the same budget: Fetch a role by Indeed URL · Fetch a role by job key · Fetch the company sub-resource for a role · Fetch the salary sub-resource for a role · Fetch the description sub-resource for a role · Fetch the benefits sub-resource for a role · Enrich up to 500 roles asynchronously · Search live postings · List postings by keyword and location · List postings from the last 24 hours · List postings from the last 7 days · List remote postings

## Overage

- Units cap: hard

## Not found

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

## In their words

- Their pitch: Search, then enrich every result with the full role object in one 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 pages

## Rate limit

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

## Speed

- Answer: by polling or webhook

## The call

- You send: keyword, location. Optional: country, sort, max_pages
- Method: POST
- Path: /v1/search/with-details

## About the plan

- Plan: Free
- Who can get it: anyone

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

job key, title, company, job location, remote, posted at, job URL, country

## RolesAPI's plans (5)

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

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

- `GET /v1/listings`: [RolesAPI, free, GET /v1/listings](https://datacircle.dev/job-posting-apis/rolesapi/free-get-v1-listings/llms.txt)
- `POST /v1/listings/posted-this-week`: [RolesAPI, free, POST /v1/listings/posted-this-week](https://datacircle.dev/job-posting-apis/rolesapi/free-post-v1-listings-posted-this-week/llms.txt)
- `POST /v1/listings/posted-today`: [RolesAPI, free, POST /v1/listings/posted-today](https://datacircle.dev/job-posting-apis/rolesapi/free-post-v1-listings-posted-today/llms.txt)
- `POST /v1/listings/remote`: [RolesAPI, free, POST /v1/listings/remote](https://datacircle.dev/job-posting-apis/rolesapi/free-post-v1-listings-remote/llms.txt)
- `POST /v1/search/with-details`: [RolesAPI, free, POST /v1/search/with-details](https://datacircle.dev/job-posting-apis/rolesapi/free-post-v1-search-with-details/llms.txt)
- `POST /v1/search`: [RolesAPI, free, POST /v1/search](https://datacircle.dev/job-posting-apis/rolesapi/free-post-v1-search/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 posting details API pricing, 5 plans, GET /v1/roles/by-url](https://datacircle.dev/job-posting-details-apis/rolesapi/free-get-v1-roles-by-url/llms.txt)
- [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, POST /v1/search/with-details](https://datacircle.dev/job-posting-apis/rolesapi/free-post-v1-search-with-details/llms.txt)

## RolesAPI: job postings API alternatives

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

We list other providers' plans closest to this plan in price per 1,000 jobs. Each plan in the list gives live data.

- [AnywhereRoles, free](https://datacircle.dev/job-posting-apis/anywhereroles/free/llms.txt): $0.00 per 1,000, 46% complete, live
- [ReefAPI, free, POST /indeed/v1/jobs/search](https://datacircle.dev/job-posting-apis/reefapi/free-free-post-indeed-v1-jobs-search/llms.txt): $0.00 per 1,000, 62% complete, live
- [ScrapeUnblocker, free, POST /jobs/glassdoor](https://datacircle.dev/job-posting-apis/scrapeunblocker/free-free-post-jobs-glassdoor/llms.txt): $0.00 per 1,000, 62% complete, live
- [RankFabrik, free, Trial, GET /balayer](https://datacircle.dev/job-posting-apis/rankfabrik/free-trial-get-balayer/llms.txt): $0.00 per 1,000, 38% 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-postings-api-pricing
- https://rolesapi.com/about/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-postings-api-pricing
- https://rolesapi.com/api/search/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-postings-api-pricing
- https://rolesapi.com/legal/trademark-and-affiliation/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-postings-api-pricing
- https://rolesapi.com/openapi.json?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-postings-api-pricing
- https://rolesapi.com/pricing/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-postings-api-pricing
- https://rolesapi.com/rate-limits/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-postings-api-pricing