API Documentation

Welcome to the Wired Startups API. Our RESTful API provides programmatic access to startup data, country information, and platform statistics.

Authentication Required

All API endpoints require authentication. You must have a registered account to access our API data. This allows us to maintain service quality and communicate any terms updates directly with our users.

Getting Started

Create an Account: Register here with your email and WhatsApp (for important updates)
Request API Access: Contact us through your account dashboard
Receive API Key: We'll provide your unique API key via email
Start Making Requests: Include your API key in the Authorization header

Available API Endpoints

Core Platform Data

GET/api/countries

Retrieve information about countries in our database, including startup counts and statistics.

Query Parameters:

featured - Filter by featured countries (true/false)
limit - Limit results (max 100)

Response Format:

{
  "status": "success",
  "data": [
    {
      "id": 1,
      "name": "South Africa",
      "slug": "south-africa",
      "flag_emoji": "🇿🇦",
      "capital": "Cape Town",
      "currency": "ZAR",
      "timezone": "SAST",
      "featured": true
    }
  ],
  "meta": {
    "total": 10,
    "endpoint": "/api/countries",
    "version": "1.0"
  }
}

View Documentation

GET/api/startups

Access verified startup information including company details, funding status, and contact information.

Query Parameters:

country - Filter by country slug
industry - Filter by industry
stage - Filter by funding stage (idea, prototype, mvp, growth, scale)
funding_status - Filter by funding status
featured - Filter by featured startups
page - Page number for pagination
limit - Results per page (max 100)

Response Format:

{
  "status": "success",
  "data": [
    {
      "id": 1,
      "name": "Sample Fintech Startup",
      "slug": "sample-fintech-startup",
      "description": "Revolutionary fintech solution...",
      "industry": "Financial Technology",
      "stage": "seed",
      "funding_status": "seed",
      "team_size": 12,
      "website": "https://example.com",
      "city": "Cape Town",
      "country": "South Africa",
      "country_slug": "south-africa",
      "flag_emoji": "🇿🇦",
      "featured": true,
      "created_at": "2024-01-15T10:30:00Z"
    }
  ],
  "meta": {
    "total": 45,
    "page": 1,
    "per_page": 20,
    "total_pages": 3,
    "filters": {
      "country": "south-africa",
      "industry": null,
      "stage": "seed"
    }
  }
}

View Documentation

Interactive Features

POST/api/contact-startup

Send messages to startups through our platform. Requires user authentication.

Request Body:

{
  "startup_id": 1,
  "startup_contact_id": "b83a4f7dc35d33bc",
  "subject": "Partnership Inquiry",
  "message": "We would like to discuss a potential partnership..."
}

Response Format:

{
  "success": true,
  "message": "Message sent successfully! The startup will receive your message.",
  "message_id": 123,
  "daily_messages_remaining": 2
}

Premium Feature

Free accounts: 3 messages per day
Premium accounts: Unlimited messaging
Contact ID required: Each startup has a unique contact ID
Opt-out system: Some startups may not accept messages

Error Responses:

Error Code	Description
`PREMIUM_REQUIRED`	Startup only accepts premium messages
`DAILY_LIMIT_EXCEEDED`	Free account daily message limit reached
`CONTACT_NOT_ALLOWED`	Startup has opted out of messages
`STARTUP_NOT_FOUND`	Invalid startup ID or contact ID

Coming Soon

GET/api/opportunities Coming Soon

Access job opportunities and internship listings from startups and companies.

Planned Parameters:

country - Filter by country
type - Filter by job type (full_time, part_time, contract, internship)
experience - Filter by experience level
remote - Filter remote-friendly positions
salary_min - Minimum salary filter

GET/api/talent Coming Soon

Access talent profiles of professionals seeking opportunities in the startup ecosystem.

Planned Parameters:

skills - Filter by skills and expertise
experience_level - Filter by experience level
country - Filter by location
looking_for_work - Filter actively job-seeking profiles

GET/api/funding Coming Soon

Access funding opportunities including VC funds, grants, and accelerator programs.

Planned Parameters:

funding_type - Filter by type (vc, grant, accelerator, angel)
stage - Filter by funding stage
industry - Filter by focus industry
amount_min - Minimum funding amount

GET/api/funds Coming Soon

Directory of investment funds, VCs, and angel networks actively investing in startups.

Planned Parameters:

fund_type - Filter by fund type
aum_min - Minimum assets under management
investment_stage - Filter by investment focus
industry_focus - Filter by industry specialization

GET/api/events Planned

Startup events, networking meetups, conferences, and workshops across Africa.

Planned Parameters:

country - Filter by country
event_type - Filter by event type
date_from - Filter events from date
date_to - Filter events until date

GET/api/analytics Planned

Platform statistics and analytics for research and insights.

Planned Endpoints:

/api/analytics/countries - Country-specific metrics
/api/analytics/industries - Industry trends and data
/api/analytics/funding-trends - Investment activity data
/api/analytics/job-market - Employment market insights

API Usage & Limits

Rate Limits

Authenticated Users: 100 requests per hour
Premium Plans: 1,000 requests per hour
Enterprise: Custom limits available

Authentication

Session-based: For logged-in users
API Keys: For external applications
Rate limiting: Per user/IP address

API Status: Operational

All systems operational. API uptime: 99.9%

Terms & Support

API Terms

By using our API, you agree to our terms of service. We may update these terms and will notify registered users via email or WhatsApp.

Support

Need help? Contact our support team through your account dashboard or email us for technical assistance.

Quick Links

Create Account Login

Example Requests

Get Countries:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://wiredstartups.com/api/countries

Get Startups by Country:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://wiredstartups.com/api/startups?country=south-africa&limit=10"

Contact a Startup:

curl -X POST \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{"startup_id":1,"subject":"Partnership","message":"Hello!"}' \
     https://wiredstartups.com/api/contact-startup

Recent Updates

v1.0 Initial Release - Countries, Startups, and Contact APIs January 2024
v1.1 Coming Soon - Opportunities, Talent, and Funding APIs Q2 2024