Build with the AskVenda API

curl -H "X-Api-Key: askv_YOUR_KEY" \
  "https://askvenda.com.ng/api/v1/vendors?q=tailor&per_page=3"

const KEY = process.env.ASKVENDA_KEY; // never commit keys

const res = await fetch(
  'https://askvenda.com.ng/api/v1/vendors?q=tailor&per_page=3',
  { headers: { 'X-Api-Key': KEY, 'Accept': 'application/json' } }
);
if (!res.ok) {
  throw new Error('HTTP ' + res.status); // 401 bad key, 429 slow down
}
const { data, meta } = await res.json();
console.log(`page ${meta.page}/${meta.last_page}, ${meta.total} total`);
data.forEach((v) => console.log(v.business_name, '-', v.masked_phone));

$key = getenv('ASKVENDA_KEY'); // never commit keys

$ch = curl_init('https://askvenda.com.ng/api/v1/vendors?q=tailor&per_page=3');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 15,
    CURLOPT_HTTPHEADER => ['X-Api-Key: ' . $key, 'Accept: application/json'],
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status !== 200) {
    throw new RuntimeException('API HTTP ' . $status); // 401 bad key, 429 slow down
}
$payload = json_decode((string) $body, true);
foreach ($payload['data'] as $v) {
    echo $v['business_name'] . ' - ' . $v['masked_phone'] . PHP_EOL;
}

import os
import requests

KEY = os.environ['ASKVENDA_KEY']  # never commit keys

resp = requests.get(
    'https://askvenda.com.ng/api/v1/vendors',
    params={'q': 'tailor', 'per_page': 3},
    headers={'X-Api-Key': KEY, 'Accept': 'application/json'},
    timeout=15,
)
resp.raise_for_status()  # 401 bad key, 429 slow down
payload = resp.json()
print(f"page {payload['meta']['page']}/{payload['meta']['last_page']}")
for v in payload['data']:
    print(v['business_name'], '-', v['masked_phone'])

import { useEffect, useState } from 'react';

const API = 'https://askvenda.com.ng/api/v1';
const KEY = process.env.REACT_APP_ASKVENDA_KEY; // never commit keys

export function VendorList({ query }) {
  const [vendors, setVendors] = useState([]);
  const [error, setError] = useState('');

  useEffect(() => {
    fetch(`${API}/vendors?q=${encodeURIComponent(query)}&per_page=6`, {
      headers: { 'X-Api-Key': KEY, 'Accept': 'application/json' },
    })
      .then((res) => {
        if (!res.ok) { throw new Error('HTTP ' + res.status); }
        return res.json();
      })
      .then((json) => setVendors(json.data || []))
      .catch((err) => setError(String(err.message || err)));
  }, [query]);

  if (error) { return <p>Could not load vendors: {error}</p>; }

  return (
    <ul>
      {vendors.map((v) => (
        <li key={v.id}>
          {v.business_name} - {v.area ? v.area.name : ''} ({v.rating_avg})
        </li>
      ))}
    </ul>
  );
}

curl -H "X-Api-Key: askv_YOUR_KEY" \
  "https://askvenda.com.ng/api/v1/vendors/adebayo-stitches-tanke"

const res = await fetch(
  'https://askvenda.com.ng/api/v1/vendors/adebayo-stitches-tanke',
  { headers: { 'X-Api-Key': KEY, 'Accept': 'application/json' } }
);
if (res.status === 404) {
  console.log('Unknown slug or not approved yet.');
} else if (!res.ok) {
  throw new Error('HTTP ' + res.status);
}
const { data } = await res.json();
console.log(data.business_name, data.category, data.photos.length + ' photos');

$slug = 'adebayo-stitches-tanke';
$ch = curl_init('https://askvenda.com.ng/api/v1/vendors/' . $slug);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 15,
    CURLOPT_HTTPHEADER => ['X-Api-Key: ' . $key, 'Accept: application/json'],
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status === 404) {
    echo "Unknown slug or not approved yet.\n";
} else {
    $vendor = json_decode((string) $body, true)['data'];
    echo $vendor['business_name'] . ' - ' . count($vendor['photos']) . " photos\n";
}

resp = requests.get(
    'https://askvenda.com.ng/api/v1/vendors/adebayo-stitches-tanke',
    headers={'X-Api-Key': KEY, 'Accept': 'application/json'},
    timeout=15,
)
if resp.status_code == 404:
    print('Unknown slug or not approved yet.')
else:
    resp.raise_for_status()
    vendor = resp.json()['data']
    print(vendor['business_name'], '-', len(vendor['photos']), 'photos')

export function VendorCard({ slug }) {
  const [vendor, setVendor] = useState(null);

  useEffect(() => {
    fetch(`${API}/vendors/${slug}`, {
      headers: { 'X-Api-Key': KEY, 'Accept': 'application/json' },
    })
      .then((res) => (res.ok ? res.json() : null))
      .then((json) => setVendor(json ? json.data : null))
      .catch(() => setVendor(null));
  }, [slug]);

  if (!vendor) { return <p>Loading vendor...</p>; }

  return (
    <article>
      <h3>{vendor.business_name}</h3>
      <p>{vendor.masked_phone} - {vendor.rating_avg} ({vendor.rating_count})</p>
      <a href={vendor.profile_url}>View on AskVenda</a>
    </article>
  );
}