# Journalranking — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 the complete 2024 Academic Journal Guide rankings across 1,635 journals, filtering by field, keyword, and ranking level to find the right publication for your research. Instantly access all journal entries or run targeted searches to discover journals that match your specific needs.

**Category:** Education | **Website:** [journalranking.org/](https://journalranking.org/) | **Docs:** [parse.bot/marketplace/27f146a1-1afa-421f-93d8-5bbee31ca80e/journalranking-org-api](https://parse.bot/marketplace/27f146a1-1afa-421f-93d8-5bbee31ca80e/journalranking-org-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/journalranking/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get all entries

Retrieve all 1,635 entries in the ABS Journal Ranking 2024 database. Each entry includes ISSN, field of study, journal title, publisher, and AJG rankings for 2024, 2021, and 2018.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/journalranking/get-all-entries \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search entries

Search and filter ABS Journal Ranking entries by keyword, field of study, and/or AJG 2024 ranking level. Returns paginated results. The keyword search matches against journal title, publisher, and ISSN.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `field` | string | No | Filter by field of study. Accepts exactly one of: ACCOUNT, BUS HIST & ECON HIST, ECON, ENT-SBM, ETHICS-CSR-MAN, FINANCE, HRM&EMP, IB&AREA, INFO MAN, INNOV, MDEV&EDU, MKT, OPS&TECH, OR&MANSCI, ORG STUD, PSYCH (GENERAL), PSYCH (WOP-OB), PUB SEC, REGIONAL STUDIES, PLANNING AND ENVIRONMENT, SECTOR, SOC SCI, STRAT. |
| `limit` | integer | No | Number of results per page, between 1 and 1000. |
| `page` | integer | No | Page number for pagination (1-based). |
| `query` | string | No | Search keyword to match against journal title, publisher, or ISSN (case-insensitive). |
| `ranking` | string | No | Filter by AJG 2024 ranking level. Accepts exactly one of: 1, 2, 3, 4, 4*. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/journalranking/search-entries \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"field":"<string>","limit":"<integer>","page":"<integer>","query":"<string>","ranking":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.