# RolesAPI

> REST API for Indeed job-postings data. One Bearer-authenticated REST call returns a normalized JSON role object: title, company, location, salary, description, and benefits. Search live postings by keyword and location across 60+ country editions, enrich results in batches of up to 500 roles, and receive completion events via signed webhooks.

## Auth
- Header: `Authorization: Bearer rk_...`
- Signup: https://rolesapi.com/signup (100 free credits, no card)

## Pricing
- Free: 100 credits one-time
- Monthly: $5/mo, 1,000 credits, top-ups $4/1k
- Annual: $54/yr, 12,000 credits, top-ups $3/1k

## Integration
- MCP server: https://api.rolesapi.com/mcp (OAuth + bearer)
- OpenAPI 3.1: https://rolesapi.com/openapi.json
- Agent skills: https://rolesapi.com/.well-known/agent-skills/index.json

## Docs
- /quickstart
- /authentication
- /errors
- /rate-limits
- /pagination
- /output-formats
- /field-projection
- /async-jobs
- /webhooks-guide
- /ai-agents

## API reference
- /api/roles
- /api/search
- /api/listings
- /api/jobs
- /api/webhooks
- /api/account

## Guides
- /guides/ways-to-get-indeed-job-data
- /legal/trademark-and-affiliation