DEVELOPERS API
API
DOCS
ACCESS COMPANY LOGOS PROGRAMMATICALLY WITH OUR REST API. PERFECT FOR BUILDING INTEGRATIONS, DASHBOARDS, OR DESIGN TOOLS.
01
QUICK START
1
2
MAKE YOUR FIRST REQUEST
Use your API key in the Authorization header.
3
BUILD SOMETHING GREAT
Access logos, search companies, download assets.
EXAMPLE REQUEST
# Search for a company
curl -X GET "https://api.assetpipe.dev/v1/search?q=stripe" \
-H "Authorization: Bearer YOUR_API_KEY" 02
AUTHENTICATION
All API requests require authentication via an API key.
Include your key in the Authorization header as a Bearer token.
KEEP YOUR KEY SECRET
Never expose your API key in client-side code or public repositories.
HEADER
Authorization: Bearer ap_xxxxxxxxxxxxxxxx BASE URL
https://api.assetpipe.dev RATE LIMIT 100 REQ/MIN
FORMAT JSON
RATE LIMIT HEADERS
| HEADER | DESCRIPTION |
|---|---|
X-RateLimit-Limit | Maximum requests per window (100) |
X-RateLimit-Remaining | Requests remaining in current window |
X-RateLimit-Reset | Unix timestamp when window resets |
03
ENDPOINTS
GET
/v1/search Search for companies by name or domain.
QUERY PARAMETERS
| PARAMETER | TYPE | REQUIRED | DESCRIPTION |
|---|---|---|---|
q | string | YES | Search query (min 2 characters) |
page | integer | NO | Page number (default: 1) |
limit | integer | NO | Results per page (default: 20, max: 100) |
EXAMPLE
REQUEST
curl -X GET "https://api.assetpipe.dev/v1/search?q=stripe&limit=5" \
-H "Authorization: Bearer YOUR_API_KEY" RESPONSE
{
"data": [
{
"id": "uuid",
"name": "Stripe",
"slug": "stripe",
"domain": "stripe.com",
"is_verified": true,
"logos": [...]
}
],
"query": "stripe",
"pagination": {
"page": 1,
"limit": 5,
"total": 1,
"has_more": false
}
} GET
/v1/companies List all companies with pagination.
QUERY PARAMETERS
| PARAMETER | TYPE | DESCRIPTION |
|---|---|---|
page | integer | Page number (default: 1) |
limit | integer | Results per page (default: 20, max: 100) |
EXAMPLE
REQUEST
curl -X GET "https://api.assetpipe.dev/v1/companies?page=1&limit=10" \
-H "Authorization: Bearer YOUR_API_KEY" GET
/v1/companies/:slug Get detailed information for a specific company.
PATH PARAMETERS
| PARAMETER | TYPE | DESCRIPTION |
|---|---|---|
slug | string | Company slug (e.g., "stripe", "github") |
EXAMPLE
REQUEST
curl -X GET "https://api.assetpipe.dev/v1/companies/stripe" \
-H "Authorization: Bearer YOUR_API_KEY" RESPONSE
{
"data": {
"id": "uuid",
"name": "Stripe",
"slug": "stripe",
"domain": "stripe.com",
"description": "Online payment processing",
"website_url": "https://stripe.com",
"is_verified": true,
"created_at": "2024-01-01T00:00:00Z",
"updated_at": "2024-01-01T00:00:00Z"
}
} GET
/v1/companies/:slug/logos Get all logo variants for a company.
QUERY PARAMETERS
| PARAMETER | TYPE | DESCRIPTION |
|---|---|---|
format | string | Filter by format: svg or png |
variant | string | Filter by variant: primary, icon, wordmark, etc. |
EXAMPLE
REQUEST
curl -X GET "https://api.assetpipe.dev/v1/companies/stripe/logos?format=svg" \
-H "Authorization: Bearer YOUR_API_KEY" RESPONSE
{
"data": {
"company": {
"id": "uuid",
"name": "Stripe",
"slug": "stripe"
},
"logos": [
{
"id": "uuid",
"format": "svg",
"variant": "primary",
"storage_path": "https://...",
"width": null,
"height": null,
"file_size": 2048,
"created_at": "2024-01-01T00:00:00Z"
}
]
}
} GET
/v1/logos/:id Get metadata for a specific logo by ID.
EXAMPLE
REQUEST
curl -X GET "https://api.assetpipe.dev/v1/logos/uuid" \
-H "Authorization: Bearer YOUR_API_KEY" GET
/v1/logos/:id/download Download a logo file. Returns the raw image with appropriate content headers.
RESPONSE HEADERS
| HEADER | VALUE |
|---|---|
Content-Type | image/svg+xml or image/png |
Content-Disposition | attachment; filename="company-logo.svg" |
EXAMPLE
REQUEST
# Download and save to file
curl -X GET "https://api.assetpipe.dev/v1/logos/uuid/download" \
-H "Authorization: Bearer YOUR_API_KEY" \
-o logo.svg GET
/v1/logos/:id/view View a logo inline. Perfect for embedding in img tags.
EXAMPLE
HTML
<img
src="https://api.assetpipe.dev/v1/logos/uuid/view"
alt="Company Logo"
/> GET
/v1/companies/:slug/brand-kit Get brand kit information including colors, fonts, and guidelines.
EXAMPLE
RESPONSE
{
"data": {
"company": { ... },
"brand_kit": {
"id": "uuid",
"primary_color": "#635BFF",
"secondary_colors": ["#00D4FF"],
"fonts": {
"heading": "Inter",
"body": "Inter"
},
"guidelines_url": "https://stripe.com/brand"
}
}
} 04
ERRORS
All errors follow a consistent format with an error code and human-readable message.
ERROR RESPONSE
{
"error": {
"code": "NOT_FOUND",
"message": "Company 'acme' not found"
}
}ERROR CODES
| CODE | STATUS | DESCRIPTION |
|---|---|---|
INVALID_QUERY | 400 | Invalid or missing query parameters |
UNAUTHORIZED | 401 | Missing or invalid API key |
FORBIDDEN | 403 | API key has been deactivated |
NOT_FOUND | 404 | Resource does not exist |
RATE_LIMITED | 429 | Too many requests - check Retry-After header |
DATABASE_ERROR | 500 | Database query failed |
INTERNAL_ERROR | 500 | Unexpected server error |
05
CONTRIBUTION GUIDELINES
Help us grow the logo library by submitting high-quality assets.
FILE FORMATS
- SVG PREFERRED - Vector format for scalability
- PNG ACCEPTED - Minimum 512x512px resolution
- MAX SIZE: 5MB per file
LOGO VARIANTS
- PRIMARY - Main logo with icon + wordmark
- ICON - Standalone icon/symbol
- WORDMARK - Text-only logo
- HORIZONTAL - Wide format layout
- STACKED - Vertical format layout
COLOR MODES
- FULL COLOR - Original brand colors
- FOR DARK BG - Light version for dark backgrounds
- FOR LIGHT BG - Dark version for light backgrounds
- MONO BLACK - Single color black
- MONO WHITE - Single color white
QUALITY STANDARDS
- OFFICIAL LOGOS ONLY - No recreations or fan art
- TRANSPARENT BACKGROUND - Required for all uploads
- CURRENT VERSION - Up-to-date brand assets
- CLEAN SVG - Optimized, no hidden layers
REVIEW PROCESS
All submissions are reviewed by our team within 24-48 hours. We verify the logo authenticity and quality before publishing.
READY TO CONTRIBUTE? SUBMIT A LOGO →
NEED HELP?
Having trouble with the API or have questions about integration?