Skip to content

For AI agents

Official channels (X, LinkedIn, YouTube, GitHub, Facebook, Instagram, TikTok, Threads, Bluesky, Mastodon, Hugging Face, Discord, community, Reddit, blog, newsletter, RSS, status, docs, careers) of every company in the companies.fru.dev registry, each verified against the company's own website or a back-link, with the evidence URL and the date checked.

Every company re-checked about once a month (a 28th of them daily at 04:40 UTC); the registry is synced daily and new registry companies are added and checked first, so the set grows with the registry

Point your agent here

Call the API

  • GET /api/companiessince?, channel?, verified?, limit?, offset?companies with slug (companies.fru.dev slug), name, domain, category, page URL, check date and state, x_url / linkedin_url / github_url / youtube_url (verified only, else empty), every link with channel, url, handle, verified, basis, evidence URL and dates, registry_mismatch, and dated items
  • GET /api/companies/{slug}slugthe company with every link, its evidence and dates, the registry mismatches, dated items and its change history
  • GET /api/channelsnonechannels with id, label, kind (social or first-party), description and counts of verified and unverified companies
  • GET /api/changessince?, limit?, offset?changes with time, company slug, channel, change, old and new URL, the page it was seen on, and who (seed, agent, admin)
  • GET /api/searchq, limit?up to 20 ranked results with title, link and one line

GET/api/companies

Companies with their official links, verified or not, plus dated items (for the companies.fru.dev registry)

  • sinceOnly companies checked or changed at or after this date (YYYY-MM-DD)
  • channelOnly companies with a link on this channel
  • verifiedWith channel: only verified links on it. Alone: only companies with at least one verified link
  • limitItems per page, 1 to 200
  • offsetItems to skip, for the next page
Shell
curl -s "https://socials.fru.dev/api/companies?channel=github&verified=1&limit=2"
Sample response
JSON
{
  "companies": [
    {
      "slug": "adobe",
      "name": "Adobe",
      "domain": "adobe.com",
      "category": "Software",
      "url": "https://socials.fru.dev/companies/adobe",
      "registry": "https://companies.fru.dev/companies/adobe",
      "checked": "2026-09-24",
      "check_state": "ok",
      "x_url": "",
      "linkedin_url": "https://www.linkedin.com/company/adobe",
      "github_url": "https://github.com/adobe",
      "youtube_url": "https://www.youtube.com/user/AdobeSystems",
      "verified": 4,
      "links": [
        {
          "channel": "website",
          "url": "https://www.adobe.com",
          "handle": "adobe.com",
          "verified": true,
          "basis": "site",
          "evidence": "https://www.adobe.com/",
          "since": "2026-09-24",
          "checked": "2026-09-24"
        },
        {
          "channel": "x",
          "url": "https://x.com/Adobe",
          "handle": "@Adobe",
          "verified": false,
          "basis": "registry",
          "evidence": "https://companies.fru.dev/companies/adobe",
          "since": "2026-09-24",
          "checked": "2026-09-24"
        }
      ]
    },
    {
      "slug": "ai-engineer",
      "name": "AI Engineer",
      "domain": "ai.engineer",
      "category": "Events and community",
      "url": "https://socials.fru.dev/companies/ai-engineer",
      "registry": "https://companies.fru.dev/companies/ai-engineer",
      "checked": "2026-09-24",
      "check_state": "ok",
      "x_url": "https://x.com/aidotengineer",
      "linkedin_url": "https://www.linkedin.com/company/aidotengineer",
      "github_url": "https://github.com/aiDotEngineer",
      "youtube_url": "https://www.youtube.com/@aiDotEngineer",
      "verified": 4,
      "links": [
        {
          "channel": "website",
          "url": "https://ai.engineer",
          "handle": "ai.engineer",
          "verified": true,
          "basis": "site",
          "evidence": "https://ai.engineer/",
          "since": "2026-09-24",
          "checked": "2026-09-24"
        },
        {
          "channel": "x",
          "url": "https://x.com/aidotengineer",
          "handle": "@aidotengineer",
          "verified": true,
          "basis": "site",
          "evidence": "https://ai.engineer/",
          "since": "2026-09-24",
          "checked": "2026-09-24"
        }
      ]
    }
  ],
  "total": 107,
  "limit": 2,
  "offset": 0,
  "next": "/api/companies?channel=github&verified=1&limit=2&offset=2",
  "note": "verified = the company's own site links it (basis site) or the profile links back to its domain (basis backlink); unverified links come f..."
}

