SOCIAL MEDIA

Get Contra Opportunity API

Read one contra.com freelance opportunity by its slug: title, full description, budget range, required roles and tools, application window, and the hiring company with its review count and spend statistics. Reads Contra's public page — no Contra account is required.

contrajobsfreelancehiringopportunity
Try it freeGet an API key

How to call it

Send one POST to api.upapi.io/contra-job-detail.get with your key in the X-Api-Key header and the parameters below as a JSON body. Each call spends 4 weighted units of your monthly quota. The operation times out after 45 seconds. Identical requests are served from cache for 300 seconds, unbilled.

endpoint
POST https://api.upapi.io/contra-job-detail.get

Get Contra Opportunity API reference

Request parameters

slug
stringrequired — Opportunity slug from a contra.com/opportunity/<slug> URL, e.g. "vWsXX3YM-paid-ads-graphic-designer-for-meta-and-linked-in"
proxyUrl
string — User-provided proxy URL. Omit to use the operation's own datacenter pool.

Response fields

id
stringrequired
url
stringrequired
slug
stringrequired
roles
arrayrequired
title
stringrequired
tools
arrayrequired
budget
objectrequired
budget.max
objectrequired
budget.min
objectrequired
budget.type
stringrequired
budget.estimatedHours
integerrequired
status
stringrequired
createdAt
stringrequired
elapsedMs
integerrequired
expiresAt
stringrequired
fetchedAt
stringrequired
description
stringrequired
externalUrl
stringrequired
organization
objectrequired
visitorCanApply
booleanrequired
hiringAsIndividual
booleanrequired
applicationsClosedAt
stringrequired
numberOfOpenPositions
integerrequired
allowGuestApplications
booleanrequired
numberOfFilledPositions
integerrequired

Example request and response

The example response is generated from this operation’s published output schema — it shows the shape and field names, not values from a recorded call.

json — example request body
{
  "slug": "vWsXX3YM-paid-ads-graphic-designer-for-meta-and-linked-in"
}
json — example response shape
{
  "id": "example",
  "url": "https://github.com",
  "slug": "example",
  "roles": [
    "example"
  ],
  "title": "Alan Turing",
  "tools": [
    "example"
  ],
  "budget": {
    "max": {
      "amount": 100,
      "currency": "example"
    },
    "min": {
      "amount": 100,
      "currency": "example"
    },
    "type": "example",
    "estimatedHours": 1
  },
  "status": "example",
  "createdAt": "example",
  "elapsedMs": 1,
  "expiresAt": "example",
  "fetchedAt": "example",
  "description": "example",
  "externalUrl": "example",
  "organization": {
    "id": "example",
    "name": "example",
    "slug": "example",
    "logoUrl": "example",
    "website": "example",
    "headline": "example",
    "location": "example",
    "isVerified": false,
    "statistics": {},
    "description": "example",
    "reviewCount": 1,
    "yearFounded": 1,
    "profileRoute": "example",
    "numberOfEmployees": 1
  },
  "visitorCanApply": false,
  "hiringAsIndividual": false,
  "applicationsClosedAt": "example",
  "numberOfOpenPositions": 1,
  "allowGuestApplications": false,
  "numberOfFilledPositions": 1
}

Code snippets

cURL
curl
curl -X POST https://api.upapi.io/contra-job-detail.get \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "slug": "vWsXX3YM-paid-ads-graphic-designer-for-meta-and-linked-in" }'
JavaScript
javascript
const response = await fetch('https://api.upapi.io/contra-job-detail.get', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
  "slug": "vWsXX3YM-paid-ads-graphic-designer-for-meta-and-linked-in"
}),
});

const data = await response.json();
console.log(data);
Python
python
import requests

response = requests.post(
    'https://api.upapi.io/contra-job-detail.get',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY',
    },
    json={
  "slug": "vWsXX3YM-paid-ads-graphic-designer-for-meta-and-linked-in"
},
)

print(response.json())
Go
go
package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{ "slug": "vWsXX3YM-paid-ads-graphic-designer-for-meta-and-linked-in" }`)

	req, _ := http.NewRequest("POST", "https://api.upapi.io/contra-job-detail.get", bytes.NewBuffer(payload))
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("x-api-key", "YOUR_API_KEY")

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	var result map[string]any
	json.Unmarshal(body, &result)
	fmt.Println(result)
}
PHP
php
<?php

$payload = json_encode([
    'slug' => 'vWsXX3YM-paid-ads-graphic-designer-for-meta-and-linked-in',
]);

$ch = curl_init('https://api.upapi.io/contra-job-detail.get');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'x-api-key: YOUR_API_KEY',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
var_dump($data);
Ruby
ruby
require 'net/http'
require 'uri'
require 'json'

uri = URI('https://api.upapi.io/contra-job-detail.get')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'

request = Net::HTTP::Post.new(uri.path)
request['Content-Type'] = 'application/json'
request['x-api-key'] = 'YOUR_API_KEY'
request.body = { "slug": "vWsXX3YM-paid-ads-graphic-designer-for-meta-and-linked-in" }.to_json

response = http.request(request)
puts JSON.parse(response.body)
Java
java
import okhttp3.*;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;

OkHttpClient client = new OkHttpClient();
ObjectMapper mapper = new ObjectMapper();

String json = "{ \"slug\": \"vWsXX3YM-paid-ads-graphic-designer-for-meta-and-linked-in\" }";

RequestBody body = RequestBody.create(json, MediaType.get("application/json"));
Request request = new Request.Builder()
    .url("https://api.upapi.io/contra-job-detail.get")
    .post(body)
    .addHeader("Content-Type", "application/json")
    .addHeader("x-api-key", "YOUR_API_KEY")
    .build();

try (Response response = client.newCall(request).execute()) {
    Map<?, ?> result = mapper.readValue(response.body().string(), Map.class);
    System.out.println(result);
}
C#
csharp
using System.Net.Http;
using System.Net.Http.Json;
using System.Text.Json;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");

var payload = JsonSerializer.Deserialize<object>("{ \"slug\": \"vWsXX3YM-paid-ads-graphic-designer-for-meta-and-linked-in\" }");
var response = await client.PostAsJsonAsync("https://api.upapi.io/contra-job-detail.get", payload);

var result = await response.Content.ReadFromJsonAsync<JsonElement>();
Console.WriteLine(result);

Frequently asked questions

How much does the Get Contra Opportunity 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 Get Contra Opportunity API?

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

Are Get Contra Opportunity API responses cached?

Yes — identical requests are served from cache for 300 seconds, and a cache hit is not billed.

More Social Media APIs

Browse every Social Media API →