# CORE API v2 API

> CORE API v2 API on Apizie: 18 endpoints (Get all near duplicate articles, Batch operation for retrieving articles by CORE ID, Get article by CORE ID, Get fulltext PDF by CORE ID, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/open-data:core-ac-uk/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `open-data:core-ac-uk`
- Category: Open Data
- Status: byok
- Source: https://core.ac.uk
- Page: https://zieapi.vercel.app/api/open-data/core-ac-uk
- OpenAPI: https://zieapi.vercel.app/api/open-data/core-ac-uk/openapi.json

You can use the CORE API to access the resources harvested and enriched by CORE. If you encounter any problems with the API, please report them to us . Overview The API is organised by resource type. The resources are…

## Endpoints

### Get all near duplicate articles
`POST https://zieapi.vercel.app/v1/open-data:core-ac-uk/near-duplicate-articles` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| doi | string | no | The DOI for which the duplicates will be identified |
| title | string | no | Title to match when looking for duplicate articles. Only useful when either value for @year or @description is supplied. |
| year | string | no | Year the article was published. Only useful when value for @title is supplied. |
| description | string | no | Abstract for an article based on which its duplicates will be found. Only useful when value for @title is supplied. |
| fulltext | string | no | Full text for an article based on which its duplicates will be found. |
| identifier | string | no | Article identifier for which the duplicates will be identified. Only useful when either values for @doi or (@title and @year) or (@title… |
| repositoryId | string | no | Limit the duplicates search to particular repository id. |

### Batch operation for retrieving articles by CORE ID
`POST https://zieapi.vercel.app/v1/open-data:core-ac-uk/get-article-by-core-id-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| metadata | boolean | no | Whether to retrieve the full article metadata or only the IDs. The default value is true |
| fulltext | boolean | no | Whether to retrieve fulltexts of the articles. The default value is false |
| citations | boolean | no | Whether to retrieve citations found in the articles. The default value is false |
| similar | boolean | no | Whether to retrieve lists of similar articles. The default value is false. Because the similar articles are calculated on demand, setting… |
| duplicate | boolean | no | Whether to retrieve CORE IDs of different versions of the articles. The default value is false |
| urls | boolean | no | Whether to retrieve lists of URLs of the article fulltexts. The default value is false |
| faithfulMetadata | boolean | no | Returns the records raw XML metadata from the original repository. The default value is false |
| body | object | yes | JSON request body |

### Get article by CORE ID
`GET https://zieapi.vercel.app/v1/open-data:core-ac-uk/get-article-by-core-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| coreId | integer | yes | CORE ID of the article that needs to be fetched. |
| metadata | boolean | no | Whether to retrieve the full article metadata or only the ID. The default value is true. |
| fulltext | boolean | no | Whether to retrieve full text of the article. The default value is false |
| citations | boolean | no | Whether to retrieve citations found in the article. The default value is false |
| similar | boolean | no | Whether to retrieve a list of similar articles. The default value is false. Because the similar articles are calculated on demand, setting… |
| duplicate | boolean | no | Whether to retrieve a list of CORE IDs of different versions of the article. The default value is false |
| urls | boolean | no | Whether to retrieve a list of URLs from which the article can be downloaded. This can include links to PDFs as well as HTML pages. The… |
| faithfulMetadata | boolean | no | Returns the records raw XML metadata from the original repository. The default value is false |

### Get fulltext PDF by CORE ID
`GET https://zieapi.vercel.app/v1/open-data:core-ac-uk/get-article-pdf-by-core-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| coreId | string | yes | ID of article history that needs to be fetched |

### Get article history by CORE ID
`GET https://zieapi.vercel.app/v1/open-data:core-ac-uk/get-article-history-by-core-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| coreId | string | yes | CORE ID of the article which history should be fetched |
| page | integer | no | Which page of the history results should be retrieved. Can be any number betwen 1 and 100, default is 1 (first page). |
| pageSize | integer | no | The number of results to return per page. Can be any number between 10 and 100, default is 10. |

### Batch operation for search through articles
`POST https://zieapi.vercel.app/v1/open-data:core-ac-uk/search-articles-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| metadata | boolean | no | Whether to retrieve the full article metadata or only the ID. The default value is true. |
| fulltext | boolean | no | Whether to retrieve full text of the article. The default value is false |
| citations | boolean | no | Whether to retrieve citations found in the article. The default value is false |
| similar | boolean | no | Whether to retrieve a list of similar articles. The default value is false. Because the similar articles are calculated on demand, setting… |
| duplicate | boolean | no | Whether to retrieve a list of CORE IDs of different versions of the article. The default value is false |
| urls | boolean | no | Whether to retrieve a list of URLs from which the article can be downloaded. This can include links to PDFs as well as HTML pages. The… |
| faithfulMetadata | boolean | no | Whether to retrieve the raw XML metadata of the article. The default value is false |
| body | object | yes | JSON request body |

### Search through all documents
`GET https://zieapi.vercel.app/v1/open-data:core-ac-uk/search-articles` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | integer | yes | The search query |
| page | integer | no | Which page of the search results should be retrieved. Can be any number betwen 1 and 100, default is 1 (first page). |
| pageSize | integer | no | The number of results to return per page. Can be any number between 10 and 100, default is 10. |
| metadata | boolean | no | Whether to retrieve the full article metadata or only the ID. The default value is true. |
| fulltext | boolean | no | Whether to retrieve full text of the article. The default value is false |
| citations | boolean | no | Whether to retrieve citations found in the article. The default value is false |
| similar | boolean | no | Whether to retrieve a list of similar articles. The default value is false. Because the similar articles are calculated on demand, setting… |
| duplicate | boolean | no | Whether to retrieve a list of CORE IDs of different versions of the article. The default value is false |
| urls | boolean | no | Whether to retrieve a list of URLs from which the article can be downloaded. This can include links to PDFs as well as HTML pages. The… |
| faithfulMetadata | boolean | no | Returns the records raw XML metadata from the original repository. The default value is false |

### Get articles by similarity to a text
`POST https://zieapi.vercel.app/v1/open-data:core-ac-uk/similar-articles` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | no | How many similar articles to retrieve at most. Can be any number betwen 1 and 100, default is 10 |
| metadata | boolean | no | Whether to retrieve the full article metadata or only the IDs of the similar articles. The default value is true |
| fulltext | boolean | no | Whether to retrieve fulltexts of the similar articles. The default value is false |
| citations | boolean | no | Whether to retrieve citations found in the articles. The default value is false |
| similar | boolean | no | Whether to retrieve lists of similar articles. The default value is false. Because the similar articles are calculated on demand, setting… |
| duplicate | boolean | no | Whether to retrieve CORE IDs of different versions of the articles. The default value is false |
| urls | boolean | no | Whether to retrieve lists of URLs of the article fulltexts. The default value is false |
| faithfulMetadata | boolean | no | Whether to retrieve the raw XML metadata of the articles. The default value is false |
| body | object | yes | JSON request body |

### Batch operation for retrieving journals by ISSN
`POST https://zieapi.vercel.app/v1/open-data:core-ac-uk/get-journal-by-issn-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Find journal by ISSN
`GET https://zieapi.vercel.app/v1/open-data:core-ac-uk/get-journal-by-issn` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| issn | string | yes | ISSN identifier of journal that needs to be fetched. |

### Batch operation for search through journals
`POST https://zieapi.vercel.app/v1/open-data:core-ac-uk/post-journals-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Search through journals
`GET https://zieapi.vercel.app/v1/open-data:core-ac-uk/get-journals-search-query` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | yes | Search query |
| page | integer | no | Which page of the search results should be retrieved. Can be any number betwen 1 and 100, default is 1 (first page). |
| pageSize | integer | no | The number of results to return per page. Can be any number between 10 and 100, default is 10. |

### Batch operation for retrieving repositories by CORE repository ID
`POST https://zieapi.vercel.app/v1/open-data:core-ac-uk/get-repository-by-id-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| stats | boolean | no | Whether to retrieve statistics about the repository. The default value is false |
| depositHistory | boolean | no | Returns deposit history over time |
| depositHistoryCumulative | boolean | no | Returns deposit history over time |
| body | object | yes | JSON request body |

### Get repository by CORE repository ID
`GET https://zieapi.vercel.app/v1/open-data:core-ac-uk/get-repository-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| repositoryId | integer | yes | CORE repository ID of the article that needs to be fetched. |
| stats | boolean | no | Whether to retrieve statistics about the repository. The default value is false |
| depositHistory | boolean | no | Returns deposit history over time |
| depositHistoryCumulative | boolean | no | Returns deposit history over time |

### Batch operation for searching through repositories
`POST https://zieapi.vercel.app/v1/open-data:core-ac-uk/post-repositories-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| stats | boolean | no | Whether to retrieve statistics about the repository. The default value is false |
| depositHistory | boolean | no | Returns deposit history over time |
| depositHistoryCumulative | boolean | no | Returns deposit history over time |
| body | object | yes | JSON request body |

### Search through all repositories
`GET https://zieapi.vercel.app/v1/open-data:core-ac-uk/get-repositories-search-query` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | yes | The search query |
| page | integer | no | Which page of the search results should be retrieved. Can be any number betwen 1 and 100, default is 1 (first page). |
| pageSize | integer | no | The number of results to return per page. Can be any number between 10 and 100, default is 10. |
| stats | boolean | no | Whether to retrieve statistics about the repository. The default value is false |
| depositHistory | boolean | no | Returns deposit history over time |
| depositHistoryCumulative | boolean | no | Returns deposit history over time |

### Batch operation for search through all resources
`POST https://zieapi.vercel.app/v1/open-data:core-ac-uk/post-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Search through all resources
`GET https://zieapi.vercel.app/v1/open-data:core-ac-uk/get-search-query` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | yes | The search query |
| page | integer | no | Which page of the search results should be retrieved. Can be any number betwen 1 and 100, default is 1 (first page). |
| pageSize | integer | no | The number of results to return per page. Can be any number between 10 and 100, default is 10. |

## Example
```
curl "https://zieapi.vercel.app/v1/open-data:core-ac-uk/near-duplicate-articles" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the CORE API v2 API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/open-data:core-ac-uk/near-duplicate-articles with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the CORE API v2 API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. CORE API v2 itself also needs your own key from core.ac.uk.

### Can AI agents use the CORE API v2 API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key open-data:core-ac-uk.

### What is the status of the CORE API v2 API?
Needs your own provider key (bring your own key)