GET/api/companies/{slug}

One company's official links with evidence and history

  • slugThe companies.fru.dev slug, as in /companies/<slug>
Shell
curl -s "https://socials.fru.dev/api/companies/databricks"
Sample response
JSON
{
  "company": {
    "slug": "databricks",
    "name": "Databricks",
    "domain": "databricks.com",
    "category": "Data",
    "url": "https://socials.fru.dev/companies/databricks",
    "registry": "https://companies.fru.dev/companies/databricks",
    "checked": "2026-09-24",
    "check_state": "ok",
    "x_url": "https://x.com/databricks",
    "linkedin_url": "https://www.linkedin.com/company/databricks",
    "github_url": "https://github.com/databricks",
    "youtube_url": "https://www.youtube.com/@Databricks",
    "verified": 9,
    "links": [
      {
        "channel": "website",
        "url": "https://www.databricks.com",
        "handle": "databricks.com",
        "verified": true,
        "basis": "site",
        "evidence": "https://www.databricks.com/",
        "since": "2026-09-24",
        "checked": "2026-09-24"
      },
      {
        "channel": "x",
        "url": "https://x.com/databricks",
        "handle": "@databricks",
        "verified": true,
        "basis": "site",
        "evidence": "https://www.databricks.com/",
        "since": "2026-09-24",
        "checked": "2026-09-24"
      }
    ]
  },
  "note": "verified = the company's own site links it (basis site) or the profile links back to its domain (basis backlink); unverified links come f..."
}

GET/api/channels

The channels tracked and how many companies have a verified link on each

Shell
curl -s "https://socials.fru.dev/api/channels"
Sample response
JSON
{
  "channels": [
    {
      "id": "x",
      "label": "X",
      "kind": "social",
      "description": "Official X (Twitter) accounts",
      "verified": 239,
      "unverified": 69,
      "url": "https://socials.fru.dev/channels/x"
    },
    {
      "id": "linkedin",
      "label": "LinkedIn",
      "kind": "social",
      "description": "Official LinkedIn company pages",
      "verified": 256,
      "unverified": 34,
      "url": "https://socials.fru.dev/channels/linkedin"
    }
  ],
  "companies": 566
}

GET/api/changes

The append-only history: links added, changed (handle renames), verified, unverified and removed, newest first

  • sinceOnly changes at or after this date (YYYY-MM-DD)
  • limitItems per page, 1 to 200
  • offsetItems to skip, for the next page
Shell
curl -s "https://socials.fru.dev/api/changes?limit=3"
Sample response
JSON
{
  "changes": [
    {
      "at": "2026-09-24 23:17:07",
      "company": "zscaler",
      "channel": "careers",
      "change": "added",
      "old": "",
      "new": "https://www.zscaler.com/careers",
      "source": "https://www.zscaler.com/",
      "by": "seed"
    },
    {
      "at": "2026-09-24 23:17:07",
      "company": "zscaler",
      "channel": "blog",
      "change": "added",
      "old": "",
      "new": "https://www.zscaler.com/blogs",
      "source": "https://www.zscaler.com/",
      "by": "seed"
    }
  ],
  "total": 600,
  "limit": 3,
  "offset": 0,
  "next": "/api/changes?limit=3&offset=3",
  "note": "Newest 600 changes; the history is append-only. by = seed marks the first check."
}

Add to your agent

System prompt
For a tech company's official social and community accounts (X, LinkedIn, YouTube, GitHub, Discord, Reddit and more), which of them are verified and the page that proves it, fetch https://socials.fru.dev/llms.txt and use https://socials.fru.dev/api/companies (spec: https://socials.fru.dev/openapi.json). Cite "Socials (socials.fru.dev)" with a link.

Usage terms

  • Free to read, no key needed
  • Cite "Socials (socials.fru.dev)" with a link
  • Responses are cached; every company re-checked about once a month (a 28th of them daily at 04:40 UTC); the registry is synced daily and new registry companies are added and checked first, so the set grows with the registry
  • Keep to 60 requests a minute or fewer
  • verified: false means the link comes from the companies.fru.dev registry and neither the company site nor the profile confirmed it (basis registry), or the site stopped linking it on the last readable check (basis stale).

Handle changes by email

Once a month: companies that renamed, added or dropped an official account. Only when something changed.

Double opt-in. Unsubscribe any time.