Fsome Data API v1

# Header method (recommended)
curl -H "X-API-Key: fs_your_api_key_here" \
     https://fsome.com/v1/data/searches/contacts

# Bearer token method
curl -H "Authorization: Bearer fs_your_api_key_here" \
     https://fsome.com/v1/data/searches/contacts

import requests

API_KEY = "fs_your_api_key_here"
BASE_URL = "https://fsome.com/v1/data"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json"
}

# Example: search contacts
response = requests.post(
    f"{BASE_URL}/searches/contacts",
    headers=headers,
    json={"limit": 25, "query": []}
)
data = response.json()
print(data)

const API_KEY = 'fs_your_api_key_here';
const BASE_URL = 'https://fsome.com/v1/data';

// Using fetch (Node 18+ / Browser)
const response = await fetch(`${BASE_URL}/searches/contacts`, {
  method: 'POST',
  headers: {
    'X-API-Key': API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ limit: 25, query: [] })
});
const data = await response.json();
console.log(data);

<?php
$apiKey  = 'fs_your_api_key_here';
$baseUrl = 'https://fsome.com/v1/data';

$payload = json_encode(['limit' => 25, 'query' => []]);

$ch = curl_init("$baseUrl/searches/contacts");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_HTTPHEADER     => [
        "X-API-Key: $apiKey",
        'Content-Type: application/json',
    ],
]);
$body = curl_exec($ch);
curl_close($ch);
$data = json_decode($body, true);
print_r($data);

require 'net/http'
require 'json'

API_KEY  = 'fs_your_api_key_here'
BASE_URL = 'https://fsome.com/v1/data'

uri  = URI("#{BASE_URL}/searches/contacts")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri)
request['X-API-Key']    = API_KEY
request['Content-Type'] = 'application/json'
request.body = { limit: 25, query: [] }.to_json

response = http.request(request)
data     = JSON.parse(response.body)
p data

curl -X POST https://fsome.com/v1/data/searches/contacts \
  -H "X-API-Key: fs_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 25,
    "query": [
      {"field_id": "title",     "value": "VP Sales"},
      {"field_id": "industry",  "value": "Software"},
      {"field_id": "has_email", "value": "true"}
    ]
  }'

import requests

response = requests.post(
    "https://fsome.com/v1/data/searches/contacts",
    headers={"X-API-Key": "fs_your_key"},
    json={
        "limit": 25,
        "query": [
            {"field_id": "title",     "value": "VP Sales"},
            {"field_id": "industry",  "value": "Software"},
            {"field_id": "has_email", "value": "true"},
        ]
    }
)
results = response.json()
for contact in results.get("data", []):
    print(contact["full_name"], contact.get("email"))

const res = await fetch('https://fsome.com/v1/data/searches/contacts', {
  method: 'POST',
  headers: { 'X-API-Key': 'fs_your_key', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    limit: 25,
    query: [
      { field_id: 'title',     value: 'VP Sales' },
      { field_id: 'industry',  value: 'Software' },
      { field_id: 'has_email', value: 'true' },
    ]
  })
});
const { data, count } = await res.json();
console.log(`Found ${count} contacts`);
data.forEach(c => console.log(c.full_name, c.email));

<?php
$payload = json_encode([
    'limit' => 25,
    'query' => [
        ['field_id' => 'title',     'value' => 'VP Sales'],
        ['field_id' => 'industry',  'value' => 'Software'],
        ['field_id' => 'has_email', 'value' => 'true'],
    ],
]);

$ch = curl_init('https://fsome.com/v1/data/searches/contacts');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_HTTPHEADER     => ['X-API-Key: fs_your_key', 'Content-Type: application/json'],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

foreach ($data['data'] as $contact) {
    echo $contact['full_name'] . ' <' . $contact['email'] . ">\n";
}

require 'net/http'; require 'json'

uri = URI('https://fsome.com/v1/data/searches/contacts')
http = Net::HTTP.new(uri.host, uri.port); http.use_ssl = true

req = Net::HTTP::Post.new(uri, 'X-API-Key' => 'fs_your_key', 'Content-Type' => 'application/json')
req.body = {
  limit: 25,
  query: [
    { field_id: 'title',     value: 'VP Sales' },
    { field_id: 'industry',  value: 'Software' },
    { field_id: 'has_email', value: 'true' },
  ]
}.to_json

result = JSON.parse(http.request(req).body)
result['data'].each { |c| puts "#{c['full_name']} <#{c['email']}>" }

curl -X POST https://fsome.com/v1/data/searches/organizations \
  -H "X-API-Key: fs_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 50,
    "query": [
      {"field_id": "industry",         "value": "Artificial Intelligence"},
      {"field_id": "num_employees_min", "value": "51"},
      {"field_id": "operating_status",  "value": "active"}
    ]
  }'

import requests

response = requests.post(
    "https://fsome.com/v1/data/searches/organizations",
    headers={"X-API-Key": "fs_your_key"},
    json={
        "limit": 50,
        "query": [
            {"field_id": "industry",         "value": "Artificial Intelligence"},
            {"field_id": "num_employees_min", "value": "51"},
            {"field_id": "operating_status",  "value": "active"},
        ]
    }
)
for org in response.json().get("data", []):
    print(org["name"], org.get("headquarters_location"))

const res = await fetch('https://fsome.com/v1/data/searches/organizations', {
  method: 'POST',
  headers: { 'X-API-Key': 'fs_your_key', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    limit: 50,
    query: [
      { field_id: 'industry',         value: 'Artificial Intelligence' },
      { field_id: 'num_employees_min', value: '51' },
      { field_id: 'operating_status',  value: 'active' },
    ]
  })
});
const { data } = await res.json();
data.forEach(o => console.log(o.name, o.headquarters_location));

<?php
$ch = curl_init('https://fsome.com/v1/data/searches/organizations');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode([
        'limit' => 50,
        'query' => [
            ['field_id' => 'industry',         'value' => 'Artificial Intelligence'],
            ['field_id' => 'num_employees_min', 'value' => '51'],
            ['field_id' => 'operating_status',  'value' => 'active'],
        ],
    ]),
    CURLOPT_HTTPHEADER => ['X-API-Key: fs_your_key', 'Content-Type: application/json'],
]);
$data = json_decode(curl_exec($ch), true)['data'];
curl_close($ch);
foreach ($data as $org) echo $org['name'] . "\n";

require 'net/http'; require 'json'

uri = URI('https://fsome.com/v1/data/searches/organizations')
http = Net::HTTP.new(uri.host, uri.port); http.use_ssl = true
req = Net::HTTP::Post.new(uri, 'X-API-Key' => 'fs_your_key', 'Content-Type' => 'application/json')
req.body = {
  limit: 50,
  query: [
    { field_id: 'industry',         value: 'Artificial Intelligence' },
    { field_id: 'num_employees_min', value: '51' },
    { field_id: 'operating_status',  value: 'active' },
  ]
}.to_json
JSON.parse(http.request(req).body)['data'].each { |o| puts o['name'] }