> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://api-docs.appeared.in/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://api-docs.appeared.in/_mcp/server.

# List Sponsors

GET https://platform.appeared.in/api/public/v1/sponsors

Use this endpoint to retrieve sponsors from Appeared.in.

The easiest way to build a filtered request is from the Sponsors page in the [Appeared.in platform](https://app.appeared.in/sponsors):

1. Open the Sponsors page.
2. Apply the filters you want, such as niche, tags, industries, or lookalikes.
3. Click the  options button in Filters, then click `Get API URL`.
4. This will copy the generated Public API URL. Use it in your request.

The generated URL includes your current filters as query parameters. When you call that URL with your API token, the same filters are applied automatically.

To test the copied URL, paste the full Public API URL into the [Test API URL](/welcome/test-api-url) page.

To find sponsors that were newly added to Appeared.in in your niche, use the first seen date filters.

For example, if you want sponsors first seen yesterday, set `first_seen_start_date` and `first_seen_end_date` to yesterday's date. You can combine these date filters with other filters like `categories` and `topics`.

Example filtered request:

```bash
https://platform.appeared.in/api/public/v1/sponsors?limit=50&categories=b2b&topics=AI%2CTechnology&first_seen_start_date=2026-06-24&first_seen_end_date=2026-06-25
```

Reference: https://api-docs.appeared.in/api-reference/sponsors/retrieve

## Authentication

- `Authorization` header (bearer token, required) — Enter your Appeared.in Public API token. Tokens start with `lh_`; paste the full token without adding `Bearer`.

## Response

### 200

List response

## Errors

### 403 Forbidden Error

Public API is not enabled for this organization

- `any`

## Examples

**Response**

```json
{
  "data": [
    {
      "id": "3589eeb4-5f9d-4f07-8a43-8f9fff079853",
      "name": "01Living",
      "industry": "Retail",
      "slug": "01living",
      "company_type": "self-owned",
      "description": "01Living offers premium teaware and tea display products for retailers and tea lovers, focusing on sustainable, design-forward items crafted to elevate retail spaces and gifting experiences. The catalog includes all teaware, display products, and wbottle accessories, with a retail and wholesale orientation across geographic regions mentioned on the site. The brand emphasizes modern tea culture and quality craftsmanship for tea enthusiasts and professional shops.",
      "employee_count": "1-10",
      "founded": 2015,
      "revenue": null,
      "most_recent_newsletter_feature": "House Outlook",
      "most_common_newsletter_feature": "House Outlook",
      "socials": {
        "web_url": "https://01living.com",
        "linkedin_url": "https://www.linkedin.com/company/01living"
      },
      "location": {
        "country": "Australia",
        "state": null,
        "city": null
      },
      "last_seen_date": "2026-04-20",
      "first_seen_date": "2026-04-20",
      "status": "active"
    },
    {
      "id": "467f67bb-9d34-4ad0-8cdb-0bfdc0bb8305",
      "name": "1440",
      "industry": "Business Services",
      "slug": "1440",
      "company_type": "private",
      "description": "1440 is a knowledge-driven company that offers a daily digest newsletter aimed at intellectually curious individuals. With over 3.6 million subscribers, it curates facts-driven information from more than 100 sources across various topics including culture, science, sports, politics, and business, all presented in a concise five-minute read.",
      "employee_count": "51-200",
      "founded": 2017,
      "revenue": "1m-10m",
      "most_recent_newsletter_feature": "Quartz Washington",
      "most_common_newsletter_feature": "Geopolitics Daily",
      "socials": {
        "web_url": "https://join1440.com",
        "linkedin_url": "https://www.linkedin.com/company/join1440media"
      },
      "location": {
        "country": "United States",
        "state": "Illinois",
        "city": "Chicago"
      },
      "last_seen_date": "2026-06-25",
      "first_seen_date": "2025-07-25",
      "status": "trending"
    }
  ],
  "meta": {
    "total": 100,
    "per_page": 50,
    "current_page": 1,
    "last_page": 2
  },
  "links": {
    "first": "https://platform.appeared.in/api/public/v1/sponsors?page=1",
    "last": "https://platform.appeared.in/api/public/v1/sponsors?page=2",
    "prev": null,
    "next": "https://platform.appeared.in/api/public/v1/sponsors?page=2"
  }
}
```

**SDK Code**

```python Sponsors list example
import requests

url = "https://platform.appeared.in/api/public/v1/sponsors"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript Sponsors list example
const url = 'https://platform.appeared.in/api/public/v1/sponsors';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Sponsors list example
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://platform.appeared.in/api/public/v1/sponsors"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Sponsors list example
require 'uri'
require 'net/http'

url = URI("https://platform.appeared.in/api/public/v1/sponsors")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java Sponsors list example
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://platform.appeared.in/api/public/v1/sponsors")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php Sponsors list example
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://platform.appeared.in/api/public/v1/sponsors', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();
```

```csharp Sponsors list example
using RestSharp;

var client = new RestClient("https://platform.appeared.in/api/public/v1/sponsors");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift Sponsors list example
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://platform.appeared.in/api/public/v1/sponsors")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```