Instahyre Jobs API · Endpoint

Instahyre Jobs Locations API

Q: Can my AI agent call it?

Yes, over MCP: the agent finds instahyre.locations.list, checks its price and runs it with the same credits as the REST API.

List the cities, regions and remote options you can filter by.

1 credit per call
Failed calls are free
Updated 12 Oct 2026
instahyre.locations.list

Start free, 100 credits API reference

Response completed

{  "success": true,  "data": {    "cities_current": [      {        "name": "Ahmedabad",        "alter": "",        "iso_alpha_code": "",        "show_in_dropdown": "TRUE",        "type": "top metropolitan cities",        "value": "Ahmedabad"      },      {        "name": "Bangalore",        "alter": "Bengaluru, Bangaluru",        "iso_alpha_code": "",        "show_in_dropdown": "TRUE",        "type": "top metropolitan cities",        "value": "Bangalore"      }    ],    "cities_current_groups": [      {        "label": "-----Top Metropolitan Cities-----",        "value": "top metropolitan cities"      },      {        "label": "-----Andhra Pradesh-----",        "value": "andhra pradesh"      }    ],    "cities_preferred": [      {        "name": "Work from home / Remote",        "type": "remote",        "value": "Work From Home"      },      {        "name": "Anywhere in India",        "type": "regions",        "value": "Anywhere in India"      }    ],    "cities_preferred_groups": [      {        "label": "-----Regions-----",        "value": "regions"      },      {        "label": "-----Top Metropolitan Cities-----",        "value": "top metropolitan cities"      }    ]  }}

308 rows

#	Name	Type	Value
1	Work from home / Remote	remote	Work From Home
2	Anywhere in India	regions	Anywhere in India
3	North India	regions	North India
4	South India	regions	South India
5	East India	regions	East India
6	West India	regions	West India
7	Anywhere outside India	regions	Anywhere outside India
8	Ahmedabad	top metropolitan cities	Ahmedabad
9	Bangalore	top metropolitan cities	Bangalore
10	Chandigarh	top metropolitan cities	Chandigarh

Try it live, free

Response

Fields it returns

What each record in the response holds, with the values from the sample above.

Field	Type	What it is	Example
data.cities_preferred[].name	string	The place's name as Instahyre shows it.	Work from home / Remote
data.cities_preferred[].type	string	The group the place belongs to, such as remote or a state.	remote
data.cities_preferred[].value	string	The value Instahyre uses for the place.	Work From Home
data	object	The locations Instahyre offers.	4 fields
data.cities_current	array	Cities a candidate can give as where they live.	278 records
data.cities_current[].alter	string	Other names for the city, such as Bombay for Mumbai.
data.cities_current[].iso_alpha_code	string	The two-letter country code, given for countries only.
data.cities_current[].name	string	The city's name.	Ahmedabad
data.cities_current[].show_in_dropdown	string	Whether Instahyre lists the city for choosing, as TRUE or FALSE.	TRUE
data.cities_current[].type	string	The group the city belongs to, such as a state.	top metropolitan cities
data.cities_current[].value	string	The value Instahyre uses for the city.	Ahmedabad
data.cities_current_groups	array	Groups of current cities.	32 records
data.cities_current_groups[].label	string	The group's heading as Instahyre shows it.	-----Top Metropolitan Cities-----
data.cities_current_groups[].value	string	The group's key, matching the city's type.	top metropolitan cities
data.cities_preferred	array	Places a candidate can choose to work, remote included.	308 records
data.cities_preferred_groups	array	Groups of preferred places.	33 records
data.cities_preferred_groups[].label	string	The group's heading as Instahyre shows it.	-----Regions-----
data.cities_preferred_groups[].value	string	The group's key, matching the place's type.	regions
success	boolean	Whether the lookup worked.	true

REST API · MCP server

Call it from your code, or ask your agent

Set UPSCRAPE_API_KEY to your key and copy a working request.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "instahyre.locations.list",  "input": {}}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "instahyre.locations.list",  "input": {}}''')response = requests.post(    "https://data.upscrape.com/execute",    headers={        "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}",        "Content-Type": "application/json",        "Prefer": "wait=30",    },    json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))

const response = await fetch("https://data.upscrape.com/execute", {  method: "POST",  headers: {    "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`,    "Content-Type": "application/json",    "Prefer": "wait=30",  },  body: JSON.stringify({  "capability": "instahyre.locations.list",  "input": {}}),});if (!response.ok) {  throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));

In your AI agent Claude · Cursor · any MCP client

1Add the Upscrape MCP server

https://data.upscrape.com/mcp

2Ask for the data in plain words

With Upscrape, get the Instahyre Jobs locations. Tell me what it costs before you run it, then show the results as a table.

The agent finds the endpoint, shows you the price, and runs it with your credits.

Instahyre Jobs

More from the Instahyre Jobs API

Same data, other platforms

The same data from other platforms

Questions

Instahyre Jobs Locations API FAQ

The short answers. The docs have the long ones.

Still have a question? Talk to the people who build the endpoints.

Book a call [email protected]

How much does the Instahyre Jobs Locations API cost?

1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.

What do I send?

Every input is optional; the input fields below list what each one does.

Do I need an Instahyre Jobs login?

No. It reads public Instahyre Jobs data; nothing runs on your account.

Can my AI agent call it?

Yes, over MCP: the agent finds instahyre.locations.list, checks its price and runs it with the same credits as the REST API.

Get started

Your first Instahyre Jobs call is free.

Up to 100 free credits to start, no card needed.

Start building for free Book a call