API Documentation
Access Farkhondeh data programmatically. All endpoints return JSON and support CORS.
Base URL
https://farkhondeh.vercel.appGET
/api/universities
List all approved universities
Parameters
| Name | Type | Description |
|---|---|---|
| country | string | Filter by country name |
| limit | number | Max results (default: 50, max: 100) |
| offset | number | Pagination offset |
| include | string | Include related data: designs,gems |
Example Request
curl "/api/universities?country=USA&limit=10&include=designs,gems"GET
/api/designs
List t-shirt and logo designs
Parameters
| Name | Type | Description |
|---|---|---|
| university_id | string | Filter by university |
| type | string | Filter by type: tshirt, logo |
| sort | string | Sort by: popular, recent, ai |
| limit | number | Max results (default: 50, max: 100) |
| offset | number | Pagination offset |
Example Request
curl "/api/designs?sort=popular&type=tshirt&limit=20"Open Source
Farkhondeh is designed to be open and community-driven
All university data is contributed by the community. You can use this API to:
- Build your own university discovery apps
- Create data visualizations and analyses
- Integrate university information into your projects
- Contribute to open educational resources