Email finder (unlimited)
Submit Bulk Email Finder Job (Unlimited Plans)
Submit a bulk email finder job on an unlimited plan. Rows count as searches against your plan’s daily bulk search limit instead of credits.
POST
/
v1
/
unlimited
/
bulk-lookup
curl --request POST \
--url https://api.orbisearch.com/v1/unlimited/bulk-lookup \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"input": [
{
"linkedin_url": "https://www.linkedin.com/in/jane-doe"
},
{
"linkedin_url": "https://www.linkedin.com/in/john-smith"
}
]
}
'{
"job_id": "123e4567-e89b-12d3-a456-426614174000",
"status": "submitted",
"total_rows": 500,
"credits_consumed": 0
}{
"detail": "API key required in X-API-Key header"
}{
"detail": "No active subscription. This key resumes working when the subscription is reinstated.",
"code": "subscription_inactive"
}{
"detail": "This endpoint requires an unlimited API key. Pay-as-you-go keys use the credit-metered /v1 endpoints.",
"code": "wrong_key_plan"
}{
"detail": "Invalid request body field '0': Input should be a valid string.",
"errors": [
{
"loc": "body.0",
"msg": "Invalid request body field '0': Input should be a valid string.",
"type": "string_type"
}
]
}{
"detail": "Rate limit exceeded. Maximum 20 requests per second per account. Contact us to discuss higher limits.",
"code": "rate_limited"
}This is the unlimited-plan variant of POST /v1/bulk-lookup. The request body, deduplication behavior, async processing model, and per-job limit of
10,000 rows are identical; see the counterpart page for those details. What differs is metering: submissions draw from your plan’s daily bulk search quota instead of your credit balance, at one search per unique row.
Requests require an Unlimited API key tied to an active unlimited plan. A pay-as-you-go key on this endpoint returns 403 with code: wrong_key_plan; if the plan’s subscription has lapsed, the key returns 402 with code: subscription_inactive until it is reinstated.
Poll GET /v1/unlimited/bulk-lookup/{job_id} to track progress, then fetch results via GET /v1/unlimited/bulk-lookup/{job_id}/results.
Daily search quota
- You can submit an unlimited number of jobs, each up to
10,000rows. - Each accepted submission consumes one search per unique (deduplicated) row from your plan’s daily limit, and
invalid_linkedin_urlrows consume none: 10,000 searches per day on Starter, 30,000 on Standard, 75,000 on Professional. - The daily window is aligned to UTC midnight. Consumption resets when the UTC day rolls over; GET /v1/unlimited/usage reports the exact reset time in
bulk_searches_reset_at. - The quota is per account and is shared with dashboard bulk finder jobs run on your plan: searches consumed in the dashboard reduce what this endpoint can accept the same day, and vice versa.
- A rejected or failed submission consumes nothing. If OrbiSearch infrastructure cannot accept or process the submission, any consumed searches are released and no job is created.
- No credits are charged;
credits_consumedreads0on unlimited plans.
429 and code: bulk_searches_limited. The Retry-After header gives the seconds until the quota resets at UTC midnight. See errors for handling.
Rate limits
This endpoint shares the per-account request-rate limit with the rest of the API. The daily search quota, not the request rate, is the practical throughput ceiling for bulk work.Authorizations
API key for authentication
Body
application/json
Submission payload for POST /v1/bulk-lookup.
Rows to search: every row a linkedin_url, or every row a first/last name and a company domain. One input type per job; a list that mixes them is refused with 422. Duplicate rows are deduplicated before billing. Maximum 10,000 rows per submission.
Required array length:
1 - 10000 elementsShow child attributes
Show child attributes
Response
Successful Response
Response when submitting a bulk email finder job.
Unique job identifier. Pass this to GET /v1/bulk-lookup/{job_id} to poll status.
Example:
"123e4567-e89b-12d3-a456-426614174000"
Submission acknowledgement status.
Available options:
submitted Allowed value:
"submitted"Example:
"submitted"
Number of unique rows submitted after deduplication.
Example:
500
Credits deducted for this submission: 1 per unique row on pay-as-you-go keys, except invalid_linkedin_url rows, which are free; 0 on unlimited plans (rows draw on the daily cap instead).
Example:
500
⌘I
curl --request POST \
--url https://api.orbisearch.com/v1/unlimited/bulk-lookup \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"input": [
{
"linkedin_url": "https://www.linkedin.com/in/jane-doe"
},
{
"linkedin_url": "https://www.linkedin.com/in/john-smith"
}
]
}
'{
"job_id": "123e4567-e89b-12d3-a456-426614174000",
"status": "submitted",
"total_rows": 500,
"credits_consumed": 0
}{
"detail": "API key required in X-API-Key header"
}{
"detail": "No active subscription. This key resumes working when the subscription is reinstated.",
"code": "subscription_inactive"
}{
"detail": "This endpoint requires an unlimited API key. Pay-as-you-go keys use the credit-metered /v1 endpoints.",
"code": "wrong_key_plan"
}{
"detail": "Invalid request body field '0': Input should be a valid string.",
"errors": [
{
"loc": "body.0",
"msg": "Invalid request body field '0': Input should be a valid string.",
"type": "string_type"
}
]
}{
"detail": "Rate limit exceeded. Maximum 20 requests per second per account. Contact us to discuss higher limits.",
"code": "rate_limited"
}