Post Listings/Search

Remember to change :corporation with your corporation id(found in the integrations section of the dashboard).

Listing Posts

GET /v2/spotlight/:corporation/search

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Url

Name	Type	Description
corporation	number	Corporation ID
username	string	Unique username
q	string	Keyword search term
month	string	Published month
year	string	Published year
page_size	number	Size of page
page_from	number	Starting point
tagged	string	Filter by tagged experts(array of usernames(i.e. ["expert1","expert1"]))
tags	string	Filter by tags. Array of tags(i.e. ["tag1","tag2"])

Response

200

{
  data: {
    spotlights: [],
    aggregations: {
      year: [],
      tagged_experts: [],
      tags: []
    },
    total: 10
  },
  success: true
}  

Code

Node

const accessToken = `<ACCESS TOKEN>`

fetch('https://public-api.expertfile.com/v2/spotlight/:corporation/search', {
    method: 'GET',
    headers: {
        'Content-Type': 'application/x-www-form-urlencoded',
        'Authorization': `Bearer ${accessToken}`
    }
})
.then(response => response.json())
.then(json => {
    const { success, data } = json

    if (success) {
        const { spotlights, aggregations } = data;
        console.log('Posts', spotlights);
        console.log('Filters', aggregations);
    }

})
.catch(error => console.error(error));

PHP

Curl

Applying Tagged Filter to Posts

GET /v2/organization/:corporation/expert

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Url

Name	Type	Description
corporation	number	Corporation ID
categories	string	Filter by categories. Array of categories(i.e. ["cat1","cat2"])

Response

200

{
  data: {
    spotlights: [],
    aggregations: {
      year: [],
      tagged_experts: [],
      tags: []
    },
    total: 10
  },
  success: true
} 

Code

Node

const accessToken = `<ACCESS TOKEN>`

const params = {
    tagged: JSON.stringify(['<USERNAME1>', '<USERNAME2>'])
};

const qs = new URLSearchParams(params).toString()

const path = `https://public-api.expertfile.com/v2/spotlight/:corporation/search${qs ? '?' + qs : ''}`
fetch(path, {
    method: 'GET',
    headers: {
        'Content-Type': 'application/x-www-form-urlencoded',
        'Authorization': `Bearer ${accessToken}`
    }
})
.then(response => response.json())
.then(json => {
    const { success, data } = json

    if (success) {
        const { spotlights:, aggregations } = data;
        console.log('Posts', spotlights:);
        console.log('Filters', aggregations);
    }

})
.catch(error => console.error(error));

PHP

Curl