> ## Documentation Index > Fetch the complete documentation index at: https://jobo.world/docs/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve a bulk feed of newly discovered career sites ## OpenAPI ````yaml /openapi.yaml post /api/career-sites/feed openapi: 3.1.0 info: title: Jobo Enterprise API description: > The Jobo Enterprise API provides programmatic access to job listings, intelligent search, real-time feeds, automated job applications, and geocoding services. version: 1.0.0 contact: name: Jobo Support url: https://jobo.world email: support@jobo.world servers: - url: https://connect.jobo.world description: Production security: - ApiKeyAuth: [] tags: - name: Jobs Search description: Search and retrieve job listings - name: Jobs Feed description: Bulk job feeds and expiration tracking - name: Career Sites Feed description: Bulk feed of newly discovered career sites with enriched company profiles - name: Companies description: Company profiles and company-scoped job listings - name: Auto Apply description: Automated job application sessions - name: Auto Apply Profiles description: Manage applicant profiles for auto-apply - name: Locations description: Geocoding and location services paths: /api/career-sites/feed: post: tags: - Career Sites Feed summary: Retrieve a bulk feed of newly discovered career sites operationId: getCareerSiteFeed requestBody: required: false content: application/json: schema: $ref: '#/components/schemas/CareerSiteFeedRequest' responses: '200': description: Batch of career sites with cursor for next page headers: X-Has-More: schema: type: boolean description: Duplicates response body `has_more` for quick checks. X-Credits-Deducted: schema: type: integer description: >- Credits debited for this request. Omitted when no wallet debit occurs. X-Credits-Balance: schema: type: integer description: Remaining credit balance after this call. content: application/json: schema: $ref: '#/components/schemas/CareerSiteFeedResponse' '400': description: Invalid request (e.g., batch_size out of range, malformed cursor) content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '401': $ref: '#/components/responses/Unauthorized' components: schemas: CareerSiteFeedRequest: type: object description: | Filters for the career-sites feed. All fields are optional; omit the body for an unfiltered feed of all newly discovered career sites. properties: industries: type: array items: type: string nullable: true description: Industry tags. OR-match across the list. company_sizes: type: array items: type: string nullable: true description: Size bands, e.g. "1-10", "11-50", "51-200". country_codes: type: array items: type: string nullable: true description: ISO 3166-1 alpha-2 country codes. funding_stages: type: array items: type: string nullable: true description: Funding stages, e.g. "seed", "series_a". company_types: type: array items: type: string enum: - for_profit - non_profit nullable: true founded_after: type: integer nullable: true description: Only career sites whose company was founded in or after this year. is_agency: type: boolean nullable: true description: Restrict to agency (true) or non-agency (false) companies. updated_after: type: string format: date-time nullable: true description: >- Only career sites whose updated_at is strictly greater than this UTC timestamp. discovered_after: type: string format: date-time nullable: true description: > Only companies first discovered (i.e. first enriched to completion) on or after this UTC timestamp. Stable across re-enrichment runs. discovered_before: type: string format: date-time nullable: true description: | Only companies first discovered strictly before this UTC timestamp. Pair with `discovered_after` for a bounded window backfill. cursor: type: string nullable: true batch_size: type: integer default: 50 minimum: 1 maximum: 50 CareerSiteFeedResponse: type: object properties: career_sites: type: array items: $ref: '#/components/schemas/CareerSiteDto' description: Career sites in this batch. next_cursor: type: string nullable: true has_more: type: boolean ProblemDetails: type: object description: RFC 7807 problem details object returned for error responses. properties: type: type: string nullable: true title: type: string nullable: true status: type: integer nullable: true detail: type: string nullable: true instance: type: string nullable: true CareerSiteDto: type: object description: > Slim representation of a discovered career site. Carries enough company context to display a card (same fields as the company embedded in a job preview) plus the ATS the site runs on, the listing URL where its jobs are posted, and a details URL to fetch the fully enriched company profile. properties: id: type: string format: uuid name: type: string website: type: string nullable: true logo_url: type: string nullable: true summary: type: string nullable: true industries: type: array items: type: string categories: type: array items: type: string description: Business-model bucket tags (b2b / b2c / saas / service-provider). linkedin_url: type: string nullable: true crunchbase_url: type: string nullable: true ats: type: string description: >- ATS / job-board provider the career site runs on (e.g. "greenhouse", "lever", "workday"). listing_url: type: string description: Career-site URL where the company's jobs are listed. discovered_at: type: string format: date-time nullable: true description: >- UTC timestamp the career site was first discovered (first reached pipeline completion). Stable across re-enrichment runs. updated_at: type: string format: date-time description: UTC timestamp the company profile was last updated. details_url: type: string nullable: true description: | Public URL to the fully enriched company profile (`GET https://connect.jobo.world/api/companies/{id}`). responses: Unauthorized: description: Missing or invalid API key securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-Api-Key description: API key provided by Jobo ````