# Read Contra Job Feed API

> Read one page of your signed-in Contra job feed. Returns the feed nodes exactly as Contra sends them plus the pagination cursor. Uses your own Contra account; upAPI stores nothing.

Category: [Social Media APIs](https://upapi.io/apis/social-media) · Last updated 2026-10-31

## How to call it

- Endpoint: `POST https://api.upapi.io/contra-job-feed.get`, key in the `X-Api-Key` header, JSON body.
- Cost: 4 weighted units per call.
- Timeout: 45 seconds.
- Cache: none; every call runs the operation.
- Try it without writing code: https://app.upapi.io/try/contra-job-feed.get

```bash
curl -X POST https://api.upapi.io/contra-job-feed.get \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "sort": "NEWEST", "first": 20, "preset": "RECOMMENDED", "sessionCookies": {} }'
```

## Request parameters

- `sort` (string) — Contra feed sort key.
- `after` (string) — Opaque cursor from a previous page's endCursor.
- `docId` (string) — Override the pinned persisted-query id for this call.
- `first` (integer) — Page size.
- `preset` (string) — Contra feed preset, e.g. RECOMMENDED, SAVED or APPLIED.
- `search` (string) — Free-text feed search.
- `proxyUrl` (string) — Exit IP pinned to this account. Omit to use the shared pool.
- `sessionCookies` (object, required) — Contra session cookies. The job feed answers UNAUTHENTICATED without them. Your own Contra account's cookies; upAPI stores nothing.

## Response fields

- `items` (array, required)
- `elapsedMs` (integer, required)
- `endCursor` (string, required)
- `fetchedAt` (string, required)
- `itemCount` (integer, required)
- `hasNextPage` (boolean, required)

## Example request and response

The example response is generated from the published output schema: it shows the shape and field names, not values from a recorded call.

```json
{
  "sort": "NEWEST",
  "first": 20,
  "preset": "RECOMMENDED",
  "sessionCookies": {}
}
```

```json
{
  "items": [
    {}
  ],
  "elapsedMs": 1,
  "endCursor": "example",
  "fetchedAt": "example",
  "itemCount": 1,
  "hasNextPage": false
}
```

## Frequently asked questions

### How much does the Read Contra Job Feed API cost per call?

Each call spends 4 weighted units of your plan's monthly quota. Full pricing is at https://upapi.io/pricing.

### How do I authenticate to the Read Contra Job Feed API?

Send your key in the X-Api-Key header. A free guest key is available without creating an account.

### Are Read Contra Job Feed API responses cached?

No — every call runs the operation live; responses are not cached.

## More Social Media APIs

- [Apply To Contra Job](https://upapi.io/apis/social-media/contra-apply-to-job)
- [Get Contra Opportunity](https://upapi.io/apis/social-media/contra-job-detail)
- [Search Contra Freelancers](https://upapi.io/apis/social-media/contra-discover-people)
- [Send Contra Message](https://upapi.io/apis/social-media/contra-send-message)
- [Unfollow Contra Profile](https://upapi.io/apis/social-media/contra-unfollow-user)
- [Check Contra Session](https://upapi.io/apis/social-media/contra-check-session)
- [Follow Contra Profile](https://upapi.io/apis/social-media/contra-follow-user)
- [Get Contra Company Profile](https://upapi.io/apis/social-media/contra-company-profile)