ExpertFile Documentation
  • 👋Welcome!
  • Reference
    • API Reference
      • Authentication
      • Experts
        • Expert Directory/Search
        • Expert Profile
          • Accomplishments
          • Affiliations
          • Article
          • Availability
          • Biography
          • Categories
          • Course
          • Education
          • Event Appearances
          • Fees
          • Industries
          • Languages
          • Links
          • Media Appearances
          • Partnerships
          • Patents
          • Research Focus
          • Research Grants
          • Sample Talks
          • Social
          • Tagline
          • Tags
          • Testimonials
          • Topics
          • SEO/Meta Data
      • Staff
        • Staff Directories/Search
        • Staff Profiles
          • Biography
          • Categories
          • Education
          • Languages
          • Links
          • Tagline
          • Tags
      • Inquiries
        • Admission
        • Business
        • Donor
        • Event
        • Expert Witness
        • General
        • Media
        • Meeting
        • Partnership
        • Research
      • Posts (Spotlights)
        • Post Listings/Search
        • Full Post
      • Q&A (Answers)
        • Q&A Listings/Search
        • Individual Q&A
    • Embeds
      • Expert Directory/Search
      • Expert & Staff Profiles
        • Adding Profile Meta Data
      • Featured Experts
      • Inquiries
      • Post Listings/Search
      • Full Post
        • Adding Post Meta Data
      • Q&A Listings/Search
      • Individual Q&A
        • Adding Q&A Meta Data
      • Adding Meta Data to Embeds
    • WordPress
      • Expert Directory/Search
      • Expert & Staff Profiles
      • Featured Experts
      • Inquiries
      • Q&A Listings/Search
      • Individual Q&A
      • Post Listings/Search
      • Full Post
    • Tracking Code (Analytics)
    • Adding Meta Data for SEO
    • Helpers
Powered by GitBook
On this page
  • Get All Media Appearances
  • Get Individual Media Appearances
  • Create Media Appearances
  • Update Media Appearances
  • Delete Media Appearances

Was this helpful?

  1. Reference
  2. API Reference
  3. Experts
  4. Expert Profile

Media Appearances

CRUD endpoints for a user's media appearances

PreviousLinksNextPartnerships

Last updated 1 year ago

Was this helpful?

Please note that in all urls & code samples you'll need to replace:username and :corporation with appropriate values

Get All Media Appearances

GET

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <token>

Url

Name
Type
Description

corporation

number

Corporation ID

username

string

Unique username

Response

 {
  data: [
    {
    id: 1,
    title: 'Appearance Title',
    organization: 'Appearance Org.',
    type: 'online',
    url: 'Url',
    details: 'Appearance Details',
    date:'',
    cover_url: 'Uploaded Img url,
    large_cover_url: 'Uploaded Img url',
    cover_alt_title: 'Uploaded Img alt'
    },
  ],
  success: true
}

Code

const accessToken = `<ACCESS CODE>`

fetch('https://public-api.expertfile.com/v2/organization/:corporation/expert/:username/mediaappearance', {
    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 media = data;
        console.log('all media', media)
    }

})
.catch(error => console.error(error));
$accessToken = urlencode('<ACCESS TOKEN>');
$url = 'https://public-api.expertfile.com/v2/organization/:corporation/expert/:username/mediaappearance';

$ch = curl_init($url);
curl_setopt(
    $ch,
    CURLOPT_HTTPHEADER,
    array('Content-Type: application/x-www-form-urlencoded', 'Authorization: Bearer ' . $accessToken)
);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$json = json_decode($response);

if($json->success){
    var_dump($json->data);
}

curl_close($ch);
curl https://public-api.expertfile.com/v2/organization/:corporation/expert/:username/mediaappearance \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <ACCESS TOKEN>"

Get Individual Media Appearances

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <token>

Url

Name
Type
Description

corporation

number

Corporation ID

username

string

Unique username

id

number

Media Appearance ID

Response

{
  data: [
    {
    id: 1,
    title: 'Appearance Title',
    organization: 'Appearance Org.',
    type: 'online',
    url: 'Url',
    details: 'Appearance Details',
    date:'',
    cover_url: 'Uploaded Img url,
    large_cover_url: 'Uploaded Img url',
    cover_alt_title: 'Uploaded Img alt'
    },
  ],
  success: true
}

Code

const accessToken = `<ACCESS CODE>`

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

    if (success) {
        console.log('media', data)
    }

})
.catch(error => console.error(error));
$accessToken = urlencode('<ACCESS TOKEN>');
$url = 'https://public-api.expertfile.com/v2/organization/:corporation/expert/:username/mediaappearance/:id';

$ch = curl_init($url);
curl_setopt(
    $ch,
    CURLOPT_HTTPHEADER,
    array('Content-Type: application/x-www-form-urlencoded', 'Authorization: Bearer ' . $accessToken)
);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$json = json_decode($response);

if($json->success){
    var_dump($json->data);
}

curl_close($ch);
curl -X GET https://public-api.expertfile.com/v2/organization/:corporation/expert/:username/mediaappearance/:id \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <ACCESS TOKEN>"     

Create Media Appearances

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <token>

Url

Name
Type
Description

corporation

number

Corporation ID

username

string

Unique username

Body

Name
Type
Description

title*

string

Appearance Title

organization*

string

Appearance Organization

details*

string

Appearance Details

url

string

Appearance Url

date

unix timestamp

Appearance Date

type

string

Appearance Type(this can be one of 'print', 'online', 'tv', 'radio')

Response

{ 
    data: { 
        id: 1
    }, 
    success: true 
}

