Catalog / Bandana Jobs

Bandana Jobs API

bandana.com

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.

  • Business
  • jobs
  • employment
  • job-search
6 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In 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 key

Sign 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.

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.

Optional parameters 25

Northern map latitude bound.

Southern map latitude bound.

Eastern map longitude bound.

Western map longitude bound.

Bandana map zoom value.

1-based result page.

Optional Bandana search keyword.

Bandana benefits values.

Bandana industry values.

Bandana job-type values.

Bandana workplace labels.

Bandana pay-unit values.

Bandana recency-window value.

Bandana sort value.

Bandana transit-line values.

Bandana experience values.

Bandana education values.

Optional 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.

Bandana job-source identifiers.

Optional source minimum pay filter.

Optional source maximum pay filter.

Bandana pay field selector.

Bandana curated-list identifier.

Whether Bandana should require pay.

Include the full source role, company, and location objects instead of the compact scan fields returned by default.

View call pricing
cURL · Jobs
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.9617

Northern map latitude bound.

Example: 25.9617

southOptionalQuery · number, default: 25.5617

Southern map latitude bound.

Example: 25.5617

eastOptionalQuery · number, default: -79.9918

Eastern map longitude bound.

Example: -79.9918

westOptionalQuery · number, default: -80.3918

Western map longitude bound.

Example: -80.3918

zoomOptionalQuery · integer, default: 9

Bandana map zoom value.

Example: 9

pageOptionalQuery · integer, min: 1, default: 1

1-based result page.

Example: 1

keywordOptionalQuery · string | null

Optional Bandana search keyword.

Example: nurse

benefitsOptionalQuery · array | null

Bandana benefits values.

Example: healthInsur

industriesOptionalQuery · array | null

Bandana industry values.

Example: Healthcare & Mental Health

jobTypeOptionalQuery · array | null

Bandana job-type values.

Example: Full-time

workplaceTypeLabelsOptionalQuery · array | null

Bandana workplace labels.

Example: Remote

payUnitOptionalQuery · array | null

Bandana pay-unit values.

Example: Hourly

recencyWindowOptionalQuery · string, default: Anytime

Bandana recency-window value.

Example: Anytime

sortByOptionalQuery · string, default: relevance

Bandana sort value.

Example: relevance

transitLinesOptionalQuery · array | null

Bandana transit-line values.

Example: MTA

experienceLevelsOptionalQuery · array | null

Bandana experience values.

Example: Entry-Level

educationLevelsOptionalQuery · array | null

Bandana education values.

Example: Associate's Degree

companiesOptionalQuery · array | null

Optional 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 | null

Bandana job-source identifiers.

Example: source-uuid

minPayOptionalQuery · number | null

Optional source minimum pay filter.

Example: 20

maxPayOptionalQuery · number | null

Optional source maximum pay filter.

Example: 100

payFieldOptionalQuery · string | null

Bandana pay field selector.

Example: hour

curatedListOptionalQuery · string | null

Bandana curated-list identifier.

Example: popular-list

onlyJobsWithPayOptionalQuery · boolean | null

Whether Bandana should require pay.

Example: true

includeFullObjectsOptionalQuery · boolean, default: false

Include the full source role, company, and location objects instead of the compact scan fields returned by default.

Example: false

Response

jobsobject[]
jobs[].role?object
jobs[].role.name?string | null
jobs[].role.jobType?string | null
jobs[].role.minExpYears?unknown | null
jobs[].uuidstring
jobs[].score?number | null
jobs[].coords?object | null
jobs[].isPaid?boolean | null
jobs[].company?object
jobs[].company.logo?string | null
jobs[].company.name?string | null
jobs[].company.uuid?string | null
jobs[].company.industry?object
jobs[].company.industry.name?string | null
jobs[].payUnit?string | null
jobs[].placeId?string | null
jobs[].location?object
jobs[].location.lat?number | null
jobs[].location.city?string | null
jobs[].location.long?number | null
jobs[].location.uuid?string | null
jobs[].location.state?string | null
jobs[].location.street?string | null
jobs[].location.country?string | null
jobs[].location.placeId?string | null
jobs[].location.zipcode?string | null
jobs[].location.featured?boolean | null
jobs[].location.neighborhood?string | null
jobs[].featureId?string | null
jobs[].sponsored?boolean | null
jobs[].eventStart?unknown | null
jobs[].companyLogo?string | null
jobs[].payQuantity?unknown | null
jobs[].weeklyHours?unknown | null
jobs[].placeJobCount?unknown | null
jobs[].workplaceType?string | null
jobs[].isSponsoredSlot?boolean | null
pageinteger
totalCounts?object | object | null
sponsoredStrategy?string | null

Fields 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

filtersobject
appMethod?string | null
calendarEvent?unknown | null
atsJobMetadata?unknown | null

Fields 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 · string

Company name search text.

Example: Intuit

Response

