Home · Docs · Code samples

Code samples for every working endpoint

54 of the 145 catalog endpoints were verified returning real data, each with a runnable sample in cURL, JavaScript, Python, PHP, Go and Ruby. The inputs are the ones the sweep sends. Checked 19 November 2026; the live state of every endpoint is on the status page.

Replace YOUR_API_KEY with your own key; nothing here is a real key. Every call is authenticated with a Bearer header. The same samples are inside the OpenAPI 3.1 spec as x-codeSamples, and the list is in llms.txt. Credit cost per call: tool catalog; plans: pricing.

analyze influencer

POST /v1/analyze_influencer

Analyze a creator's influence (reach, engagement, audience quality, safety).

curl -X POST 'https://api.foxapis.com/v1/analyze_influencer' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handle":"jack","platform":"twitter"}'

bulk candidate compare

POST /v1/bulk_candidate_compare

Run several candidate comparisons in one call (e.g.

curl -X POST 'https://api.foxapis.com/v1/bulk_candidate_compare' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sets":[[{"name":"Patrick Collison"},{"name":"John Collison"}]]}'

candidate compare

POST /v1/candidate_compare

Compare 2-10 candidates side by side against a role brief, on sourced evidence, for outreach and interview prep.

curl -X POST 'https://api.foxapis.com/v1/candidate_compare' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"candidates":[{"name":"Patrick Collison"},{"name":"John Collison"}]}'

candidate evaluate

POST /v1/candidate_evaluate

Evaluate a candidate against a role.

curl -X POST 'https://api.foxapis.com/v1/candidate_evaluate' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"candidateName":"Patrick Collison","company":"Stripe"}'

companies

GET /v1/companies/{company_number}

A single company's registry record plus its persons of significant control (up to 100, ceased ones last).

curl 'https://api.foxapis.com/v1/companies/00000006' \
  -H "Authorization: Bearer YOUR_API_KEY"

compare people

POST /v1/compare_people

Rank 2+ people side by side.

curl -X POST 'https://api.foxapis.com/v1/compare_people' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subjects":[{"name":"Patrick Collison","company":"Stripe"},{"name":"John Collison","company":"Stripe"}]}'

compare subjects

POST /v1/compare_subjects

Compare 2-10 real people/subjects side by side on sourced evidence, context-aware.

curl -X POST 'https://api.foxapis.com/v1/compare_subjects' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subjects":[{"name":"Patrick Collison","company":"Stripe"},{"name":"John Collison","company":"Stripe"}]}'

content

POST /v1/content/youtube/video

YouTube video — title, views, likes, duration, tags, chapters.

curl -X POST 'https://api.foxapis.com/v1/content/youtube/video' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=jNQXAC9IVRw"}'

POST /v1/content/youtube/channel

YouTube channel stats.

curl -X POST 'https://api.foxapis.com/v1/content/youtube/channel' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/@YouTube"}'

POST /v1/content/substack/post

Substack post — title, likes, comments, paywall status, author.

curl -X POST 'https://api.foxapis.com/v1/content/substack/post' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.lennysnewsletter.com/p/how-to-build-product-sense"}'

POST /v1/content/podcast/episode

Podcast episode — title, show, duration, date, transcript availability.

curl -X POST 'https://api.foxapis.com/v1/content/podcast/episode' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://podcasts.apple.com/us/podcast/the-daily/id1200361736"}'

POST /v1/content/substack/publication

Substack publication — name, subscriber count, category.

curl -X POST 'https://api.foxapis.com/v1/content/substack/publication' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.lennysnewsletter.com/"}'

POST /v1/content/steam/game

Steam game / app details.

curl -X POST 'https://api.foxapis.com/v1/content/steam/game' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://store.steampowered.com/app/620/Portal_2/"}'

POST /v1/content/academic/paper

Academic paper — title, abstract, citation count, authors, PDF link.

curl -X POST 'https://api.foxapis.com/v1/content/academic/paper' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://arxiv.org/abs/1706.03762"}'

crypto

POST /v1/crypto/coingecko/coin

CoinGecko coin data.

curl -X POST 'https://api.foxapis.com/v1/crypto/coingecko/coin' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"coin_id":"bitcoin"}'