Code

const data = new URLSearchParams();
const accessToken = `<ACCESS TOKEN>`

data.append('title', 'My Appearance Title');
data.append('organization', 'My Appearance Name...');
data.append('details', 'My Appearance Details');
data.append('url', 'https://url.com')
data.append('type', 'online')
data.append('date', 1341892800);

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

    if (success) {
        const { id } = data
        console.log('New media id', id)
    }

})
.catch(error => console.error(error));
$accessToken = urlencode('<ACCESS TOKEN>');

$url = 'https://public-api.expertfile.com/v2/organization/:corporation/expert/:username/mediaappearance';
$data = ['title' => 'My Appearance Title', 'organization' => 'My Appearance Name...', 'details' => 'My Appearance Details', 'url' => 'https://location.com', 'type' => 'online', 'date' => 1341892800];

$ch = curl_init($url);
curl_setopt(
    $ch,
    CURLOPT_HTTPHEADER,
    array('Content-Type: application/x-www-form-urlencoded', 'Authorization: Bearer ' . $accessToken)
);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));

$response = curl_exec($ch);
$json = json_decode($response);

if($json->success){
    var_dump($json->data);
}

curl_close($ch);
curl -X POST https://public-api.expertfile.com/v2/organization/:corporation/expert/:username/mediaappearance \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <ACCESS TOKEN>" \
    -d '{"title":"My Appearance Title", "organization":"My Appearance Name...", "details":"My Appearance Details", "url": "https://location.com", "type":online", "date":  1341892800}'

Update Media Appearances

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <token>

Url

Name
Type
Description

corporation

number

Corporation ID

username

string

Unique username

id

number

Appearance ID

Body

Name
Type
Description

title*

string

Appearance Title

organization*

string

Appearance Organization

details*

string

Appearance Details

url

string

Appearance Url

date

unix timestamp

Appearance Date

type

string

Appearance Type(this can be one of 'print', 'online', 'tv', 'radio')

Response

{ 
    data: { 
        id: 1, 
        updated: true 
    }, 
    success: true 
}

Code

const data = new URLSearchParams();
const accessToken = `<ACCESS TOKEN>`

data.append('title', 'My Appearance Title');
data.append('organization', 'My Appearance Name...');
data.append('details', 'My Appearance Details');
data.append('url', 'https://url.com')
data.append('type', 'online')
data.append('date', 1341892800);

fetch('https://public-api.expertfile.com/v2/organization/:corporation/expert/:username/mediaappearance/:id', {
    method: 'PUT',
    headers: {
        'Content-Type': 'application/x-www-form-urlencoded',
        'Authorization': `Bearer ${accessToken}`
    },
    body: data
})
.then(response => response.json())
.then(json => {
    const { success, data, error } = json

    if (success) {
        const { id } = data
        console.log('New media id', id)
    }

})
.catch(error => console.error(error));
$accessToken = urlencode('<ACCESS TOKEN>');

$url = 'https://public-api.expertfile.com/v2/organization/:corporation/expert/:username/eventappearance/:id';
$data = ['title' => 'My Appearance Title', 'organization' => 'My Appearance Name...', 'details' => 'My Appearance Details', 'url' => 'https://location.com', 'type' => 'online', 'date' => 1341892800];

$ch = curl_init($url);
curl_setopt(
    $ch,
    CURLOPT_HTTPHEADER,
    array('Content-Type: application/x-www-form-urlencoded', 'Authorization: Bearer ' . $accessToken)
);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_PUT, http_build_query($data));

$response = curl_exec($ch);
$json = json_decode($response);

if($json->success){
    var_dump($json->data);
}

curl_close($ch);
curl -X PUT https://public-api.expertfile.com/v2/organization/:corporation/expert/:username/mediaappearance/:id \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <ACCESS TOKEN>" \
    -d '{"title":"My Appearance Title", "organization":"My Appearance Name...", "details":"My Appearance Details", "url": "https://location.com", "type":online", "date":  1341892800}'

Delete Media Appearances

Headers

Name
Value

Content-Type

application/json

Authorization

Bearer <token>

Url

Name
Type
Description

corporation

number

Corporation ID

username

string

Unique username

id

number

Appearance ID

Response

{ 
    data: { 
        deleted: true, 
        id: 1 
    }, 
    success: true 
}

Code

const accessToken = `<ACCESS TOKEN>`

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

    if (success) {
        const { id } = data
        console.log('Deleted media id', id)
    }

})
.catch(error => console.error(error));
$accessToken = urlencode('<ACCESS TOKEN>');

$url = 'https://public-api.expertfile.com/v2/organization/:corporation/expert/:username/mediaappearance/:id';

$ch = curl_init($url);
curl_setopt(
    $ch,
    CURLOPT_HTTPHEADER,
    array('Content-Type: application/x-www-form-urlencoded', 'Authorization: Bearer ' . $accessToken)
);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");

$response = curl_exec($ch);
$json = json_decode($response);

if($json->success){
    var_dump($json->data);
}

curl_close($ch);
curl -X DELETE https://public-api.expertfile.com/v2/organization/:corporation/expert/:username/mediaappearance/:id \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <ACCESS TOKEN>"

GET

POST

PUT

DELETE

/v2/organization/:corporation/expert/:username/mediaappearance
/v2/organization/:corporation/expert/:username/mediaappearance/:id
/v2/organization/:corporation/expert/:username/mediaappearance
/v2/organization/:corporation/expert/:username/mediaappearance/:id
/v2/organization/:corporation/expert/:username/mediaappearance/:id