matches?object[]
matches[].kind?string | null
matches[].name?string | null
matches[].uuid?string | null
matches[].label?string | null
matches[].action?object | null
matches[].companyUuid?string | null
suggestionsstring[]

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 · string

Bandana posting UUID.

Example: 05681906-5cae-4456-b1d0-f7b484ef7077

Response

role?object
role.name?string | null
role.jobType?string | null
role.description?string | null
role.minExpYears?unknown | null
uuidstring
remote?boolean | null
xmlJob?object
xmlJob.uuid?string | null
xmlJob.jobId?string | null
xmlJob.expiringSoon?boolean | null
appLink?string | null
company?object
company.logo?string | null
company.name?string | null
company.uuid?string | null
company.website?string | null
company.industry?object
company.industry.name?string | null
company.photoSet?unknown | null
company.cardPhoto?string | null
company.atsCompany?object[]
company.atsCompany[].ats?string | null
company.atsCompany[].uuid?string | null
company.atsCompany[].companyUuid?string | null
company.atsCompany[].isIntegrated?boolean | null
company.atsCompany[].atsIdentifier?string | null
company.atsCompany[].trackingToken?string | null
company.description?string | null
company.postingCount?integer | null
company.primaryPhoto?string | null
company.locationCount?integer | null
company.generalPhotoSet?unknown | null
expired?boolean | null
payUnit?string | null
appEmail?string | null
benefits?object
benefits.pto?boolean | null
benefits.uuid?string | null
benefits.r401k?boolean | null
benefits.r403b?boolean | null
benefits.ptoDesc?string | null
benefits.website?string | null
benefits.commuter?boolean | null
benefits.r401kDesc?string | null
benefits.storeDisc?boolean | null
benefits.dentalDesc?string | null
benefits.diningDisc?boolean | null
benefits.healthDesc?string | null
benefits.minPtoDays?unknown | null
benefits.dentalInsur?boolean | null
benefits.description?string | null
benefits.healthInsur?boolean | null
benefits.visionInsur?boolean | null
benjiBox?unknown | null
location?object
location.lat?number | null
location.city?string | null
location.long?number | null
location.uuid?string | null
location.state?string | null
location.street?string | null
location.borough?string | null
location.country?string | null
location.placeId?string | null
location.zipcode?string | null
location.featured?boolean | null
location.neighborhood?string | null
location.transitLines?unknown[]
training?boolean | null
jobSource?object
jobSource.name?string | null
jobSource.uuid?string | null
sponsored?boolean | null
directApply?boolean | null
payQuantity?unknown | null
tipQuantity?unknown | null
weeklyHours?unknown | null
curatedEvent?unknown[]
curatedLists?unknown[]
primaryPhoto?string | null
emailTemplate?string | null
showFastApply?boolean | null
summarization?string | null
workplaceType?string | null
educationLevel?string | null
expirationDate?unknown | null
maxPayQuantity?unknown | null
urgentlyHiring?boolean | null
experienceLevel?string | null
subjectTemplate?string | null
commissionQuantity?unknown | null
requiresDateOfBirth?boolean | null
lastUpdatedAtExternal?string | null

Fields 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 | null

Optional free-text place or ZIP query accepted by Bandana's location lookup.

Example: Austin, TX

Response

locationsobject[]
locations[].lat?number | null
locations[].long?number | null
locations[].name?string | null
locations[].terms?unknown[]
locations[].types?string[]
locations[].source?string | null
locations[].geometry?object | null
locations[].location?string | null
locations[].place_id?string | null
locations[].description?string | null
locations[].bandanaBounds?object
locations[].bandanaBounds.eastnumber
locations[].bandanaBounds.westnumber
locations[].bandanaBounds.zoominteger
locations[].bandanaBounds.northnumber
locations[].bandanaBounds.southnumber
locations[].formatted_address?string | null
locations[].structured_formatting?object | null

Fields 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 · string

Bandana company UUID.

Example: ca9dcc27-71cf-44e9-948a-9667c5e4dfaf

pageOptionalQuery · integer, min: 1, default: 1

1-based page of 30 open posting UUIDs, mapped to Bandana's take/skip pagination.

Example: 1

Response

companyobject
company.logo?string | null
company.name?string | null
company.uuid?string | null
company.website?string | null
company.industry?object
company.industry.name?string | null
company.photoSet?unknown | null
company.cardPhoto?string | null
company.atsCompany?object[]
company.atsCompany[].ats?string | null
company.atsCompany[].uuid?string | null
company.atsCompany[].companyUuid?string | null
company.atsCompany[].isIntegrated?boolean | null
company.atsCompany[].atsIdentifier?string | null
company.atsCompany[].trackingToken?string | null
company.description?string | null
company.postingCount?integer | null
company.primaryPhoto?string | null
company.locationCount?integer | null
company.generalPhotoSet?unknown | null
openJobsobject[]
openJobs[].uuidstring

Fields 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.