Playground | Social Fetch

Free trial: 3 of 3 test requests left. Get your own API key with 100 free credits. No credit card.

Write a Boolean query from a plain-language description of what to monitor, optionally with example posts it should and shouldn't find, or refine an existing query. The query is written by AI, then read, explained and planned like validate, and run over the example posts. Show it to the user before searching with it. Free.

POST/v1/query/suggesthttps://api.socialfetch.dev/v1/query/suggest

Endpoint

Write a query from a description

/v1/query/suggest

Docs

const response = await fetch(
  "https://api.socialfetch.dev/v1/query/suggest",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-key": "YOUR_API_KEY"
    },
    body: JSON.stringify({
      brief: "Complaints about Lumora Foods: recalls, lawsuits and food poisoning, in English and Spanish. Not job ads.",
      examples: {
        shouldMatch: ["Lumora Foods is recalling its peanut butter after salmonella was found"],
        shouldNotMatch: ["Lumora Foods is hiring drivers in Leeds"]
      },
      languages: ["en","es"],
      platforms: ["twitter","reddit"],
      maxCredits: 30
    })
  }
);

const data = await response.json();
console.log(data);

Free trial: 3 of 3 test requests left. Get your own API key with 100 free credits. No credit card.

Get API key

POST/v1/query/suggesthttps://api.socialfetch.dev/v1/query/suggest

Endpoint

Write a query from a description

/v1/query/suggest

Docs

const response = await fetch(
  "https://api.socialfetch.dev/v1/query/suggest",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-key": "YOUR_API_KEY"
    },
    body: JSON.stringify({
      brief: "Complaints about Lumora Foods: recalls, lawsuits and food poisoning, in English and Spanish. Not job ads.",
      examples: {
        shouldMatch: ["Lumora Foods is recalling its peanut butter after salmonella was found"],
        shouldNotMatch: ["Lumora Foods is hiring drivers in Leeds"]
      },
      languages: ["en","es"],
      platforms: ["twitter","reddit"],
      maxCredits: 30
    })
  }
);

const data = await response.json();
console.log(data);