> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automindz.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Get scrape status
> Poll the status and results of a career page scrape
Poll until `status` is `COMPLETED` or `FAILED`. The `result` field is populated on completion.
Page through the returned jobs with the `limit` (1–50, default 25) and `offset` query params.
* **`jobs_total`** — total jobs this scrape returned. Same value on every page, whatever `limit` you
ask for. This is the count to page against.
* **`jobs_returned`** — size of the page you just got.
* **`has_more`** — `true` while jobs remain; keep paging until it is `false`.
* **`jobs_filtered_out`** — postings found on the career page but not returned. Mostly ones
`target_titles` / `target_locations` rejected, so if you set those, a high number next to a low
`jobs_total` means they are too narrow. It also counts a few postings dropped for other reasons
(no link to fetch), so it can be non-zero even with no filters set. Constant across pages.
**Polling guidance:** Check every 15–30 seconds. Most scrapes complete within 2–5 minutes.
## Example responses
```json theme={null}
{
"request_id": "run_abc123xyz",
"status": "RUNNING",
"result": null,
"credits_consumed": null,
"credits_left": null,
"started_at": "2026-05-15T10:00:00Z",
"finished_at": null
}
```
```json theme={null}
{
"request_id": "run_abc123xyz",
"status": "COMPLETED",
"result": {
"company": "Acme Corp",
"url": "https://acme.com",
"career_page_urls": ["https://jobs.lever.co/acme"],
"pages_scraped": 3,
"warnings": null,
"jobs_returned": 1,
"jobs_total": 1,
"jobs_filtered_out": 11,
"limit": 25,
"offset": 0,
"has_more": false,
"jobs": [
{
"job_title": "Senior Software Engineer",
"location": "London, UK",
"city": "London",
"country": "United Kingdom",
"job_type": "full-time",
"remote_policy": "hybrid",
"department": "Engineering",
"salary_min": 90000,
"salary_max": 120000,
"salary_currency": "GBP",
"salary_period": "annual",
"min_years_of_experience": 5,
"requirements": ["5+ years TypeScript", "React", "Node.js"],
"job_url": "https://jobs.lever.co/acme/abc-123",
"ats_system": "lever",
"posted_at": "2026-05-01"
}
]
},
"credits_consumed": 2.89,
"credits_left": 185.89,
"started_at": "2026-05-15T10:00:00Z",
"finished_at": "2026-05-15T10:03:42Z"
}
```
## OpenAPI
````yaml openapi.json GET /v1/scrape-career-pages/async/{request_id}
openapi: 3.1.0
info:
title: Automindz API
version: 0.1.0
servers:
- url: https://api.automindz.co
description: Production
security: []
paths:
/v1/scrape-career-pages/async/{request_id}:
get:
tags:
- scrape-career-pages
summary: Get Scrape Career Pages Status
operationId: >-
get_scrape_career_pages_status_v1_scrape_career_pages_async__request_id__get
parameters:
- name: request_id
in: path
required: true
schema:
type: string
description: The `run_...` id returned by the scrape endpoint.
title: Request Id
description: The `run_...` id returned by the scrape endpoint.
- name: limit
in: query
required: false
schema:
type: integer
maximum: 50
minimum: 1
description: Max jobs to return (pagination page size).
default: 25
title: Limit
description: Max jobs to return (pagination page size).
- name: offset
in: query
required: false
schema:
type: integer
minimum: 0
description: Number of jobs to skip (pagination offset).
default: 0
title: Offset
description: Number of jobs to skip (pagination offset).
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ScrapeJobsStatusResponse'
example:
request_id: run_cmp6liidi8by50hn5n24xej0a
status: COMPLETED
result:
company: inRiver
url: https://inriver.com/
career_page_urls:
- https://career.inriver.com
pages_scraped: 1
jobs:
- job_title: Service Delievery Manager
location: Malmö
city: Malmö
country: Sweden
requirements:
- >-
A minimum of 3-5 years of experience in Service
Delivery Management, Project Management, or similar
customer-facing roles
- >-
Experience working with customer relationship
management, leadership, and customer service within
the tech industry
- >-
Strong project management skills, including planning,
coordination, prioritization, and stakeholder
management
- >-
Excellent interpersonal and communication skills, with
the ability to build trusted customer relationships
- >-
Strong problem-solving skills and the ability to
manage complex situations effectively
- >-
Good understanding of technical solutions and service
delivery processes
- >-
Proven ability to lead cross-functional teams and
collaborate with external vendors and partners
nice_to_have:
- >-
Experience within SaaS and/or PIM solutions is
considered a strong advantage
hiring_manager_name: Olivia Veal
job_description: >-
At Inriver, we help brands deliver better product
experiences — wherever their customers are. From the
first product detail to the final purchase decision, we
make product information work smarter. We are now
looking for a Service Delivery Manager to join our team
in the Malmo.
benefits:
- >-
A supportive team culture with space to learn, lead,
and grow
- >-
A workplace where your voice matters and your work
makes a difference
- Tuesday Fika
- Friday breakfasts to start the day together
- >-
A running club and social activities for anyone who
wants to join
min_years_of_experience: 3
remote_policy: hybrid
department: Sales
company_name: inRiver
job_url: >-
https://career.inriver.com/jobs/7719732-service-delievery-manager
ats_system: Teamtailor
- job_title: Product Manager
location: Malmö
city: Malmö
country: Sweden
requirements:
- >-
3+ years in product management, preferably on an AI or
data-intensive platform
- >-
Background in PIM, MDM, DAM, Commerce, ERP, PLM, or
adjacent domains is considered an advantage
- >-
Proven ability defining requirements and driving
delivery
- >-
Familiarity with product data models: catalogs,
attributes, variants, hierarchies, and enrichment
- >-
Experience across the full product development
lifecycle, from discovery through deprecation
- >-
Solid grasp of modern software architecture and AI/ML
integration patterns
- Working knowledge of UX principles and UI frameworks
- Business English fluency, written and spoken
nice_to_have:
- >-
Background in PIM, MDM, DAM, Commerce, ERP, PLM, or
adjacent domains is considered an advantage
job_description: >-
At Inriver, we help brands deliver better product
experiences - everywhere their customers are. Now we're
looking for a Product Manager to join our awesome team.
min_years_of_experience: 3
remote_policy: hybrid
department: Product Management
company_name: inRiver
job_url: https://career.inriver.com/jobs/7665247-product-manager
ats_system: Teamtailor
- job_title: Finance Business Partner
location: Malmö
city: Malmö
country: Sweden
requirements:
- >-
At least 3-5 years of experience in FP&A, controlling,
and business partnering
- >-
Confidence working with forecasting, budgeting, and
financial modelling
- >-
The ability to turn complex numbers into clear
business insight
- >-
Strong data and BI skills, and interest in automation
and AI
hiring_manager_name: Olivia Veal
job_description: >-
At Inriver, we help brands deliver better product
experiences — everywhere their customers are. Now we're
looking for a Finance Business Partner to support our
CFO and global leadership team.
benefits:
- Tuesday Fika
- Friday breakfasts to start the day together
- >-
A running club and social activities for anyone who
wants to join
min_years_of_experience: 3
remote_policy: Hybrid
department: Finance
company_name: inRiver
job_url: >-
https://career.inriver.com/jobs/7236030-finance-business-partner
ats_system: Teamtailor
jobs_returned: 3
jobs_total: 3
jobs_filtered_out: 7
limit: 25
offset: 0
has_more: false
credits_consumed: 2.89
credits_left: 185.89
started_at: '2026-05-15T07:28:21.187Z'
finished_at: '2026-05-15T07:31:43.245Z'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
components:
schemas:
ScrapeJobsStatusResponse:
properties:
request_id:
type: string
title: Request Id
status:
type: string
title: Status
result:
anyOf:
- $ref: '#/components/schemas/ScrapeResult'
- type: 'null'
credits_consumed:
anyOf:
- type: number
- type: 'null'
title: Credits Consumed
credits_left:
anyOf:
- type: number
- type: 'null'
title: Credits Left
started_at:
anyOf:
- type: string
- type: 'null'
title: Started At
finished_at:
anyOf:
- type: string
- type: 'null'
title: Finished At
type: object
required:
- request_id
- status
title: ScrapeJobsStatusResponse
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ScrapeResult:
properties:
company:
anyOf:
- type: string
- type: 'null'
title: Company
url:
anyOf:
- type: string
- type: 'null'
title: Url
career_page_urls:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Career Page Urls
pages_scraped:
anyOf:
- type: integer
- type: 'null'
title: Pages Scraped
jobs:
anyOf:
- items:
$ref: '#/components/schemas/JobPosting'
type: array
- type: 'null'
title: Jobs
warnings:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Warnings
jobs_returned:
anyOf:
- type: integer
- type: 'null'
title: Jobs Returned
jobs_total:
anyOf:
- type: integer
- type: 'null'
title: Jobs Total
jobs_filtered_out:
anyOf:
- type: integer
- type: 'null'
title: Jobs Filtered Out
limit:
anyOf:
- type: integer
- type: 'null'
title: Limit
offset:
anyOf:
- type: integer
- type: 'null'
title: Offset
has_more:
anyOf:
- type: boolean
- type: 'null'
title: Has More
additionalProperties: true
type: object
title: ScrapeResult
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
JobPosting:
properties:
job_title:
anyOf:
- type: string
- type: 'null'
title: Job Title
location:
anyOf:
- type: string
- type: 'null'
title: Location
city:
anyOf:
- type: string
- type: 'null'
title: City
country:
anyOf:
- type: string
- type: 'null'
title: Country
job_type:
anyOf:
- type: string
- type: 'null'
title: Job Type
remote_policy:
anyOf:
- type: string
- type: 'null'
title: Remote Policy
department:
anyOf:
- type: string
- type: 'null'
title: Department
salary_min:
anyOf:
- type: number
- type: 'null'
title: Salary Min
salary_max:
anyOf:
- type: number
- type: 'null'
title: Salary Max
salary_currency:
anyOf:
- type: string
- type: 'null'
title: Salary Currency
salary_period:
anyOf:
- type: string
- type: 'null'
title: Salary Period
min_years_of_experience:
anyOf:
- type: integer
- type: 'null'
title: Min Years Of Experience
requirements:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Requirements
nice_to_have:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Nice To Have
benefits:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Benefits
job_description:
anyOf:
- type: string
- type: 'null'
title: Job Description
hiring_manager_name:
anyOf:
- type: string
- type: 'null'
title: Hiring Manager Name
hiring_manager_email:
anyOf:
- type: string
- type: 'null'
title: Hiring Manager Email
hiring_manager_phone:
anyOf:
- type: string
- type: 'null'
title: Hiring Manager Phone
job_url:
anyOf:
- type: string
- type: 'null'
title: Job Url
ats_system:
anyOf:
- type: string
- type: 'null'
title: Ats System
posted_at:
anyOf:
- type: string
- type: 'null'
title: Posted At
application_deadline:
anyOf:
- type: string
- type: 'null'
title: Application Deadline
company_name:
anyOf:
- type: string
- type: 'null'
title: Company Name
company_size:
anyOf:
- type: string
- type: 'null'
title: Company Size
company_website:
anyOf:
- type: string
- type: 'null'
title: Company Website
industry:
anyOf:
- type: string
- type: 'null'
title: Industry
headquarters:
anyOf:
- type: string
- type: 'null'
title: Headquarters
founded:
anyOf:
- type: string
- type: 'null'
title: Founded
revenue:
anyOf:
- type: string
- type: 'null'
title: Revenue
additionalProperties: true
type: object
title: JobPosting
securitySchemes:
HTTPBearer:
type: http
scheme: bearer
````