API Code Examples

// Fetch trending repositories
const response = await fetch('https://vercel.land/api/trending?timeframe=week&limit=10');
const data = await response.json();

console.log(`Found ${data.repositories.length} trending repos`);
data.repositories.forEach(repo => {
  console.log(`${repo.name} - ⭐ ${repo.stars} stars`);
});

// Example response:
// {
//   repositories: [
//     {
//       id: 1,
//       name: "awesome-tool",
//       fullName: "user/awesome-tool",
//       description: "An awesome tool for developers",
//       stars: 15420,
//       language: "TypeScript",
//       url: "https://github.com/user/awesome-tool"
//     },
//     ...
//   ],
//   stats: {
//     totalRepos: 3500,
//     timeframe: "week"
//   }
// }

// Search for React-related repositories
const searchQuery = 'react';
const response = await fetch(`https://vercel.land/api/search?q=${encodeURIComponent(searchQuery)}&type=repos`);
const data = await response.json();

console.log(`Found ${data.repositories.length} repositories`);
data.repositories.forEach(repo => {
  console.log(`${repo.fullName}`);
  console.log(`  Description: ${repo.description}`);
  console.log(`  Stars: ${repo.stars} | Language: ${repo.language}`);
  console.log('---');
});

// Get details for facebook/react
const owner = 'facebook';
const name = 'react';

const response = await fetch(`https://vercel.land/api/repositories/${owner}/${name}`);
const data = await response.json();

console.log(`Repository: ${data.repository.fullName}`);
console.log(`Description: ${data.repository.description}`);
console.log(`Stars: ${data.repository.stars}`);
console.log(`Forks: ${data.repository.forks}`);
console.log(`Language: ${data.repository.language}`);
console.log(`License: ${data.repository.license?.name || 'None'}`);
console.log(`Last updated: ${new Date(data.repository.updatedAt).toLocaleDateString()}`);

// Add repository to favorites (requires authentication)
const repositoryId = 123;

const response = await fetch('https://vercel.land/api/favorites', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    // Session cookie is automatically sent by browser
  },
  body: JSON.stringify({ repositoryId })
});

const data = await response.json();

if (data.success) {
  console.log('✅ Repository added to favorites!');
  console.log('Favorite ID:', data.favorite.id);
} else {
  console.error('❌ Error:', data.error);
}

// Get all categories
const response = await fetch('https://vercel.land/api/categories');
const data = await response.json();

console.log(`Found ${data.categories.length} categories`);
data.categories.forEach(category => {
  console.log(`${category.name} (${category.repositoryCount} repos)`);
  console.log(`  Slug: /awesome/${category.slug}`);
  console.log(`  Description: ${category.description}`);
  console.log('---');
});

// Chat with AI for repository recommendations
const message = "I need a React UI component library";

const response = await fetch('https://vercel.land/api/ai/chat', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ message })
});

const data = await response.json();

console.log('AI Response:', data.response);
console.log('\nRecommended repositories:');
data.repositories?.forEach(repo => {
  console.log(`- ${repo.name}: ${repo.description}`);
});

// Save chat ID for continuing conversation
const chatId = data.chatId;