Code Examples

Practical examples for integrating AIDP into your applications.

Available Examples

Search Integration

Learn how to implement business search in your application.

Topics Covered:

• Basic search implementation

• Location-based search

• Autocomplete search

• Search with filters

• Pagination

• Error handling

Languages:

• TypeScript/JavaScript

• Python

• Vanilla JavaScript

---

Analytics Integration

Learn how to display and analyze business performance data.

Topics Covered:

• Upstream metrics dashboard

• Intent journey visualization

• Competitive benchmarking

• Attribution tracking

• Real-time updates

Languages:

• TypeScript/JavaScript

• Python

• React components

---

Quick Start Examples

Simple Search (TypeScript)

import { AIDPClient } from '@aidp/sdk';

const client = new AIDPClient({
  apiKey: process.env.AIDP_API_KEY,
});

async function searchBusinesses(query: string) {
  const results = await client.search({
    query,
    location: { lat: 45.5231, lon: -122.6765, distance: '5km' },
  });

  return results.data.businesses;
}

// Usage
const businesses = await searchBusinesses('coffee shops');
console.log(businesses);

Simple Search (Python)

from aidp import AIDPClient
import os

client = AIDPClient(api_key=os.environ['AIDP_API_KEY'])

def search_businesses(query: str):
    results = client.search(
        query=query,
        location={'lat': 45.5231, 'lon': -122.6765, 'distance': '5km'}
    )
    return results.data.businesses

# Usage
businesses = search_businesses('coffee shops')
print(businesses)

Simple Analytics (TypeScript)

import { AIDPClient } from '@aidp/sdk';

const client = new AIDPClient({
  apiKey: process.env.AIDP_API_KEY,
});

async function getUpstreamMetrics(businessId: string) {
  const metrics = await client.analytics.upstream({
    businessId,
    startDate: '2024-01-01',
    endDate: '2024-12-31',
  });

  return {
    impressions: metrics.data.totalImpressions,
    citations: metrics.data.totalCitations,
    citationRate: metrics.data.citationRate,
  };
}

// Usage
const metrics = await getUpstreamMetrics('biz_abc123');
console.log(`Impressions: ${metrics.impressions}`);
console.log(`Citation Rate: ${metrics.citationRate}%`);

---

Example Projects

Full-Stack Search Application

A complete example showing:

• Next.js frontend with search UI

• API routes for backend integration

• TypeScript throughout

• Error handling and loading states

View Example →

Analytics Dashboard

A complete analytics dashboard showing:

• React components for data visualization

• Chart.js integration

• Real-time data updates

• Responsive design

View Example →

---

Common Patterns

Error Handling

async function safeSearch(query: string) {
  try {
    const results = await client.search({ query });
    return { success: true, data: results.data };
  } catch (error) {
    if (error.code === 'RATE_LIMIT_EXCEEDED') {
      return { success: false, error: 'Too many requests. Please try again later.' };
    } else if (error.code === 'VALIDATION_ERROR') {
      return { success: false, error: 'Invalid search parameters.' };
    } else {
      return { success: false, error: 'An error occurred. Please try again.' };
    }
  }
}

Caching

const cache = new Map<string, { data: any; timestamp: number }>();
const CACHE_TTL = 5 * 60 * 1000; // 5 minutes

async function cachedSearch(query: string) {
  const cached = cache.get(query);

  if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
    return cached.data;
  }

  const results = await client.search({ query });
  cache.set(query, { data: results.data, timestamp: Date.now() });

  return results.data;
}

Pagination

async function getAllResults(query: string) {
  const allBusinesses = [];
  let offset = 0;
  const limit = 50;

  while (true) {
    const response = await client.search({ query, limit, offset });
    allBusinesses.push(...response.data.businesses);

    if (!response.data.pagination.hasMore) break;
    offset += limit;
  }

  return allBusinesses;
}

---

Testing Examples

Unit Testing

import { AIDPClient } from '@aidp/sdk';
import { jest } from '@jest/globals';

describe('Search Integration', () => {
  let client: AIDPClient;

  beforeEach(() => {
    client = new AIDPClient({ apiKey: 'test_key' });
  });

  it('should return businesses for valid query', async () => {
    const results = await client.search({ query: 'coffee' });
    expect(results.success).toBe(true);
    expect(results.data.businesses).toBeInstanceOf(Array);
  });

  it('should handle rate limiting', async () => {
    // Mock rate limit response
    jest.spyOn(client, 'search').mockRejectedValue({
      code: 'RATE_LIMIT_EXCEEDED',
      retryAfter: 60,
    });

    await expect(client.search({ query: 'coffee' })).rejects.toMatchObject({
      code: 'RATE_LIMIT_EXCEEDED',
    });
  });
});

---

Need Help?

• 📧 Email: [e-mail]

• 💬 GitHub Discussions: github.com/aidp/platform/discussions

• 📚 Full Documentation: docs.aidp.dev

• 🐛 Report Issues: github.com/aidp/examples/issues