SOCIAL MEDIA
Search Contra Freelancers API
Search contra.com's public directory of independent professionals by role or free text. Returns each profile's name, headline, roles, location, review average and count, follower and hire counts, availability and minimum hourly rate. Reads Contra's public page — no Contra account is required.
How to call it
Send one POST to api.upapi.io/contra-discover-people.get with your key in the X-Api-Key header and the parameters below as a JSON body. Each call spends 5 weighted units of your monthly quota. The operation times out after 45 seconds. Identical requests are served from cache for 300 seconds, unbilled.
POST https://api.upapi.io/contra-discover-people.get
Search Contra Freelancers API reference
Request parameters
- query
- string — Free-text search over profiles. Omit to browse by role only.
- roles
- array — Contra role names to filter on, e.g. ["Web Developer", "Brand Designer"]. Omit for the unfiltered directory.
- proxyUrl
- string — User-provided proxy URL. Omit to use the operation's own datacenter pool.
Response fields
- url
- stringrequired
- query
- stringrequired
- roles
- arrayrequired
- people
- arrayrequired
- people[].id
- stringrequired
- people[].name
- stringrequired
- people[].roles
- arrayrequired
- people[].title
- stringrequired
- people[].location
- stringrequired
- people[].username
- stringrequired
- people[].avatarUrl
- stringrequired
- people[].hiredCount
- integerrequired
- people[].profileUrl
- stringrequired
- people[].followerCount
- integerrequired
- people[].isNewToContra
- booleanrequired
- people[].reviewSummary
- objectrequired
- people[].workPreferences
- objectrequired
- people[].isQuickResponder
- booleanrequired
- people[].professionalTitle
- stringrequired
- people[].visitorIsFollowing
- booleanrequired
- people[].canReceiveInquiries
- booleanrequired
- people[].platformEarningsBadge
- stringrequired
- elapsedMs
- integerrequired
- fetchedAt
- stringrequired
- resultCount
- 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.
{
"query": "typescript"
}{
"url": "https://github.com",
"query": "typescript",
"roles": [
"example"
],
"people": [
{
"id": "example",
"name": "example",
"roles": [
"example"
],
"title": "Alan Turing",
"location": "example",
"username": "torvalds",
"avatarUrl": "example",
"hiredCount": 1,
"profileUrl": "example",
"followerCount": 1,
"isNewToContra": false,
"reviewSummary": {
"count": null,
"averageScore": null
},
"workPreferences": {
"minimumHourlyRate": null,
"isCurrentlyAvailable": null
},
"isQuickResponder": false,
"professionalTitle": "example",
"visitorIsFollowing": false,
"canReceiveInquiries": false,
"platformEarningsBadge": "example"
}
],
"elapsedMs": 1,
"fetchedAt": "example",
"resultCount": 1
}Code snippets
cURL
curl -X POST https://api.upapi.io/contra-discover-people.get \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{ "query": "typescript" }'JavaScript
const response = await fetch('https://api.upapi.io/contra-discover-people.get', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': 'YOUR_API_KEY',
},
body: JSON.stringify({
"query": "typescript"
}),
});
const data = await response.json();
console.log(data);Python
import requests
response = requests.post(
'https://api.upapi.io/contra-discover-people.get',
headers={
'Content-Type': 'application/json',
'x-api-key': 'YOUR_API_KEY',
},
json={
"query": "typescript"
},
)
print(response.json())Go
package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
)
func main() {
payload := []byte(`{ "query": "typescript" }`)
req, _ := http.NewRequest("POST", "https://api.upapi.io/contra-discover-people.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
$payload = json_encode([
'query' => 'typescript',
]);
$ch = curl_init('https://api.upapi.io/contra-discover-people.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
require 'net/http'
require 'uri'
require 'json'
uri = URI('https://api.upapi.io/contra-discover-people.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 = { "query": "typescript" }.to_json
response = http.request(request)
puts JSON.parse(response.body)Java
import okhttp3.*;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;
OkHttpClient client = new OkHttpClient();
ObjectMapper mapper = new ObjectMapper();
String json = "{ \"query\": \"typescript\" }";
RequestBody body = RequestBody.create(json, MediaType.get("application/json"));
Request request = new Request.Builder()
.url("https://api.upapi.io/contra-discover-people.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#
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>("{ \"query\": \"typescript\" }");
var response = await client.PostAsJsonAsync("https://api.upapi.io/contra-discover-people.get", payload);
var result = await response.Content.ReadFromJsonAsync<JsonElement>();
Console.WriteLine(result);Frequently asked questions
How much does the Search Contra Freelancers API cost per call?
Each call spends 5 weighted units of your plan's monthly quota. Full pricing is at https://upapi.io/pricing.
How do I authenticate to the Search Contra Freelancers API?
Send your key in the X-Api-Key header. A free guest key is available without creating an account.
Are Search Contra Freelancers API responses cached?
Yes — identical requests are served from cache for 300 seconds, and a cache hit is not billed.