# Devicespecifications — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and browse mobile device specifications across all brands and models, then access detailed specs for any device you're interested in. Compare features, technical details, and find exactly the phone or tablet information you need.

**Category:** Other | **Website:** [devicespecifications.com/](https://devicespecifications.com/) | **Docs:** [parse.bot/marketplace/c4669992-bd7a-428f-9a9b-16fb842a7e36/devicespecifications-com-api](https://parse.bot/marketplace/c4669992-bd7a-428f-9a9b-16fb842a7e36/devicespecifications-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-devicespecifications-com-api-c4669992/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_brand_devices

Retrieve all device models for a specific brand. Returns the complete device list for the given brand_id. Each device includes its hex model identifier for use with get_device_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand_id` | string | Yes | The unique hex identifier for the brand, obtained from the get_brands endpoint. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-devicespecifications-com-api-c4669992/get_brand_devices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand_id":"<string>"}'
```

### get_brands

Retrieve all mobile device brands listed on the site. Each brand includes a hex identifier that can be used with other endpoints to fetch its devices. No parameters required; always returns the complete brand catalog.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-devicespecifications-com-api-c4669992/get_brands \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_device_details

Retrieve detailed specifications for a specific mobile device. Returns comprehensive hardware and software specs organized by category (Design, Display, Battery, Camera, Networks, etc.). The model_id is obtained from get_brand_devices or search_devices.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `model_id` | string | Yes | The unique hex identifier for the device model, obtained from the get_brand_devices or search_devices endpoints. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-devicespecifications-com-api-c4669992/get_device_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model_id":"<string>"}'
```

### search_devices

Search for devices using hardware specification filters. All filter parameters are optional; omitting all filters returns the most recent devices. Returns up to 60 matching devices per query. Useful for finding devices that meet specific hardware criteria like 5G support, RAM capacity, or SoC manufacturer.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `5g` | string | No | Filter by 5G support. '1' to require 5G, '-' for no filter. |
| `battery` | string | No | Minimum battery capacity filter value in mAh. '-' for no filter. |
| `ram` | string | No | RAM capacity filter value in GB (e.g., '8', '12', '16'). '-' for no filter. |
| `select_soc` | string | No | System on Chip manufacturer filter. '-' for no filter. |
| `storage` | string | No | Internal storage filter value in GB (e.g., '128', '256', '512'). '-' for no filter. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-devicespecifications-com-api-c4669992/search_devices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"5g":"<string>","battery":"<string>","ram":"<string>","select_soc":"<string>","storage":"<string>"}'
```