JC Concursos APIjcconcursos.com.br ↗
Access Brazilian public exam listings, news articles, and job postings from jcconcursos.com.br. Filter by state, status, and more across 10 endpoints.
What is the JC Concursos API?
The JC Concursos API exposes 10 endpoints covering Brazilian public exam (concurso) listings, news articles, and private-sector job postings from jcconcursos.com.br. Use get_open_concursos to retrieve currently open exams with vacancy counts, salary ceilings, and institution names, or get_concurso_detail to pull full exam metadata including agenda dates, education level requirements, and registration fees — all filterable by Brazilian state abbreviation.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/71f8d245-4018-4455-a6db-1a8ade89fded/get_latest_news_headlines' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace jcconcursos-com-br-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: JC Concursos SDK — browse concursos, news, and jobs."""
from parse_apis.jc_concursos_api import JCConcursos, State, NotFoundError
client = JCConcursos()
# List open concursos in São Paulo, capped to 5 items
for exam in client.concursosummaries.list_by_state(state=State.SP, limit=5):
print(exam.name, exam.status, exam.vacancies)
# Drill into one concurso's full details
item = client.concursosummaries.list_open(limit=1).first()
if item:
detail = item.details()
print(detail.name, detail.institution, detail.salary_range)
for agenda_item in detail.agenda:
print(agenda_item.event, agenda_item.date)
# Browse latest headlines
for headline in client.headlines.list(limit=5):
print(headline.title, headline.url)
# Get full article content by slug
try:
article = client.articles.get(slug="concurso-inss-presidente-confirma-negociacoes-para-aprovacao-de-10-mil-vagas-142988")
print(article.headline, article.subtitle)
except NotFoundError as exc:
print(f"Article not found: {exc}")
# Search for concursos
result = client.searchresults.search(query="policia")
print(result.message, result.search_url)
# Browse job listings
for job in client.jobs.list(limit=3):
print(job.name, job.institution, job.vacancies)
print("exercised: concursosummaries.list_by_state / list_open / details / headlines.list / articles.get / searchresults.search / jobs.list")
Extract news article headlines and links from the homepage. Returns up to 20 headlines with their titles and URLs. Useful for monitoring newly published concurso news without loading full articles.
No input parameters required.
{
"type": "object",
"fields": {
"headlines": "array of headline objects with title and url"
},
"sample": {
"data": {
"headlines": [
{
"url": "https://jcconcursos.com.br/noticia/concursos/concurso-fundacao-florestal-sp-edital-143206",
"title": "Fundação Florestal de SP publica edital para 68 vagas"
}
]
},
"status": "success"
}
}About the JC Concursos API
Concurso Listings and Status Filters
Four endpoints cover different exam lifecycle stages: get_open_concursos returns active exams with vacancies, max_salary, status, and a linked news_url; get_predicted_concursos covers future exams not yet officially opened; get_ongoing_concursos surfaces exams currently in examination phases such as proofs or result publication; and get_open_concursos_by_state requires a state parameter (e.g. 'sp', 'rj', 'mg') and additionally returns aggregate stats like previsto, autorizados, abertos, and em andamento counts for that state. All listing endpoints support page for pagination.
Concurso Detail and News Content
get_concurso_detail takes a slug (available from any listing's slug field) and returns structured fields: agenda as an array of event/date pairs, salary_range, education_level, positions, vacancies, states, and institution. For editorial context, get_news_article retrieves the full body content, headline, and subtitle of a news article by slug. get_news_listing returns paginated article metadata including author, published_at, summary, and thumbnail URL.
Jobs and Search
get_empregos_listing surfaces private-sector job and internship postings with vacancies, institution, and associated news links — distinct from concurso listings. get_latest_news_headlines returns up to 20 headline/URL pairs from the homepage, useful for monitoring fresh coverage. The search_concursos endpoint accepts a query string and returns a constructed search_url rather than parsed results, since the source relies on Google Custom Search; the response includes a message field explaining this behavior.
The JC Concursos API is a managed, monitored endpoint for jcconcursos.com.br — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when jcconcursos.com.br changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official jcconcursos.com.br API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Aggregate open Brazilian public exam listings filtered by state to build a regional concurso tracker.
- Monitor salary ceilings and vacancy counts across federal and state institutions using
max_salaryandvacanciesfields. - Display upcoming exam agendas in a calendar app by pulling
agendaevent/date arrays fromget_concurso_detail. - Surface the latest concurso news with author attribution and publish dates via
get_news_listing. - Track state-level exam pipeline health using aggregate stats (
previsto,autorizados,abertos) fromget_open_concursos_by_state. - Build a private-sector job board alongside concurso listings by combining
get_empregos_listingwith public exam endpoints. - Power a news digest by fetching full article body text through
get_news_articleusing slugs from headline results.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does jcconcursos.com.br offer an official developer API?+
What does `get_concurso_detail` return beyond what listing endpoints provide?+
get_concurso_detail returns fields not present in listing results: a structured agenda array of exam events and their dates, salary_range (as a range rather than just a ceiling), education_level, specific positions offered, and the states field indicating where vacancies exist. It requires a slug value taken from any listing endpoint response.Does `search_concursos` return parsed search results?+
search_concursos returns a constructed search_url string and an explanatory message rather than extracted result objects. The API currently covers direct listing and detail endpoints for structured data. You can fork it on Parse and revise to add a results-parsing endpoint if your use case requires extracted search output.Can I filter news articles or job listings by state or category?+
get_news_listing and get_empregos_listing support only page pagination; neither accepts a state or category filter. The concurso listing endpoints (get_open_concursos, get_ongoing_concursos, get_predicted_concursos) do accept a state parameter. You can fork the API on Parse and revise it to add filtered news or jobs endpoints.Are registration fee amounts available through the API?+
get_concurso_detail endpoint description lists registration fee as returned data, though it surfaces as part of the detail payload rather than a dedicated numeric field. Listing endpoints such as get_open_concursos do not include fee data — only get_concurso_detail (called with a specific slug) exposes it.