OnlyPepes API

Get random Pepe memes programmatically through our API.

Simple

RESTful endpoints with JSON responses for easy integration

Powerful

Search and filter through thousands of cataloged Pepe variations

Reliable

99.9% uptime with built-in health monitoring

Base URL

Production

v2
https://api.onlypepes.com/v2

Development

local

API Endpoints

GET

/pepe

Get a random Pepe meme

Returns a random Pepe meme. Optionally, you can filter by search term.

Query Parameters
Parameter Type Required Description
search string No Search term to filter Pepe memes by description
Example Response 
"data": {
  "id": 123,
  "url": "https://cdn.onlypepes.com/pepe123.jpg",
  "description": "A rare Pepe."
},
"search": {
  "terms": "funny",
  "found": true
}

Example Request

curl -X GET "https://api.onlypepes.com/v2/pepe?search=funny" \
  -H "Accept: application/json"
GET

/pepe/[id]

Get a specific Pepe meme by ID

Returns a Pepe meme by its unique ID.

Path Parameters
Parameter Type Required Description
id integer Yes The unique ID of the Pepe meme
Example Response 
"data": {
  "id": 456,
  "url": "https://cdn.onlypepes.com/pepe456.jpg",
  "description": "Another rare Pepe."
}

Example Request

curl -X GET "https://api.onlypepes.com/v2/pepe/456" \
  -H "Accept: application/json"

Error Responses

The API uses conventional HTTP response codes to indicate the success or failure of an API request.

Code Description Example
200 - OK The request was successful. 
"data": { ... }
400 - Bad Request The request was invalid or cannot be served. 
"error": "Invalid request parameters"
401 - Unauthorized Authentication failed or user doesn't have permissions. 
"error": "Invalid API key"
404 - Not Found The requested resource could not be found. 
"error": "Pepe not found."
429 - Too Many Requests Rate limit exceeded. 
"error": "Rate limit exceeded"
500 - Server Error Something went wrong on our end. 
"error": "Internal Server Error"