Instahyre Jobs API Capability

Search Instahyre jobs

Search public Instahyre jobs by skills, company, location and experience, with optional bounded detail enrichment and continuation metadata.

Capability ID instahyre.jobs.search

Cost From $1.25 per 1,000 requests · 1 credit

Maximum runtime 60 seconds

View raw

# Search Instahyre jobs

Search public Instahyre jobs by skills, company, location and experience, with optional bounded detail enrichment and continuation metadata.

- Platform: [Instahyre Jobs](https://docs.upscrape.com/docs/platforms/instahyre)
- Capability ID: `instahyre.jobs.search`
- Cost: 1 credit per request
- Maximum runtime: 60 seconds
- Execute endpoint: `POST https://data.upscrape.com/execute`

## Request

Use the exact public capability ID in the shared execute envelope.

```bash
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 '{
  "input": {
    "company_size": 1,
    "include_experience": true,
    "job_type": 1,
    "limit": 20,
    "location": "Bangalore",
    "max_detail_requests": 1,
    "offset": 0,
    "skills": [
      "Python",
      "Django"
    ],
    "years": 4
  },
  "capability": "instahyre.jobs.search"
}'
```

## Input


| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `companies` | `array<string>` | No |  |
| `company_ids` | `array<integer>` | No |  |
| `company_size` | `integer` | No | At least 0. |
| `include_experience` | `boolean` | No | Opt in to numeric experience enrichment for returned jobs using public job details. No search filtering change. Each unique enriched job adds one request; missing values remain null. Default: `false`. |
| `industry_type` | `integer` | No | At least 0. |
| `job_function` | `integer` | No | At least 0. |
| `job_type` | `integer` | No | At least 0. |
| `keyword` | `string` | No | Search query. |
| `limit` | `integer` | No | Maximum jobs returned from one upstream page (currently up to 20). Zero or omitted uses the upstream default. Follow pagination metadata to continue. From 0 to 100. |
| `location` | `string` | No |  |
| `max_detail_requests` | `integer` | No | Maximum added job-detail requests per search call, after applying limit. Used only when include_experience=true; otherwise ignored. Remaining jobs have experience.status=skipped_limit. Defaults to 10 when enrichment is enabled; no HTML fetches. From 1 to 100. |
| `max_experience` | `integer` | No | Maximum candidate years for a range search. Supply with min_experience. Range results are deduplicated across each integer-year source search; use next_offset for further results. Ignored when years is supplied. At least 0. |
| `min_experience` | `integer` | No | Minimum candidate years for a range search. Supply with max_experience; the range covers at most 10 integer years. Ignored when years is supplied. At least 0. |
| `offset` | `integer` | No | Source offset for a single years value, or distinct-result offset for a min/max range search. At least 0. |
| `skills` | `array<string>` | No |  |
| `years` | `integer` | No | Candidate experience in years. Returns jobs whose source experience range includes this value. Zero requests entry-level matches. When supplied, years takes precedence over min_experience and max_experience. At least 0. |

### Example input

```json
{
  "company_size": 1,
  "include_experience": true,
  "job_type": 1,
  "limit": 20,
  "location": "Bangalore",
  "max_detail_requests": 1,
  "offset": 0,
  "skills": [
    "Python",
    "Django"
  ],
  "years": 4
}
```

## Response

Successful output is returned in `results[0].data`.

Raw platform output is intentionally open-ended and may evolve with the upstream source.

No example output is available for this capability.


## Execution behavior

A `200` response completed inline. A `202` response was queued; poll `GET /jobs/{id}` until the job reaches `completed` or `failed`. Use an `Idempotency-Key` when retrying must not create a duplicate logical job.

## Related documentation

- [Authentication](https://docs.upscrape.com/docs/api/authentication)
- [Jobs and results](https://docs.upscrape.com/docs/api/jobs)
- [Errors and retries](https://docs.upscrape.com/docs/api/errors)
- [Idempotency](https://docs.upscrape.com/docs/api/idempotency)

POST /execute Shared execution endpoint

Input parameters

companies array<string> optional

company_ids array<integer> optional

company_size integer optional

At least 0.

Example 1

include_experience boolean optional

Opt in to numeric experience enrichment for returned jobs using public job details. No search filtering change. Each unique enriched job adds one request; missing values remain null. Default: `false`.

Example true

industry_type integer optional

At least 0.

job_function integer optional

At least 0.

job_type integer optional

At least 0.

Example 1

keyword string optional

Search query.

limit integer optional

Maximum jobs returned from one upstream page (currently up to 20). Zero or omitted uses the upstream default. Follow pagination metadata to continue. From 0 to 100.

Example 20

location string optional

Example Bangalore

max_detail_requests integer optional

Maximum added job-detail requests per search call, after applying limit. Used only when include_experience=true; otherwise ignored. Remaining jobs have experience.status=skipped_limit. Defaults to 10 when enrichment is enabled; no HTML fetches. From 1 to 100.

Example 1

max_experience integer optional

Maximum candidate years for a range search. Supply with min_experience. Range results are deduplicated across each integer-year source search; use next_offset for further results. Ignored when years is supplied. At least 0.

min_experience integer optional

Minimum candidate years for a range search. Supply with max_experience; the range covers at most 10 integer years. Ignored when years is supplied. At least 0.

offset integer optional

Source offset for a single years value, or distinct-result offset for a min/max range search. At least 0.

Example 0

skills array<string> optional

Example ["Python","Django"]

years integer optional

Candidate experience in years. Returns jobs whose source experience range includes this value. Zero requests entry-level matches. When supplied, years takes precedence over min_experience and max_experience. At least 0.

Example 4

Response

Successful output is returned in results[0].data.

Raw platform output is intentionally open-ended and may evolve with the upstream source.

No example output is available for this capability yet.

Execution behavior

A 200 response completed inline. A 202 response was queued; poll GET /jobs/:id until the job reaches completed or failed.

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 '{ "input": { "company_size": 1, "include_experience": true, "job_type": 1, "limit": 20, "location": "Bangalore", "max_detail_requests": 1, "offset": 0, "skills": [ "Python", "Django" ], "years": 4 }, "capability": "instahyre.jobs.search" }'

import json import os import requests payload = json.loads(r'''{ "input": { "company_size": 1, "include_experience": true, "job_type": 1, "limit": 20, "location": "Bangalore", "max_detail_requests": 1, "offset": 0, "skills": [ "Python", "Django" ], "years": 4 }, "capability": "instahyre.jobs.search" }''') 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))