Bandana Jobs API
Live, read-only access to Bandana's public job-search data. Search results include compact source role/company/location context by default, optional full posting objects, company summaries, identifier-bearing company matches, and typed-place lookup. Bandana's field names and values are preserved. Location typing follows the structured Google Places dependency used by Bandana's search UI; each typed result also exposes Bandana's source-derived map bounds and zoom for a valid jobs search. Company pages expose Bandana's take/skip pagination and postingCount; Bandana supplies no stable cursor/snapshot, so adjacent live pages may overlap and callers must deduplicate UUIDs. The jobs search documents Bandana's global, map, remote, and sponsored-count semantics so agents can interpret large totals and unstable sponsored slots correctly.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.
Then ask your agent to use the Bandana Jobs API for your task.
Call it over HTTP
Get an API keySign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/badb8020-d0b3-47f4-904f-31d8bd54f72e/v1/jobs' \
--header "Authorization: Bearer $AGENT_DATA_API_KEY"Endpoints
Inputs and response fields for every endpoint in this API.
GETJobs/v1/jobs
Runs Bandana's public map search. Map bounds define the search area and filter arrays use Bandana's request field names and values. By default each result contains the existing summary fields plus role.name and role.jobType, company.uuid/company.name/company.logo/company.industry, and the source location object; large role.description, company.photoSet, company.generalPhotoSet, and other full-object fields are omitted. Set includeFullObjects=true when the full source role, company, and location objects are needed; the posting and company endpoints also provide full detail. Pagination is page-number based. totalCounts.global is Bandana's global matching count. totalCounts.withinView is not a strict count of jobs physically inside the rectangle: it includes remote jobs that are outside the map area. totalCounts.remoteWithinView is the remote portion of that reported withinView count; for example, the same observed 86,329 remote jobs were included in both a small Austin view and a continental-US view, so an agent must not describe withinView as the number of jobs in a small map square. Search results can include sponsored placements. Identify them with sponsored=true or isSponsoredSlot=true. Sponsored slots may change order or membership between identical calls, repeat across pages, and can be located outside the requested bounds; exclude any result with either flag when you need map-local, duplicate-free results. Non-sponsored paging has no universal duplicate-free guarantee: an earlier unfiltered Miami observation had 93 unique non-sponsored jobs across pages 1-5, while the current live run had 92 rows and 91 unique; the current Starbucks-filtered run had 91 rows and 91 unique before page 5 became empty. Page-1 ordering can also vary because sponsored slots are selected dynamically. Clients should always deduplicate by UUID and exclude sponsored rows when they need a stable map-local list. The companies filter accepts either a company name (for example Starbucks) or a raw company UUID (for example 1d71d0ac-42d5-4a1b-94d6-52964fb136fd) from company-suggestions matches[].action.companyUuid; UUIDs are resolved through Bandana's live company summary to the canonical name because Bandana's search procedure matches the name. Do not pass the namespaced matches[].uuid.
Input
northOptionalQuery · number, default: 25.9617Northern map latitude bound.
Example: 25.9617
southOptionalQuery · number, default: 25.5617Southern map latitude bound.
Example: 25.5617
eastOptionalQuery · number, default: -79.9918Eastern map longitude bound.
Example: -79.9918
westOptionalQuery · number, default: -80.3918Western map longitude bound.
Example: -80.3918
zoomOptionalQuery · integer, default: 9Bandana map zoom value.
Example: 9
pageOptionalQuery · integer, min: 1, default: 11-based result page.
Example: 1
keywordOptionalQuery · string | nullOptional Bandana search keyword.
Example: nurse
benefitsOptionalQuery · array | nullBandana benefits values.
Example: healthInsur
industriesOptionalQuery · array | nullBandana industry values.
Example: Healthcare & Mental Health
jobTypeOptionalQuery · array | nullBandana job-type values.
Example: Full-time
workplaceTypeLabelsOptionalQuery · array | nullBandana workplace labels.
Example: Remote
payUnitOptionalQuery · array | nullBandana pay-unit values.
Example: Hourly
recencyWindowOptionalQuery · string, default: AnytimeBandana recency-window value.
Example: Anytime
sortByOptionalQuery · string, default: relevanceBandana sort value.
Example: relevance
transitLinesOptionalQuery · array | nullBandana transit-line values.
Example: MTA
experienceLevelsOptionalQuery · array | nullBandana experience values.
Example: Entry-Level
educationLevelsOptionalQuery · array | nullBandana education values.
Example: Associate's Degree
companiesOptionalQuery · array | nullOptional company filter. Accepts either a Bandana company name (for example Starbucks, matching matches[].action.canonicalName) or a raw company UUID (for example 1d71d0ac-42d5-4a1b-94d6-52964fb136fd, from matches[].action.companyUuid). UUIDs are resolved live to the source canonical name; do not pass the namespaced matches[].uuid.
Example: Starbucks
jobSourcesOptionalQuery · array | nullBandana job-source identifiers.
Example: source-uuid
minPayOptionalQuery · number | nullOptional source minimum pay filter.
Example: 20
maxPayOptionalQuery · number | nullOptional source maximum pay filter.
Example: 100
payFieldOptionalQuery · string | nullBandana pay field selector.
Example: hour
curatedListOptionalQuery · string | nullBandana curated-list identifier.
Example: popular-list
onlyJobsWithPayOptionalQuery · boolean | nullWhether Bandana should require pay.
Example: true
includeFullObjectsOptionalQuery · boolean, default: falseInclude the full source role, company, and location objects instead of the compact scan fields returned by default.
Example: false
Response
jobsobject[]jobs[].role?objectjobs[].role.name?string | nulljobs[].role.jobType?string | nulljobs[].role.minExpYears?unknown | nulljobs[].uuidstringjobs[].score?number | nulljobs[].coords?object | nulljobs[].isPaid?boolean | nulljobs[].company?objectjobs[].company.logo?string | nulljobs[].company.name?string | nulljobs[].company.uuid?string | nulljobs[].company.industry?objectjobs[].company.industry.name?string | nulljobs[].payUnit?string | nulljobs[].placeId?string | nulljobs[].location?objectjobs[].location.lat?number | nulljobs[].location.city?string | nulljobs[].location.long?number | nulljobs[].location.uuid?string | nulljobs[].location.state?string | nulljobs[].location.street?string | nulljobs[].location.country?string | nulljobs[].location.placeId?string | nulljobs[].location.zipcode?string | nulljobs[].location.featured?boolean | nulljobs[].location.neighborhood?string | nulljobs[].featureId?string | nulljobs[].sponsored?boolean | nulljobs[].eventStart?unknown | nulljobs[].companyLogo?string | nulljobs[].payQuantity?unknown | nulljobs[].weeklyHours?unknown | nulljobs[].placeJobCount?unknown | nulljobs[].workplaceType?string | nulljobs[].isSponsoredSlot?boolean | nullpageintegertotalCounts?object | object | nullsponsoredStrategy?string | nullFields marked ? are optional.
GETFilter options/v1/filter-options
Returns current enum values derived from Bandana's structured search validation responses.
Input
No input parameters.
Response
filtersobjectappMethod?string | nullcalendarEvent?unknown | nullatsJobMetadata?unknown | nullFields marked ? are optional.
GETCompany suggestions/v1/company-suggestions
Returns Bandana's company-name suggestions. The legacy suggestions name list is preserved. When Bandana supplies identifiers, matches contains the source typeahead records; pass matches[].action.companyUuid (the raw UUID) unchanged to companies-by-company-uuid and to the jobs companies filter. Do not pass the namespaced matches[].uuid. If the current source response contains names only, matches is empty rather than inventing identifiers.
Input
queryRequiredQuery · stringCompany name search text.
Example: Intuit
Response
matches?object[]matches[].kind?string | nullmatches[].name?string | nullmatches[].uuid?string | nullmatches[].label?string | nullmatches[].action?object | nullmatches[].companyUuid?string | nullsuggestionsstring[]Fields marked ? are optional.
GETJobs by posting uuid/v1/jobs/{posting_uuid}
Returns the structured Bandana postings.details record for a posting UUID. A search UUID is passed unchanged. If Bandana returns a not-found, expired, or removed posting error, this route returns a clear non-retryable 404 instead of a service 500.
Input
posting_uuidRequiredPath · stringBandana posting UUID.
Example: 05681906-5cae-4456-b1d0-f7b484ef7077
Response
role?objectrole.name?string | nullrole.jobType?string | nullrole.description?string | nullrole.minExpYears?unknown | nulluuidstringremote?boolean | nullxmlJob?objectxmlJob.uuid?string | nullxmlJob.jobId?string | nullxmlJob.expiringSoon?boolean | nullappLink?string | nullcompany?objectcompany.logo?string | nullcompany.name?string | nullcompany.uuid?string | nullcompany.website?string | nullcompany.industry?objectcompany.industry.name?string | nullcompany.photoSet?unknown | nullcompany.cardPhoto?string | nullcompany.atsCompany?object[]company.atsCompany[].ats?string | nullcompany.atsCompany[].uuid?string | nullcompany.atsCompany[].companyUuid?string | nullcompany.atsCompany[].isIntegrated?boolean | nullcompany.atsCompany[].atsIdentifier?string | nullcompany.atsCompany[].trackingToken?string | nullcompany.description?string | nullcompany.postingCount?integer | nullcompany.primaryPhoto?string | nullcompany.locationCount?integer | nullcompany.generalPhotoSet?unknown | nullexpired?boolean | nullpayUnit?string | nullappEmail?string | nullbenefits?objectbenefits.pto?boolean | nullbenefits.uuid?string | nullbenefits.r401k?boolean | nullbenefits.r403b?boolean | nullbenefits.ptoDesc?string | nullbenefits.website?string | nullbenefits.commuter?boolean | nullbenefits.r401kDesc?string | nullbenefits.storeDisc?boolean | nullbenefits.dentalDesc?string | nullbenefits.diningDisc?boolean | nullbenefits.healthDesc?string | nullbenefits.minPtoDays?unknown | nullbenefits.dentalInsur?boolean | nullbenefits.description?string | nullbenefits.healthInsur?boolean | nullbenefits.visionInsur?boolean | nullbenjiBox?unknown | nulllocation?objectlocation.lat?number | nulllocation.city?string | nulllocation.long?number | nulllocation.uuid?string | nulllocation.state?string | nulllocation.street?string | nulllocation.borough?string | nulllocation.country?string | nulllocation.placeId?string | nulllocation.zipcode?string | nulllocation.featured?boolean | nulllocation.neighborhood?string | nulllocation.transitLines?unknown[]training?boolean | nulljobSource?objectjobSource.name?string | nulljobSource.uuid?string | nullsponsored?boolean | nulldirectApply?boolean | nullpayQuantity?unknown | nulltipQuantity?unknown | nullweeklyHours?unknown | nullcuratedEvent?unknown[]curatedLists?unknown[]primaryPhoto?string | nullemailTemplate?string | nullshowFastApply?boolean | nullsummarization?string | nullworkplaceType?string | nulleducationLevel?string | nullexpirationDate?unknown | nullmaxPayQuantity?unknown | nullurgentlyHiring?boolean | nullexperienceLevel?string | nullsubjectTemplate?string | nullcommissionQuantity?unknown | nullrequiresDateOfBirth?boolean | nulllastUpdatedAtExternal?string | nullFields marked ? are optional.
GETLocation suggestions/v1/location-suggestions
Returns Bandana's live location lookup results. Omit query to preserve the existing guided suggestions; pass a place name or ZIP to ask the structured Google Places source used by Bandana's search UI for matching places. Results are not all cities: Bandana can return different place types such as a city, road segment, neighborhood, or postal code. Use each result's types array to choose the intended kind (for example, prefer a locality/city result for a city-wide search and a postal_code result for a ZIP-code search; do not treat a road or neighborhood result as a whole-city boundary). Each typed result includes the provider identifier, raw prediction/details objects, coordinates, raw provider viewport, and Bandana's source-derived bandanaBounds (north, south, east, west, zoom); pass bandanaBounds to jobs. The provider may return no matches or a typed upstream error for a query.
Input
queryOptionalQuery · string | nullOptional free-text place or ZIP query accepted by Bandana's location lookup.
Example: Austin, TX
Response
locationsobject[]locations[].lat?number | nulllocations[].long?number | nulllocations[].name?string | nulllocations[].terms?unknown[]locations[].types?string[]locations[].source?string | nulllocations[].geometry?object | nulllocations[].location?string | nulllocations[].place_id?string | nulllocations[].description?string | nulllocations[].bandanaBounds?objectlocations[].bandanaBounds.eastnumberlocations[].bandanaBounds.westnumberlocations[].bandanaBounds.zoomintegerlocations[].bandanaBounds.northnumberlocations[].bandanaBounds.southnumberlocations[].formatted_address?string | nulllocations[].structured_formatting?object | nullFields marked ? are optional.
GETCompanies by company uuid/v1/companies/{company_uuid}
Returns Bandana's structured company summary and one page of the source list of currently open posting UUIDs. The default page=1 preserves the existing first openJobs page. Bandana pages this source list with 30 records using take/skip; request page=2, page=3, and so on to traverse the reported postings. Pages can repeat posting UUIDs and may not reach every posting: in one live Starbucks traversal, five pages returned 150 rows but only 122 unique UUIDs, and Bandana supplies no stable cursor/snapshot. Callers must deduplicate UUIDs and must not treat page count as exhaustive coverage. company.postingCount is Bandana's reported company open-posting count (14,071 for the observed Starbucks summary), not the number of unique UUIDs returned by a finite traversal and not the jobs-search count. A jobs search filtered with companies=Starbucks reported global=12,950 in the same observation; that count is a search-result population subject to the search filters and is not interchangeable with postingCount. For a company's jobs in an area, prefer the jobs endpoint with the companies filter and bounds covering the area of interest; in the current live Starbucks observation, pages 1-4 returned 91 non-sponsored rows with 91 unique UUIDs and page 5 was empty. This is an observation, not a source guarantee: sponsored placements remain unstable and all clients should exclude them using sponsored/isSponsoredSlot and deduplicate by UUID.
Input
company_uuidRequiredPath · stringBandana company UUID.
Example: ca9dcc27-71cf-44e9-948a-9667c5e4dfaf
pageOptionalQuery · integer, min: 1, default: 11-based page of 30 open posting UUIDs, mapped to Bandana's take/skip pagination.
Example: 1
Response
companyobjectcompany.logo?string | nullcompany.name?string | nullcompany.uuid?string | nullcompany.website?string | nullcompany.industry?objectcompany.industry.name?string | nullcompany.photoSet?unknown | nullcompany.cardPhoto?string | nullcompany.atsCompany?object[]company.atsCompany[].ats?string | nullcompany.atsCompany[].uuid?string | nullcompany.atsCompany[].companyUuid?string | nullcompany.atsCompany[].isIntegrated?boolean | nullcompany.atsCompany[].atsIdentifier?string | nullcompany.atsCompany[].trackingToken?string | nullcompany.description?string | nullcompany.postingCount?integer | nullcompany.primaryPhoto?string | nullcompany.locationCount?integer | nullcompany.generalPhotoSet?unknown | nullopenJobsobject[]openJobs[].uuidstringFields marked ? are optional.
Don’t see the endpoint you need?
Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.
An account is required to submit an extension. Prepare your request, then sign in to build.