POST /v1/crypto/defillama/protocol

Defillama Protocol.

curl -X POST 'https://api.foxapis.com/v1/crypto/defillama/protocol' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"protocol":"aave"}'

developer

POST /v1/developer/github/repo

GitHub repo — stars, forks, topics, language, issues.

curl -X POST 'https://api.foxapis.com/v1/developer/github/repo' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://github.com/torvalds/linux"}'

POST /v1/developer/github/user

GitHub user profile.

curl -X POST 'https://api.foxapis.com/v1/developer/github/user' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_id":"torvalds"}'

POST /v1/developer/stackoverflow/question

Stack Overflow — score, views, tags, accepted status.

curl -X POST 'https://api.foxapis.com/v1/developer/stackoverflow/question' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://stackoverflow.com/questions/11227809/why-is-processing-a-sorted-array-faster-than-processing-an-unsorted-array"}'

POST /v1/developer/stackoverflow/user

Stack Overflow user profile.

curl -X POST 'https://api.foxapis.com/v1/developer/stackoverflow/user' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_id":"22656"}'

POST /v1/developer/hackernews/post

Hacker News post — score, comments, type.

curl -X POST 'https://api.foxapis.com/v1/developer/hackernews/post' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://news.ycombinator.com/item?id=8863"}'

POST /v1/developer/hackernews/comments

Fetch top-level HN comments for a post.

curl -X POST 'https://api.foxapis.com/v1/developer/hackernews/comments' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://news.ycombinator.com/item?id=8863"}'

POST /v1/developer/huggingface/model

HuggingFace model stats.

curl -X POST 'https://api.foxapis.com/v1/developer/huggingface/model' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model_id":"bert-base-uncased"}'

POST /v1/developer/github/search

GitHub search — find repos/code/issues mentioning a term.

curl -X POST 'https://api.foxapis.com/v1/developer/github/search' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"web scraping api","search_type":"repositories"}'

ecommerce

POST /v1/ecommerce/shopify/store

Shopify store product catalog.

curl -X POST 'https://api.foxapis.com/v1/ecommerce/shopify/store' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"allbirds.com"}'

enrich person

POST /v1/enrich_person

Resolve a person to verified contact info and identity.

curl -X POST 'https://api.foxapis.com/v1/enrich_person' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Patrick Collison","company":"Stripe"}'

exec compare

POST /v1/exec_compare

Compare 2-10 executives in an executive (leadership / competitor-exec) frame, on sourced evidence.

curl -X POST 'https://api.foxapis.com/v1/exec_compare' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"executives":[{"name":"Patrick Collison","company":"Stripe"},{"name":"John Collison","company":"Stripe"}]}'

extract

POST /v1/extract

Structured content extraction — YouTube transcripts, Reddit threads, article text.

curl -X POST 'https://api.foxapis.com/v1/extract' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

gaming

POST /v1/gaming/chess/player

Chess.com player stats.

curl -X POST 'https://api.foxapis.com/v1/gaming/chess/player' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"hikaru"}'

POST /v1/gaming/lichess/player

Lichess player stats.

curl -X POST 'https://api.foxapis.com/v1/gaming/lichess/player' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"DrNykterstein"}'

generate sales dossier

POST /v1/generate_sales_dossier

Generate a per-company sales dossier from a domain.

curl -X POST 'https://api.foxapis.com/v1/generate_sales_dossier' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ad_hoc_domain":"stripe.com"}'

geo

POST /v1/geo/check

AI visibility score — checks if ChatGPT, Claude, Gemini, DeepSeek, Mistral recommend this brand.

curl -X POST 'https://api.foxapis.com/v1/geo/check' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"stripe.com"}'

get dossier

POST /v1/get_dossier

Full sourced person dossier — identity, history, affiliations, red flags.

curl -X POST 'https://api.foxapis.com/v1/get_dossier' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Patrick Collison","company":"Stripe"}'

get investor report

POST /v1/get_investor_report

Snapshot OSINT report on an investor.

curl -X POST 'https://api.foxapis.com/v1/get_investor_report' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Marc Andreessen","firm":"Andreessen Horowitz"}'

launch

GET /v1/launch/release_history

