Vodafone APIjobs.vodafone.com ↗
Access Vodafone job listings, similar roles, and skill insights via 4 endpoints. Filter by keyword, location, and sort order. Powered by the Eightfold platform.
What is the Vodafone API?
The Vodafone Jobs API exposes 4 endpoints for querying active Vodafone career listings sourced from jobs.vodafone.com, which runs on the Eightfold platform. Use search_jobs to run full-text searches across open positions with filters for keyword, location, and sort order, returning fields like department, workLocationOption, postedTs, and a direct positionUrl. Two additional endpoints surface similar roles and skill-relevance insights for any position ID.
curl -X GET 'https://api.parse.bot/scraper/f6305d3a-9a8c-48b7-aeac-e7a81293e2b2/search_jobs?query=engineer&start=0&sort_by=timestamp&location=London%2C+United+Kingdom' \ -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 jobs-vodafone-com-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.
from parse_apis.vodafone_jobs_api import VodafoneJobs, Position, JobInsight, Sort
client = VodafoneJobs()
# Search for engineering positions sorted by relevance
for position in client.positions.search(query="engineer", sort_by=Sort.RELEVANCE):
print(position.name, position.location, position.department, position.work_location_option)
# Get skill insights for this position
insight = position.insights.get()
print(insight.skills, insight.titles)
# Find similar positions
for similar in position.similar():
print(similar.name, similar.location, similar.posted_ts)
break
# Count total positions matching a keyword
total = client.positions.count(query="data", location="London, United Kingdom")
print(total)
Full-text search across all Vodafone job openings. Matches query against job titles and descriptions, filterable by location. Returns 10 positions per page; paginate via the start offset (multiples of 10). Each position includes department, work-location option (hybrid/onsite/remote), posting timestamp, and a URL path for the full listing.
| Param | Type | Description |
|---|---|---|
| query | string | Keyword to search for in job titles and descriptions. |
| start | integer | Pagination offset in multiples of 10 (0, 10, 20, ...). |
| sort_by | string | Sort order for results. |
| location | string | Location filter (city, country, etc.). Example: 'London, United Kingdom'. |
{
"type": "object",
"fields": {
"count": "integer total number of matching positions",
"positions": "array of Position objects with id, name, location, department, displayJobId, postedTs, workLocationOption, positionUrl"
},
"sample": {
"data": {
"count": 376,
"positions": [
{
"id": 563018696872286,
"name": "ServiceNow Developer",
"isHot": 0,
"stars": 0,
"atsJobId": "283704",
"location": "Bucuresti, Romania",
"postedTs": 1781125200,
"locations": [
"Bucuresti, Romania"
],
"solrScore": null,
"creationTs": 1779470823,
"department": "Software Development #2",
"positionUrl": "/careers/job/563018696872286",
"displayJobId": "283704",
"workLocationOption": "hybrid",
"locationFlexibility": null,
"standardizedLocations": [
"Bucharest, Bucharest, RO"
]
}
]
},
"status": "success"
}
}About the Vodafone API
Search and Filter Job Listings
The search_jobs endpoint accepts optional query, location, sort_by, and start parameters, returning up to 10 positions per page. The start parameter takes multiples of 10 for pagination (0, 10, 20, …). Each position object includes id, name, location, department, displayJobId, postedTs, workLocationOption (hybrid, onsite, or remote), and a positionUrl for the full listing. The count field in the response tells you the total number of matches, allowing you to calculate how many pages exist.
Lightweight Count Queries
get_total_job_count accepts the same query and location filters as search_jobs but returns only a single total_count integer. This is useful when you need a current headcount of open roles — for example, tracking how many positions Vodafone is hiring for in a given city — without retrieving full position records.
Similar Positions and Job Insights
get_similar_positions takes a numeric job_id (from search_jobs results) and returns up to 10 related positions ranked by the Eightfold matching engine, using the same Position object shape. get_job_insights returns three dictionaries for a given job: skills maps skill names to integer relevance scores, titles maps comparable job titles to frequency counts, and experience_years maps experience-year brackets to counts. Together these give a market-context view of what a role actually demands relative to similar positions.
The Vodafone API is a managed, monitored endpoint for jobs.vodafone.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when jobs.vodafone.com 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 jobs.vodafone.com 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?+
- Track the total number of open Vodafone roles in a target country using get_total_job_count with a location filter
- Build a job alert tool that polls search_jobs by keyword and surfaces newly posted positions via the postedTs field
- Identify whether a role is remote, hybrid, or onsite by reading the workLocationOption field from search_jobs results
- Discover adjacent opportunities by passing a position's id to get_similar_positions and listing related roles
- Analyze which skills Vodafone values most for a given role using the skill-to-relevance-score mapping in get_job_insights
- Map career pathways by comparing comparable titles and their frequency counts from the titles dict in get_job_insights
- Aggregate department-level hiring volume by grouping search_jobs results by the department field across paginated responses
| 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.