↑ ↓ to move ↵ to open
Instahyre Jobs API reference

Instahyre Autocomplete Companies

instahyre.companies.autocomplete

Turn a company name into Instahyre employer IDs for the company filter.

At a glance

Endpoint ID
instahyre.companies.autocomplete
Price
1 credit per call; failed calls are free
Runs for up to
60 seconds
Request
POST /execute
Run an endpoint
MCP tool when pinned
instahyre__companies__autocomplete
Pin tools
OpenAPI
openapi.json
Download

Request

Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.

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.companies.autocomplete",  "input": {    "query": "Samsung"  }}'

Input

FieldTypeRequiredWhat it doesExample
query string yes Search query. Samsung

Response

A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.

This is results[0].data from a real run:

results[0].data
{  "success": true,  "objects": [    {      "company_name": "Samsung",      "id": 1535,      "resource_uri": "/api/v1/employer_misc/employer_profile/anon_employer_limited/1535"    },    {      "company_name": "Samsung Electro-Mechanics",      "id": 7506,      "resource_uri": "/api/v1/employer_misc/employer_profile/anon_employer_limited/7506"    }  ]}

Fields

FieldTypeWhat it isExample
objects[].company_name string The company's name. Samsung
objects[].id integer Instahyre's ID for the company. 1535
objects[].resource_uri string /api/v1/employer_misc/employer_profile/anon_employer_limited/15…
objects array Companies matching what you typed. 2 records
success boolean Whether the lookup worked. true

If a call fails

A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.

Other Instahyre Jobs endpoints

Something missing or unclear? Ask the team that builds the Instahyre Jobs endpoints.