The latest releases, the cadence (median days between releases, releases in the last 90 and 365 days), weekly streaks and one plain sentence, read live from Git.

curl 'https://api.foxapis.com/v1/launch/release_history?repo=psf%2Frequests' \
  -H "Authorization: Bearer YOUR_API_KEY"

POST /v1/launch/release_history

Same as the GET form, with the repo in the body: {"repo": "owner/name"}.

curl -X POST 'https://api.foxapis.com/v1/launch/release_history' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"repo":"psf/requests"}'

mobile

POST /v1/mobile/appstore/app

Apple App Store app details.

curl -X POST 'https://api.foxapis.com/v1/mobile/appstore/app' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://apps.apple.com/us/app/instagram/id389801252"}'

POST /v1/mobile/googleplay/app

Google Play Store app details.

curl -X POST 'https://api.foxapis.com/v1/mobile/googleplay/app' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://play.google.com/store/apps/details?id=com.instagram.android"}'

music

POST /v1/music/soundcloud/artist

SoundCloud artist/user stats.

curl -X POST 'https://api.foxapis.com/v1/music/soundcloud/artist' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"artist":"flume"}'

POST /v1/music/lastfm/artist

Last.fm artist stats.

curl -X POST 'https://api.foxapis.com/v1/music/lastfm/artist' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"artist":"Radiohead"}'

science

POST /v1/science/pubmed/search

Pubmed Search.

curl -X POST 'https://api.foxapis.com/v1/science/pubmed/search' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"crispr","max_results":3}'

POST /v1/science/clinicaltrials/search

Clinicaltrials Search.

curl -X POST 'https://api.foxapis.com/v1/science/clinicaltrials/search' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"condition":"asthma","max_results":3}'

POST /v1/science/fda/approvals

Fda Approvals.

curl -X POST 'https://api.foxapis.com/v1/science/fda/approvals' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"aspirin","max_results":3}'

POST /v1/science/biorxiv/preprints

Biorxiv Preprints.

curl -X POST 'https://api.foxapis.com/v1/science/biorxiv/preprints' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"protein folding","max_results":3}'

score intent

POST /v1/score_intent

Score the buyer intent of a social post.

curl -X POST 'https://api.foxapis.com/v1/score_intent' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"We are looking for a better way to track our competitors and would pay for a good tool","platform":"reddit"}'

social

POST /v1/social/twitch/channel

Twitch channel stats.

curl -X POST 'https://api.foxapis.com/v1/social/twitch/channel' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channel":"twitch"}'

POST /v1/social/mastodon/post

Mastodon toot via ActivityPub — favourites, boosts, media.

curl -X POST 'https://api.foxapis.com/v1/social/mastodon/post' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://mastodon.social/@Gargron/1"}'

POST /v1/social/twitter/post

Extract X/Twitter post — text, author, engagement counts.

curl -X POST 'https://api.foxapis.com/v1/social/twitter/post' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://x.com/jack/status/20"}'

POST /v1/social/bluesky/post

Bluesky post via AT Protocol — likes, reposts, replies, author.

curl -X POST 'https://api.foxapis.com/v1/social/bluesky/post' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://bsky.app/profile/bsky.app/post/3jt4tdtbu7p2h"}'

talent

POST /v1/talent/linkedin/job

LinkedIn job posting — vision recommended for full description.

curl -X POST 'https://api.foxapis.com/v1/talent/linkedin/job' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.linkedin.com/jobs/view/3800000000"}'

util

POST /v1/util/smart-extract

Universal smart extract — detects platform, routes to best extractor.

curl -X POST 'https://api.foxapis.com/v1/util/smart-extract' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

vet person

POST /v1/vet_person

Check a person's stated claims against the public registers that settle them.

curl -X POST 'https://api.foxapis.com/v1/vet_person' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Patrick Collison","company":"Stripe"}'

visual

POST /v1/visual/pinterest/pin

Pinterest pin — description, image URL, board context.

curl -X POST 'https://api.foxapis.com/v1/visual/pinterest/pin' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.pinterest.com/pin/99360735500167749/"}'

Temporarily unavailable

A real call on 19 November 2026 came back empty or with an error, so no sample is shown. They stay in the spec, marked, and are re-checked every night.